QnA Maker
Distillare le informazioni in domande frequenti facili da esplorare.
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Servizio | Class | Regions |
|---|---|---|
| Copilot Studio | Normale | Tutte le aree di Power Automate , ad eccezione delle seguenti: - China Cloud gestito da 21Vianet |
| App per la logica | Normale | Tutte le aree di App per la logica , ad eccezione delle seguenti: - Aree di Azure Cina |
| Power Apps | Normale | Tutte le aree di Power Apps , ad eccezione dei seguenti: - China Cloud gestito da 21Vianet |
| Power Automate | Normale | Tutte le aree di Power Automate , ad eccezione delle seguenti: - China Cloud gestito da 21Vianet |
| Contatto | |
|---|---|
| Nome | Microsoft |
| URL |
Supporto di Microsoft LogicApps Supporto di Microsoft Power Automate Supporto di Microsoft Power Apps |
| Metadati del connettore | |
|---|---|
| Editore | Microsoft |
| Sito web | https://www.qnamaker.ai/ |
Problemi noti e limitazioni
Il connettore QnA Maker supporta solo la versione di QnA Maker 4.0 dell'API.
Creazione di una connessione
Il connettore supporta i tipi di autenticazione seguenti:
| Chiave API | ApiKey | Tutte le aree geografiche | Condivisibile |
| Impostazione predefinita [DEPRECATO] | Questa opzione è solo per le connessioni meno recenti senza un tipo di autenticazione esplicito e viene fornita solo per la compatibilità con le versioni precedenti. | Tutte le aree geografiche | Non condivisibile |
Chiave API
ID autenticazione: keyBasedAuth
Applicabile: tutte le aree
ApiKey
Si tratta di una connessione condivisibile. Se l'app per l'alimentazione viene condivisa con un altro utente, anche la connessione viene condivisa. Per altre informazioni, vedere Panoramica dei connettori per le app canvas - Power Apps | Microsoft Docs
| Nome | TIPO | Description | Obbligatorio |
|---|---|---|---|
| Chiave dell'account | securestring | Chiave dell'account di Servizi cognitivi | Vero |
| URL sito | corda | URL sito radice (esempio: https://westus.api.cognitive.microsoft.com) |
Impostazione predefinita [DEPRECATO]
Applicabile: tutte le aree
Questa opzione è solo per le connessioni meno recenti senza un tipo di autenticazione esplicito e viene fornita solo per la compatibilità con le versioni precedenti.
Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.
| Nome | TIPO | Description | Obbligatorio |
|---|---|---|---|
| Chiave API | securestring | Chiave API | Vero |
| URL sito | corda | URL del sito radice. Se non specificato, l'URL del sito verrà impostato su https://westus.api.cognitive.microsoft.com. |
Limiti per la limitazione delle richieste
| Nome | Chiamate | Periodo di rinnovo |
|---|---|---|
| Chiamate API per connessione | 1200 | 60 secondi |
Azioni
| Generare una risposta |
Questa operazione restituisce la risposta di rango superiore per la domanda specificata. |
| Generare una risposta [DEPRECATO] |
Questa operazione restituisce la risposta di rango superiore per la domanda specificata. |
| Scaricare i dettagli della knowledge base |
Ottiene i dettagli di una knowledge base specifica. |
| Scaricare i dettagli della knowledge base (V2) |
Ottiene i dettagli di una knowledge base specifica. |
| Scaricare la Knowledge Base [DEPRECATO] |
Questa operazione scarica tutti i dati associati alla Knowledge Base specificata. |
Generare una risposta
Questa operazione restituisce la risposta di rango superiore per la domanda specificata.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Knowledge Base Id
|
KnowledgeBaseId | True | string |
Deve essere recuperato dal portale di QnAMaker. |
|
Host del servizio
|
ServiceHost | True | string |
Deve essere recuperato dal portale di QnAMaker. |
|
Chiave endpoint
|
EndpointKey | True | string |
Deve essere recuperato dal portale di QnAMaker. |
|
Domanda
|
question | True | string |
Porre una domanda. |
|
In alto
|
top | integer |
Numero di risultati classificati desiderati nell'output. |
Restituisce
- Corpo
- GenerateAnswer_Response
Generare una risposta [DEPRECATO]
Questa operazione restituisce la risposta di rango superiore per la domanda specificata.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Knowledge Base Id
|
KnowledgeBaseId | True | string |
Deve essere recuperato dal portale di QnAMaker. |
|
Domanda
|
question | True | string |
Porre una domanda. |
|
In alto
|
top | integer |
Numero di risultati classificati desiderati nell'output. |
Restituisce
- Corpo
- GenerateAnswer_Response
Scaricare i dettagli della knowledge base
Ottiene i dettagli di una knowledge base specifica.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Knowledge Base Id
|
KnowledgeBaseId | True | string |
Deve essere recuperato dal portale di QnAMaker. |
Restituisce
Schema di risposta per l'operazione CreateKb.
Scaricare i dettagli della knowledge base (V2)
Ottiene i dettagli di una knowledge base specifica.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Sottodominio o area della risorsa
|
subdomainName | True | string |
Sottodominio o area geografica di Azure (ad esempio westus) |
|
Knowledge Base Id
|
KnowledgeBaseId | True | string |
Deve essere recuperato dal portale di QnAMaker. |
Restituisce
Schema di risposta per l'operazione CreateKb.
Scaricare la Knowledge Base [DEPRECATO]
Questa operazione scarica tutti i dati associati alla Knowledge Base specificata.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Knowledge Base Id
|
KnowledgeBaseId | True | string |
Deve essere recuperato dal portale di QnAMaker. |
Restituisce
Schema di risposta per l'operazione CreateKb.
Definizioni
GenerateAnswer_Response
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Answers
|
answers | array of object |
Elenco di tutte le risposte. |
|
Risposta
|
answers.answer | string |
Risposta di rango superiore alla domanda. |
|
Punteggio
|
answers.score | float |
Punteggio relativo della risposta. |
|
id
|
answers.id | number | |
|
Fonte
|
answers.source | string |
DownloadKnowledgeBase_Response
Schema di risposta per l'operazione CreateKb.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
id
|
id | string |
ID univoco che identifica una knowledge base. |
|
hostName
|
hostName | string |
Nome host URL in cui è ospitata la knowledgebase. |
|
lastAccessedTimestamp
|
lastAccessedTimestamp | string |
Timestamp in corrispondenza del quale è stato eseguito l'ultimo accesso alla knowledge base (UTC). |
|
lastChangedTimestamp
|
lastChangedTimestamp | string |
Timestamp in corrispondenza del quale la KnowledgeBase è stata modificata per l'ultima volta (UTC). |
|
lastPublishedTimestamp
|
lastPublishedTimestamp | string |
Timestamp in corrispondenza del quale la knowledgebase è stata pubblicata l'ultima volta (UTC). |
|
nome
|
name | string |
Nome descrittivo della knowledge base. |
|
userId
|
userId | string |
Utente che ha creato/possiede la knowledge base. |
|
urls
|
urls | array of string |
Origini URL da cui sono state estratte e aggiunte alla knowledge base. |
|
Fonti
|
sources | array of string |
Origini personalizzate da cui Q-A sono state estratte o aggiunte in modo esplicito alla knowledge base. |