Jazyk – odpovídání na otázky
Rozhraní API pro odpovědi na otázky je cloudová služba, která poskytuje pokročilé zpracování přirozeného jazyka se špičkovými modely transformátoru, které generují odpovědi na vlastní projekty odpovědí na otázky nebo nezpracovaný text. Odpověď na otázky je funkce ve službě Language, která je vylepšená ze služby QnA Maker o další funkce, jako je podpora nestrukturovaných dokumentů a přesné odpovědi.
Tento konektor je dostupný v následujících produktech a oblastech:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Všechny oblasti Power Automate s výjimkou následujících: - China Cloud provozovaný společností 21Vianet |
| Logic Apps | Standard | Všechny oblasti Logic Apps s výjimkou následujících: – Oblasti Azure China |
| Power Apps | Premium | Všechny oblasti Power Apps s výjimkou následujících: - China Cloud provozovaný společností 21Vianet |
| Power Automate | Premium | Všechny oblasti Power Automate s výjimkou následujících: - China Cloud provozovaný společností 21Vianet |
| Kontakt | |
|---|---|
| Název | Podpora pro odpovědi na otázky |
| URL | https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/overview |
| qnamakersupport@microsoft.com |
| Metadata konektoru | |
|---|---|
| Vydavatel | Microsot |
| Internetová stránka | https://azure.microsoft.com/en-us/services/cognitive-services/question-answering/#overview |
| Zásady ochrany osobních údajů | https://privacy.microsoft.com/en-us/privacystatement |
| Kategorie | Umělá inteligence; Internetová stránka |
Jazyk – Konektor pro odpovědi na otázky je konektor pro integraci jakékoli aplikace Power app s naší novou funkcí pro odpovědi na otázky v rámci služby Language. Díky tomuto konektoru se teď uživatelé můžou připojit k novým i vylepšeným funkcím odpovědi na otázky. V tomto konektoru jsou akce, které uživatelům pomůžou
- Generování odpovědí z projektu
- Získání metadat projektu
- Vygenerujte odpovědi z poskytnutého textu za určité časové období, plánujeme zavést další akce, abychom našim zákazníkům poskytli více funkcí.
Požadavky
Postupujte podle zde uvedených pokynů a vytvořte vlastní projekt pro odpovědi na otázky.
Jak získat přihlašovací údaje
- Po nasazení projektu klikněte na Získat adresu URL předpovědi.
- Získejte adresu URL webu z názvu hostitele adresy URL predikce a klíče účtu, což by byl klíč Ocp-Apim-Subscription-Key.
Adresa - Vytvořte připojení pomocí klíče účtu a adresy URL webu.
Začínáme s konektorem
Použití konektoru v toku
- Přejděte do Microsoft Power Automate a klikněte na Vytvořit a vyberte Okamžitý tok cloudu.
- Pro testování tohoto konektoru můžete kliknout na Ručně aktivovat tok a kliknout na
Create.
- Klikněte na Nový krok a vyhledejte jazyk – odpověď na otázky a vyberte si ze tří akcí.
Akce:
Vygenerovat odpověď z projectu
- Tato akce pomáhá při odpovídání na zadanou otázku pomocí znalostní báze ve vašem projektu.
- Tento dotaz můžete poskytnout pro generování odpovědí z projektu
. - Další informace o textu požadavku najdete tady: Odpověď na otázky – Získání odpovědí – REST API (Azure Cognitive Services) | Microsoft Docs
Získání metadat projektu
- Tato akce pomáhá získat všechna metadata projektu.
- Pojmenujte projekt, abyste získali metadata projektu.
Vygenerování odpovědi z zadaného textu
- Tato akce pomáhá při odpovídání na zadanou otázku pomocí zadaného textu. Pokud chcete použít pouze tuto akci, nemusí být u prostředku jazyka povolena vlastní odpověď na otázky.
- Tato akce nevyžaduje vlastní projekt pro odpovědi na otázky. Potřebuje pouze prostředek jazyka. Prostředek jazyka můžete vytvořit a z webu Azure Portal zkopírovat koncový bod a klíč v části Klíče a koncový bod na adresu URL webu a klíč účtu.
- Dotaz " jak dlouho trvá nabíjení povrchu? " v následujícím textu: " Napájení a nabíjení. Nabíjení baterie Surface Pro 4 z prázdného stavu trvá dvě až čtyři hodiny. Pokud zařízení Surface používáte pro aktivity náročné na výkon, jako je streamování her nebo videa při nabíjení, může to trvat déle. "
- Další informace o textu požadavku najdete tady: Odpověď na otázky – Získání odpovědí z textu – REST API (Azure Cognitive Services) | Microsoft Docs
Odezva
Vygenerovat odpověď z projectu
Vrátí odpověď z ukázkového projektu pro otázku "Přístupnost". Další informace o objektu odpovědi pro tuto akci najdete v tématu Odpovědi na otázky – Získání odpovědí – REST API (Azure Cognitive Services) | Microsoft Docs
Vygenerovat odpověď z zadaného textu
Z daného textu extrahuje odpověď na vaši otázku. Další informace o objektu odpovědi najdete v tématu Odpovědi na otázky – Získání odpovědí z textu – REST API (Azure Cognitive Services) | Microsoft Docs .
Získání metadat projektu
Získá metadata požadovaného projektu. Další informace o objektu odpovědi najdete v tématu Projekty odpovědi na otázky – Získání podrobností projektu – ROZHRANÍ REST API (Azure Cognitive Services) | Microsoft Docs .
Známé problémy a omezení
Nenašli jsme žádnou, obraťte se prosím na nás, pokud najdete qnamakersupport@microsoft.com
Běžné chyby a nápravné prostředky
Projděte si tuto dokumentaci: https://docs.microsoft.com/en-us/rest/api/cognitiveservices/questionanswering/question-answering
časté otázky
Projděte si tuto dokumentaci: https://docs.microsoft.com/en-us/azure/cognitive-services/language-service/question-answering/overview
Vytvoření připojení
Konektor podporuje následující typy ověřování:
| Klíč rozhraní API | Klíč API | Všechny oblasti | Sdíletelný |
| Integrovaná služba Azure AD | Pro přístup ke službě Azure Blob Storage použijte Azure Active Directory. | Všechny oblasti | Nesdílitelné |
| Výchozí [ZASTARALÉ] | Tato možnost je určená pouze pro starší připojení bez explicitního typu ověřování a poskytuje se pouze pro zpětnou kompatibilitu. | Všechny oblasti | Nesdílitelné |
Klíč rozhraní API
ID ověřování: keyBasedAuth
Použitelné: Všechny oblasti
Klíč API
Toto připojení je možné sdílet. Pokud se power app sdílí s jiným uživatelem, sdílí se i připojení. Další informace najdete v přehledu konektorů pro aplikace plátna – Power Apps | Microsoft Docs
| Název | Typ | Description | Povinné |
|---|---|---|---|
| Klíč účtu | securestring | Klíč koncového bodu pro váš prostředek jazyka, který se má zkopírovat z webu Azure Portal | Pravdivé |
| Adresa URL webu | řetězec | Název hostitele vašeho prostředku jazyka, který se má zkopírovat z webu Azure Portal | Pravdivé |
Integrovaná služba Azure AD
ID ověřování: tokenBasedAuth
Použitelné: Všechny oblasti
Pro přístup ke službě Azure Blob Storage použijte Azure Active Directory.
Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.
| Název | Typ | Description | Povinné |
|---|---|---|---|
| Adresa URL webu | řetězec | Název hostitele vašeho prostředku jazyka, který se má zkopírovat z webu Azure Portal | Pravdivé |
Výchozí [ZASTARALÉ]
Použitelné: Všechny oblasti
Tato možnost je určená pouze pro starší připojení bez explicitního typu ověřování a poskytuje se pouze pro zpětnou kompatibilitu.
Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.
| Název | Typ | Description | Povinné |
|---|---|---|---|
| Klíč účtu | securestring | Klíč koncového bodu pro váš prostředek jazyka, který se má zkopírovat z webu Azure Portal | Pravdivé |
| Adresa URL webu | řetězec | Název hostitele vašeho prostředku jazyka, který se má zkopírovat z webu Azure Portal | Pravdivé |
Limity omezování
| Name | Volání | Období obnovení |
|---|---|---|
| Volání rozhraní API na připojení | 100 | 60 sekund |
Akce
| Vygenerování odpovědi z Projectu |
Tato akce pomáhá při odpovídání na zadanou otázku pomocí znalostní báze ve vašem projektu. |
| Vygenerování odpovědi z zadaného textu |
Tato akce pomáhá při odpovídání na zadanou otázku pomocí zadaného textu. |
| Získání metadat projektu |
Tato akce pomáhá získat všechna metadata projektu. |
Vygenerování odpovědi z Projectu
Tato akce pomáhá při odpovídání na zadanou otázku pomocí znalostní báze ve vašem projektu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Název projektu
|
projectName | True | string |
Toto je název projektu, který chcete použít. |
|
Question
|
question | True | string |
Dotaz uživatele, který se má dotazovat na projekt |
|
ID uživatele
|
userId | string |
Jedinečný identifikátor uživatele. |
|
|
Vrchol #
|
top | integer |
Maximální početodpovědích |
|
|
Prahová hodnota spolehlivosti
|
confidenceScoreThreshold | float |
Minimální skóre prahové hodnoty pro odpovědi Rozsahy hodnot od 0 do 1. |
|
|
Typ rankeru
|
rankerType | string |
Typ rankeru, který se má použít. |
|
|
QnA ID
|
qnaId | string |
Toto je přesné ID QnA, které se má načíst z projektu. |
|
|
Předchozí ID QnA
|
previousQnaId | integer |
Id QnA s nejvyšším výsledkem odpovědi na předchozí turné |
|
|
Předchozí dotaz uživatele
|
previousUserQuery | string |
Předchozí dotaz uživatele. |
|
|
klíč
|
key | string |
Klíč metadat ze slovníku metadat používaných v QnA. |
|
|
value
|
value | string |
Hodnota metadat ze slovníku metadat použitých v QnA. |
|
|
Spojení metadat s využitím
|
logicalOperation | string |
Pro odpovídající logickou operaci pro filtry metadat nastavte or nebo AND. |
|
|
Filtr zdroje
|
sourceFilter | string |
Vyhledejte otázky QnA, které jsou přidružené k libovolnému z daného seznamu zdrojů v projektu. |
|
|
Spojení filtrů s využitím
|
logicalOperation | string |
Logická operace používaná ke spojení filtru metadat se zdrojovým filtrem. |
|
|
Povolit přesnou odpověď
|
enable | boolean |
Povolte nebo zakažte predikci rozsahu odpovědí. |
|
|
Prahová hodnota spolehlivosti
|
confidenceScoreThreshold | float |
Minimální prahové skóre potřebné k zahrnutí přesné odpovědi, rozsah hodnot od 0 do 1. |
|
|
Vrchol #
|
topAnswersWithSpan | integer |
Počet nejčastějších odpovědí, které se mají považovat za přesné předpovědi odpovědí od 1 do 10 |
|
|
Zahrnout nestrukturované zdroje
|
includeUnstructuredSources | boolean |
Příznak pro povolení dotazu nad nestrukturovanými zdroji |
|
|
Název nasazení
|
deploymentName | True | string |
Toto je konkrétní nasazení projektu, který chcete použít. |
|
Verze rozhraní API
|
api-version | True | string |
Toto je verze klientského rozhraní API. |
Návraty
Představuje seznam odpovědí na otázky.
- Body
- AnswersResult
Vygenerování odpovědi z zadaného textu
Tato akce pomáhá při odpovídání na zadanou otázku pomocí zadaného textu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Question
|
question | True | string |
Dotaz uživatele, který se má dotazovat na dané textové záznamy. |
|
identifikační číslo
|
id | True | string |
Jedinečný identifikátor textového záznamu |
|
poslat SMS
|
text | True | string |
Textový obsah záznamu |
|
Jazyk
|
language | string |
Jazyk textových záznamů Toto je reprezentace jazyka BCP-47. |
|
|
Typ indexu řetězce
|
stringIndexType | string |
Určuje metodu použitou k interpretaci posunů řetězců. Ve výchozím nastavení se nastaví textové prvky (grafy) podle unicode v8.0.0. Další informace najdete v tématu https://aka.ms/text-analytics-offsets. |
|
|
Verze rozhraní API
|
api-version | True | string |
Toto je verze klientského rozhraní API. |
Návraty
Představuje výsledky odpovědí.
Získání metadat projektu
Tato akce pomáhá získat všechna metadata projektu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Název projektu
|
ProjectNamePathParameter | True | string |
Název projektu, který se má použít. |
|
Verze rozhraní API
|
api-version | True | string |
Toto je verze klientského rozhraní API. |
Návraty
Představuje projekt.
- Body
- ProjectMetadata
Definice
ProjectMetadata
Představuje projekt.
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
projectName
|
projectName | string |
Název projektu. |
|
popis
|
description | string |
Popis projektu |
|
Jazyk
|
language | Language |
Jazyk textových záznamů Toto je reprezentace jazyka BCP-47. |
|
defaultAnswer
|
settings.defaultAnswer | string |
Výchozí odpověď odpovědi, pokud se ve znalostní bázi nenajde žádná dobrá shoda. |
|
multilingualResource
|
multilingualResource | boolean |
Zdroj povolený pro více jazyků napříč projekty nebo ne. |
|
vytvořenoDatumČas
|
createdDateTime | date-time |
Datum a čas vytvoření projektu |
|
lastModifiedDateTime
|
lastModifiedDateTime | date-time |
Představuje projekt datum a čas poslední změny. |
|
lastDeployedDateTime
|
lastDeployedDateTime | date-time |
Představuje datum a čas posledního nasazení projektu. |
Jazyk
Jazyk textových záznamů Toto je reprezentace jazyka BCP-47.
Jazyk textových záznamů Toto je reprezentace jazyka BCP-47.
- Jazyk
- string
AnswersResult
Představuje seznam odpovědí na otázky.
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
odpovědi
|
answers | array of KnowledgeBaseAnswer |
Představuje seznam výsledků odpovědi. |
|
isUserQuestionAmbiguous
|
isUserQuestionAmbiguous | boolean |
Vrátí logickou hodnotu, pokud byla otázka uživatele nejednoznačná. |
KnowledgeBaseAnswer
Představuje odpověď projektu.
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
otázky
|
questions | array of string |
Seznam otázek spojených s odpovědí |
|
odpověď
|
answer | string |
Text odpovědi |
|
Prahová hodnota spolehlivosti
|
confidenceScore | float |
Odpovězte na skóre spolehlivosti, rozsahy hodnot od 0 do 1. |
|
QnA ID
|
id | integer |
ID výsledku QnA. |
|
odeslat k provedení
|
source | string |
Zdroj výsledku QnA |
|
metadata
|
metadata | object |
Metadata přidružená k odpovědi, užitečná ke kategorizaci nebo filtrování odpovědí na otázky. |
|
dialog
|
dialog | KnowledgeBaseAnswerDialog |
Dialogové okno přidružené k odpovědi |
|
answerSpan
|
answerSpan | AnswerSpan |
Odpověď span objektu QnA. |
KnowledgeBaseAnswerDialog
Dialogové okno přidružené k odpovědi
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
isContextOnly
|
isContextOnly | boolean |
Pokud chcete označit, jestli je výzva relevantní jenom s předchozí otázkou, nebo ne. Pokud je pravda, nezahrnujte tuto funkci QnA jako výsledek hledání pro dotazy bez kontextu; jinak pokud je false, ignoruje kontext a zahrne tuto QnA do výsledku hledání. |
|
pobídky
|
prompts | array of KnowledgeBaseAnswerPrompt |
Seznam výzev přidružených k odpovědi |
KnowledgeBaseAnswerPrompt
Výzva k zadání odpovědi
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
displayOrder
|
displayOrder | integer |
Index výzvy – používá se v pořadí výzev. |
|
qnaId
|
qnaId | integer |
ID QnA odpovídající výzvě. |
|
displayText
|
displayText | string |
Text zobrazený tak, aby představoval výzvu k následné otázce. |
AnswerSpan
Odpověď span objektu QnA.
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
poslat SMS
|
text | string |
Predikovaný text přesné odpovědi |
|
Prahová hodnota spolehlivosti
|
confidenceScore | float |
Predikované skóre přesné odpovědi, rozsahy hodnot od 0 do 1 |
|
posun
|
offset | integer |
Přesný posun odpovědi od začátku odpovědi. |
|
length
|
length | integer |
Délka přesné odpovědi. |
AnswersFromTextResult
Představuje výsledky odpovědí.
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
odpovědi
|
answers | array of TextAnswer |
Představuje výsledky odpovědí. |
TextAnswer
Představuje výsledek odpovědi.
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
odpověď
|
answer | string |
Text odpovědi. |
|
Prahová hodnota spolehlivosti
|
confidenceScore | float |
Odpovězte na skóre spolehlivosti, rozsahy hodnot od 0 do 1. |
|
identifikační číslo
|
id | string |
ID záznamu. |
|
answerSpan
|
answerSpan | AnswerSpan |
Odpověď span objektu QnA. |
|
posun
|
offset | integer |
Odsazení věty od začátku dokumentu |
|
length
|
length | integer |
Délka věty. |