Udostępnij przez

QnA Maker

Destylowanie informacji do łatwych w nawigacji — często zadawane pytania.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Standard Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - China Cloud obsługiwane przez firmę 21Vianet
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure (Chiny)
Power Apps Standard Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - China Cloud obsługiwane przez firmę 21Vianet
Power Automate Standard Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - China Cloud obsługiwane przez firmę 21Vianet
Kontakt
Name Microsoft
adres URL Obsługa usługi Microsoft LogicApps
Pomoc techniczna usługi Microsoft Power Automate
Obsługa usługi Microsoft Power Apps
Metadane łącznika
Publisher Microsoft
Witryna internetowa https://www.qnamaker.ai/

Znane problemy i ograniczenia

Łącznik usługi QnA Maker obsługuje tylko wersję interfejsu API QnA Maker 4.0.

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:
Klucz interfejsu API ApiKey Wszystkie regiony Udostępnialne
Domyślne [PRZESTARZAŁE] Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami. Wszystkie regiony Nie można udostępniać

Klucz interfejsu API

Identyfikator uwierzytelniania: keyBasedAuth

Dotyczy: Wszystkie regiony

ApiKey

Jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power jest udostępniana innemu użytkownikowi, połączenie jest również udostępniane. Aby uzyskać więcej informacji, zobacz Omówienie łączników dla aplikacji kanwy — Power Apps | Microsoft Docs

Name Typ Description Wymagane
Klucz konta securestring Klucz konta usług Cognitive Services Prawda
Adres URL witryny ciąg Adres URL witryny głównej (przykład: https://westus.api.cognitive.microsoft.com)

Domyślne [PRZESTARZAŁE]

Dotyczy: Wszystkie regiony

Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja Power App zostanie udostępniona innemu użytkownikowi, inny użytkownik zostanie poproszony o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
Klucz interfejsu API securestring Klucz interfejsu API Prawda
Adres URL witryny ciąg Adres URL witryny głównej. Jeśli nie zostanie określony, adres URL witryny będzie domyślnie ustawiona na https://westus.api.cognitive.microsoft.com.

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 1200 60 sekund

Akcje

Generowanie odpowiedzi

Ta operacja zwraca odpowiedź najwyższego rankingu dla danego pytania.
Generowanie odpowiedzi [PRZESTARZAŁE]

Ta operacja zwraca odpowiedź najwyższego rankingu dla danego pytania.
Pobieranie bazy wiedzy [PRZESTARZAŁE]

Ta operacja pobiera wszystkie dane skojarzone z określoną bazą wiedzy.
Pobieranie szczegółów bazy wiedzy

Pobiera szczegółowe informacje o określonej bazie wiedzy.
Pobieranie szczegółów bazy wiedzy (wersja 2)

Pobiera szczegółowe informacje o określonej bazie wiedzy.

Generowanie odpowiedzi

Identyfikator operacji:
GenerateAnswer

Ta operacja zwraca odpowiedź najwyższego rankingu dla danego pytania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator bazy wiedzy
 KnowledgeBaseId True string

Powinno to zostać pobrane z portalu usługi QnAMaker.
Host usługi
 ServiceHost True string

Powinno to zostać pobrane z portalu usługi QnAMaker.
Klucz punktu końcowego
 EndpointKey True string

Powinno to zostać pobrane z portalu usługi QnAMaker.
Question
 question True string

Zadaj pytanie.
Do góry
 top integer

Liczba sklasyfikowanych wyników w danych wyjściowych.

Zwraca

Body
GenerateAnswer_Response

Generowanie odpowiedzi [PRZESTARZAŁE]

Identyfikator operacji:
GenerateAnswerOld

Ta operacja zwraca odpowiedź najwyższego rankingu dla danego pytania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator bazy wiedzy
 KnowledgeBaseId True string

Powinno to zostać pobrane z portalu usługi QnAMaker.
Question
 question True string

Zadaj pytanie.
Do góry
 top integer

Liczba sklasyfikowanych wyników w danych wyjściowych.

Zwraca

Body
GenerateAnswer_Response

Pobieranie bazy wiedzy [PRZESTARZAŁE]

Identyfikator operacji:
DownloadKnowledgeBase

Ta operacja pobiera wszystkie dane skojarzone z określoną bazą wiedzy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator bazy wiedzy
 KnowledgeBaseId True string

Powinno to zostać pobrane z portalu usługi QnAMaker.

Zwraca

Schemat odpowiedzi dla operacji CreateKb.

Body
DownloadKnowledgeBase_Response

Pobieranie szczegółów bazy wiedzy

Identyfikator operacji:
DownloadKnowledgeBaseOld

Pobiera szczegółowe informacje o określonej bazie wiedzy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator bazy wiedzy
 KnowledgeBaseId True string

Powinno to zostać pobrane z portalu usługi QnAMaker.

Zwraca

Schemat odpowiedzi dla operacji CreateKb.

Body
DownloadKnowledgeBase_Response

Pobieranie szczegółów bazy wiedzy (wersja 2)

Identyfikator operacji:
DownloadKnowledgeBaseOldV2

Pobiera szczegółowe informacje o określonej bazie wiedzy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Poddomena zasobów lub region
 subdomainName True string

Poddomena platformy Azure lub region geograficzny (np. westus)
Identyfikator bazy wiedzy
 KnowledgeBaseId True string

Powinno to zostać pobrane z portalu usługi QnAMaker.

Zwraca

Schemat odpowiedzi dla operacji CreateKb.

Body
DownloadKnowledgeBase_Response

Definicje

GenerateAnswer_Response

Nazwa Ścieżka Typ Opis
Odpowiedzi
 answers array of object

Lista wszystkich odpowiedzi.
Odpowiedź
 answers.answer string

Najwięcej odpowiedzi na pytanie należy znaleźć w rankingu.
Score
 answers.score float

Względny wynik odpowiedzi.
Id
 answers.id number
Źródło
 answers.source string

DownloadKnowledgeBase_Response

Schemat odpowiedzi dla operacji CreateKb.

Nazwa Ścieżka Typ Opis
id
 id string

Unikatowy identyfikator identyfikujący bazę wiedzy.
hostName
 hostName string

Nazwa hosta adresu URL, w którym jest hostowana baza wiedzy.
lastAccessedTimestamp
 lastAccessedTimestamp string

Sygnatura czasowa, w której ostatnio uzyskiwano dostęp do bazy wiedzy (UTC).
lastChangedTimestamp
 lastChangedTimestamp string

Sygnatura czasowa, w której baza wiedzy została ostatnio zmodyfikowana (UTC).
lastPublishedTimestamp
 lastPublishedTimestamp string

Sygnatura czasowa, o której baza wiedzy została ostatnio opublikowana (UTC).
nazwa
 name string

Przyjazna nazwa bazy wiedzy.
userId
 userId string

Użytkownik, który utworzył/jest właścicielem bazy wiedzy.
adresy URL
 urls array of string

Źródła adresów URL, z których zostały wyodrębnione i dodane do bazy wiedzy.
Źródeł
 sources array of string

Źródła niestandardowe, z których zostały wyodrębnione lub jawnie dodane do bazy wiedzy.