Sprache – Fragebeantwortung
Die API für Die Sprache – Fragebeantwortung ist ein cloudbasierter Dienst, der eine erweiterte Verarbeitung natürlicher Sprache mit modernsten Transformatormodellen bietet, um Antworten gegen benutzerdefinierte Fragebeantwortungsprojekte oder unformatierten Text zu generieren. Die Frageantwort ist ein Feature im Sprachdienst, das vom QnA Maker-Dienst mit zusätzlichen Features wie Unterstützung für unstrukturierte Dokumente und präzises Beantworten erweitert wird.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - China Cloud betrieben von 21Vianet |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: - Azure China-Regionen |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - China Cloud betrieben von 21Vianet |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - China Cloud betrieben von 21Vianet |
| Kontakt | |
|---|---|
| Name | Support zur Beantwortung von Fragen |
| URL | https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/overview |
| qnamakersupport@microsoft.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | Mikrosot |
| Webseite | https://azure.microsoft.com/en-us/services/cognitive-services/question-answering/#overview |
| Datenschutzrichtlinie | https://privacy.microsoft.com/en-us/privacystatement |
| Kategorien | Künstliche Intelligenz; Website |
Sprache – Der Fragebeantwortungsconnector ist ein Connector für die Integration einer beliebigen Power-App in unsere neue Funktion für die Fragebeantwortung innerhalb des Sprachdiensts. Mit diesem Connector können Benutzer jetzt eine Verbindung mit den neuen und erweiterten Features der Frageantwort herstellen. In diesem Connector gibt es Aktionen, die Benutzern helfen,
- Generieren von Antworten aus Dem Projekt
- Abrufen von Projektmetadaten
- Generieren Sie Antworten aus bereitgestelltem Text über einen bestimmten Zeitraum, wir planen, weitere Aktionen zur Verfügung zu stellen, um unseren Kunden mehr Funktionen zu bieten.
Voraussetzungen
Folgen Sie den Anweisungen hier , um ein Projekt zur Beantwortung benutzerdefinierter Fragen zu erstellen.
So erhalten Sie Anmeldeinformationen
- Klicken Sie nach der Bereitstellung Ihres Projekts auf "Get Prediction URL".
- Rufen Sie Ihre Website-URL vom Hostnamen der Vorhersage-URL und Ihrem Kontoschlüssel ab, was der Ocp-Apim-Subscription-Key wäre.
- Erstellen Sie eine Verbindung mit Ihrem Kontoschlüssel und Ihrer Website-URL.
Erste Schritte mit Ihrem Connector
Verwenden von Connector in einem Fluss
- Wechseln Sie zu Microsoft Power Automate , und klicken Sie auf "Erstellen", und wählen Sie "Instant Cloud flow" aus.
- Zum Testen dieses Connectors können Sie auf "Manuell einen Fluss auslösen" klicken und auf klicken
Create.
- Klicken Sie auf "Neuer Schritt", und suchen Sie nach "Sprache – Frageantwort", und wählen Sie unter den drei Aktionen aus.
Aktionen:
Antwort aus Project generieren
- Diese Aktion hilft bei der Beantwortung der angegebenen Frage mithilfe Ihrer Wissensbasis in Ihrem Projekt.
- Sie können diese Abfrage zum Generieren von Antworten aus Ihrem "Sample-Project"
- Erfahren Sie mehr über den Anforderungstext von hier: Frageantwort - Get Answers - REST API (Azure Cognitive Services) | Microsoft-Dokumente
Projektmetadaten abrufen
- Diese Aktion hilft beim Abrufen aller Metadaten Ihres Projekts.
- Geben Sie Ihrem Projekt den Namen, um Metadaten Ihres Projekts abzurufen.
Antwort aus bereitgestellten Text generieren
- Diese Aktion hilft beim Beantworten der angegebenen Frage mithilfe des bereitgestellten Texts. Um nur diese Aktion zu verwenden, muss die benutzerdefinierte Frageantwort nicht für die Sprachressource aktiviert sein.
- Für diese Aktion ist kein benutzerdefiniertes Frageantwortprojekt erforderlich. Sie benötigt nur eine Sprachressource. Sie können eine Sprachressource erstellen und Ihren Endpunkt und Schlüssel aus dem Azure-Portal im Abschnitt "Schlüssel" und "Endpunkt" in "Website-URL" bzw. "Kontoschlüssel" kopieren.
- Abfrage " wie lange dauert es, um die Oberfläche aufzuladen? " im folgenden Text: " Ein- und Ladevorgang. Es dauert zwei bis vier Stunden, um den Surface Pro 4-Akku vollständig aus einem leeren Zustand aufzuladen. Es kann länger dauern, wenn Sie Ihr Surface für energieintensive Aktivitäten wie Spiele oder Videostreaming verwenden, während Sie es aufladen "
- Erfahren Sie mehr über den Anforderungstext von hier: Fragebeantwortung - Antworten von Text abrufen - REST-API (Azure Cognitive Services) | Microsoft-Dokumente
Antwort
Antwort aus Project generieren
Es wird eine Antwort von Ihrem "Beispielprojekt" für die Frage "Barrierefreiheit" zurückgegeben. Weitere Informationen zum Antwortobjekt für diese Aktion finden Sie unter "Frageantworten" – "Antworten abrufen " – REST-API (Azure Cognitive Services) | Microsoft-Dokumente
Antwort aus bereitgestellter Text generieren
Sie extrahiert die Antwort für Ihre Frage aus dem angegebenen Text. Weitere Informationen zum Antwortobjekt finden Sie unter "Frageantworten " – Antworten von Text abrufen – REST-API (Azure Cognitive Services) | Microsoft Docs .
Projektmetadaten abrufen
Es ruft die Metadaten des angeforderten Projekts ab. Weitere Informationen zum Antwortobjekt finden Sie unter Fragenbeantwortungsprojekte – Projektdetails abrufen - REST-API (Azure Cognitive Services) | Microsoft Docs .
Bekannte Probleme und Einschränkungen
Wir haben keine gefunden, wenden Sie sich bitte an uns, wenn Sie unter qnamakersupport@microsoft.com
Häufige Fehler und Abhilfemaßnahmen
Bitte lesen Sie diese Dokumentation: https://docs.microsoft.com/en-us/rest/api/cognitiveservices/questionanswering/question-answering
Häufig gestellte Fragen
Bitte lesen Sie diese Dokumentation: https://docs.microsoft.com/en-us/azure/cognitive-services/language-service/question-answering/overview
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| API-Schlüssel | API-Schlüssel | Alle Regionen | Freigabefähig |
| Azure AD Integrated | Verwenden Sie Azure Active Directory, um auf Ihren Azure Blob Storage zuzugreifen. | Alle Regionen | Nicht teilbar |
| Standard [VERALTET] | Diese Option ist nur für ältere Verbindungen ohne expliziten Authentifizierungstyp vorgesehen und wird nur aus Gründen der Abwärtskompatibilität bereitgestellt. | Alle Regionen | Nicht teilbar |
API-Schlüssel
Auth-ID: keyBasedAuth
Anwendbar: Alle Regionen
API-Schlüssel
Dies ist eine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird auch die Verbindung freigegeben. Weitere Informationen finden Sie in der Übersicht über Connectors für Canvas-Apps – Power Apps | Microsoft-Dokumente
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| Kontoschlüssel | securestring | Der Endpunktschlüssel für Ihre Sprachressource, die aus dem Azure-Portal kopiert werden soll | Richtig |
| Website-URL | Schnur | Hostname Ihrer Sprachressource, die aus dem Azure-Portal kopiert werden soll | Richtig |
Azure AD Integrated
Auth-ID: tokenBasedAuth
Anwendbar: Alle Regionen
Verwenden Sie Azure Active Directory, um auf Ihren Azure Blob Storage zuzugreifen.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| Website-URL | Schnur | Hostname Ihrer Sprachressource, die aus dem Azure-Portal kopiert werden soll | Richtig |
Standard [VERALTET]
Anwendbar: Alle Regionen
Diese Option ist nur für ältere Verbindungen ohne expliziten Authentifizierungstyp vorgesehen und wird nur aus Gründen der Abwärtskompatibilität bereitgestellt.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| Kontoschlüssel | securestring | Der Endpunktschlüssel für Ihre Sprachressource, die aus dem Azure-Portal kopiert werden soll | Richtig |
| Website-URL | Schnur | Hostname Ihrer Sprachressource, die aus dem Azure-Portal kopiert werden soll | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Antwort aus bereitgestellten Text generieren |
Diese Aktion hilft beim Beantworten der angegebenen Frage mithilfe des bereitgestellten Texts. |
| Generieren von Antworten aus Project |
Diese Aktion hilft bei der Beantwortung der angegebenen Frage mithilfe Ihrer Wissensbasis in Ihrem Projekt. |
| Projektmetadaten abrufen |
Diese Aktion hilft beim Abrufen aller Metadaten Ihres Projekts. |
Antwort aus bereitgestellten Text generieren
Diese Aktion hilft beim Beantworten der angegebenen Frage mithilfe des bereitgestellten Texts.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Frage
|
question | True | string |
Benutzerfrage, um die angegebenen Textdatensätze abzufragen. |
|
id
|
id | True | string |
Eindeutiger Bezeichner für den Textdatensatz. |
|
Text
|
text | True | string |
Textinhalt des Datensatzes. |
|
Language
|
language | string |
Sprache der Texteinträge. Dies ist die BCP-47-Darstellung einer Sprache. |
|
|
Zeichenfolgenindextyp
|
stringIndexType | string |
Gibt die Methode an, die zum Interpretieren von Zeichenfolgenversatzen verwendet wird. Standardeinstellung für Textelemente (Graphemes) gemäß Unicode v8.0.0. Weitere Informationen finden Sie unter https://aka.ms/text-analytics-offsets. |
|
|
API-Version
|
api-version | True | string |
Dies ist die Client-API-Version. |
Gibt zurück
Stellt die Antwortergebnisse dar.
Generieren von Antworten aus Project
Diese Aktion hilft bei der Beantwortung der angegebenen Frage mithilfe Ihrer Wissensbasis in Ihrem Projekt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Projektname
|
projectName | True | string |
Dies ist der Projektname, den Sie verwenden möchten. |
|
Frage
|
question | True | string |
Benutzerfrage zum Abfragen des Projekts. |
|
Benutzer-ID
|
userId | string |
Eindeutiger Bezeichner für den Benutzer. |
|
|
Nach oben #
|
top | integer |
Maximale Anzahl von Antworten, die für die Frage zurückgegeben werden sollen. |
|
|
Konfidenzschwellenwert
|
confidenceScoreThreshold | float |
Mindestschwellenwert für Antworten. Der Wert liegt zwischen 0 und 1. |
|
|
Rangfolgertyp
|
rankerType | string |
Typ des zu verwendenden Rangierers. |
|
|
QnA-ID
|
qnaId | string |
Dies ist die genaue QnA-ID, die aus dem Projekt abgerufen werden soll. |
|
|
Vorherige QnA-ID
|
previousQnaId | integer |
QnA-ID des vorherigen Runden-Antwortergebnisses. |
|
|
Vorherige Benutzerabfrage
|
previousUserQuery | string |
Vorherige Benutzerabfrage. |
|
|
key
|
key | string |
Metadatenschlüssel aus dem Metadatenwörterbuch, das in der QnA verwendet wird. |
|
|
value
|
value | string |
Metadatenwert aus dem Metadatenwörterbuch, das in der QnA verwendet wird. |
|
|
Metadaten beitreten mit
|
logicalOperation | string |
Legen Sie 'OR' oder 'AND' für den entsprechenden logischen Vorgang für Metadatenfilter fest. |
|
|
Quellfilter
|
sourceFilter | string |
Suchen Sie QnAs, die einer der angegebenen Quellenliste im Projekt zugeordnet sind. |
|
|
Verknüpfungsfilter mit
|
logicalOperation | string |
Logischer Vorgang, der zum Verknüpfen des Metadatenfilters mit dem Quellfilter verwendet wird. |
|
|
Präzise Antwort aktivieren
|
enable | boolean |
Aktivieren oder deaktivieren Sie die Antwortspanne-Vorhersage. |
|
|
Konfidenzschwellenwert
|
confidenceScoreThreshold | float |
Mindestschwellenwert, der erforderlich ist, um eine genaue Antwort einzuschließen, liegt der Wert zwischen 0 und 1. |
|
|
Nach oben #
|
topAnswersWithSpan | integer |
Die Anzahl der wichtigsten Antworten, die für genaue Antwortvorhersagen von 1 bis 10 berücksichtigt werden sollen. |
|
|
Unstrukturierte Quellen einschließen
|
includeUnstructuredSources | boolean |
Flag zum Aktivieren der Abfrage über unstrukturierte Quellen. |
|
|
Bereitstellungsname
|
deploymentName | True | string |
Dies ist die spezifische Bereitstellung des Projekts, das Sie verwenden möchten. |
|
API-Version
|
api-version | True | string |
Dies ist die Client-API-Version. |
Gibt zurück
Stellt die Liste der Frageantworten dar.
- Body
- AnswersResult
Projektmetadaten abrufen
Diese Aktion hilft beim Abrufen aller Metadaten Ihres Projekts.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Projektname
|
ProjectNamePathParameter | True | string |
Der Name des zu verwendenden Projekts. |
|
API-Version
|
api-version | True | string |
Dies ist die Client-API-Version. |
Gibt zurück
Stellt das Projekt dar.
- Body
- ProjectMetadata
Definitionen
ProjectMetadata
Stellt das Projekt dar.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
projectName
|
projectName | string |
Name des Projekts. |
|
Beschreibung
|
description | string |
Beschreibung des Projekts. |
|
Language
|
language | Language |
Sprache der Texteinträge. Dies ist die BCP-47-Darstellung einer Sprache. |
|
defaultAnswer
|
settings.defaultAnswer | string |
Standardantwortantwort, wenn keine gute Übereinstimmung in der Knowledgebase gefunden wird. |
|
multilingualResource
|
multilingualResource | boolean |
Ressource für mehrere Sprachen in Projekten aktiviert oder nicht. |
|
createdDateTime
|
createdDateTime | date-time |
Datum und Uhrzeit der Projekterstellung. |
|
lastModifiedDateTime
|
lastModifiedDateTime | date-time |
Stellt das Datum und die Uhrzeit der letzten Änderung des Projekts dar. |
|
lastDeployedDateTime
|
lastDeployedDateTime | date-time |
Stellt das Datum und die Uhrzeit der letzten Bereitstellung des Projekts dar. |
Language
Sprache der Texteinträge. Dies ist die BCP-47-Darstellung einer Sprache.
Sprache der Texteinträge. Dies ist die BCP-47-Darstellung einer Sprache.
- Language
- string
AnswersResult
Stellt die Liste der Frageantworten dar.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
answers
|
answers | array of KnowledgeBaseAnswer |
Stellt antwortergebnisliste dar. |
|
isUserQuestionAmbiguous
|
isUserQuestionAmbiguous | boolean |
Gibt einen booleschen Wert zurück, wenn die Frage des Benutzers mehrdeutig war. |
KnowledgeBaseAnswer
Stellt die Projektantwort dar.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Fragen
|
questions | array of string |
Liste der Fragen, die der Antwort zugeordnet sind. |
|
Antwort
|
answer | string |
Antworttext. |
|
Konfidenzschwellenwert
|
confidenceScore | float |
Antwort-Konfidenzbewertung, Der Wert reicht von 0 bis 1. |
|
QnA-ID
|
id | integer |
ID des QnA-Ergebnisses. |
|
source
|
source | string |
Quelle des QnA-Ergebnisses. |
|
metadata
|
metadata | object |
Metadaten, die der Antwort zugeordnet sind, nützlich zum Kategorisieren oder Filtern von Frageantworten. |
|
Dialogfeld
|
dialog | KnowledgeBaseAnswerDialog |
Dialogfeld, das mit "Antwort" verknüpft ist. |
|
answerSpan
|
answerSpan | AnswerSpan |
Antwort span-Objekt von QnA. |
KnowledgeBaseAnswerDialog
Dialogfeld, das mit "Antwort" verknüpft ist.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
isContextOnly
|
isContextOnly | boolean |
Um zu markieren, ob eine Eingabeaufforderung nur mit einer vorherigen Frage relevant ist oder nicht. Wenn wahr, schließen Sie diese QnA nicht als Suchergebnis für Abfragen ohne Kontext ein; andernfalls ignoriert der Kontext und schließt diesen QnA in das Suchergebnis ein. |
|
Prompts
|
prompts | array of KnowledgeBaseAnswerPrompt |
Liste der Eingabeaufforderungen, die der Antwort zugeordnet sind. |
KnowledgeBaseAnswerPrompt
Zur Eingabe einer Antwort auffordern.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
displayOrder
|
displayOrder | integer |
Index der Eingabeaufforderung – wird in der Reihenfolge der Eingabeaufforderungen verwendet. |
|
qnaId
|
qnaId | integer |
QnA-ID, die der Eingabeaufforderung entspricht. |
|
displayText
|
displayText | string |
Text, der angezeigt wird, um eine Nachverfolgungsfrageaufforderung darzustellen. |
AnswerSpan
Antwort span-Objekt von QnA.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Text
|
text | string |
Vorhergesagter Text der genauen Antwort. |
|
Konfidenzschwellenwert
|
confidenceScore | float |
Die prognostizierte Bewertung der genauen Antwort, der Wert reicht von 0 bis 1. |
|
offset
|
offset | integer |
Die genaue Antwort versetzt vom Anfang der Antwort. |
|
length
|
length | integer |
Die Länge der genauen Antwort. |
AnswersFromTextResult
Stellt die Antwortergebnisse dar.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
answers
|
answers | array of TextAnswer |
Stellt die Antwortergebnisse dar. |
TextAnswer
Stellt das Antwortergebnis dar.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Antwort
|
answer | string |
Antworttext. |
|
Konfidenzschwellenwert
|
confidenceScore | float |
Antwort-Konfidenzbewertung, Der Wert reicht von 0 bis 1. |
|
id
|
id | string |
Datensatz-ID. |
|
answerSpan
|
answerSpan | AnswerSpan |
Antwort span-Objekt von QnA. |
|
offset
|
offset | integer |
Der Satzabstand vom Anfang des Dokuments. |
|
length
|
length | integer |
Die Länge des Satzes. |