Språk – frågesvar

API:et Language – Question Answering är en molnbaserad tjänst som tillhandahåller avancerad bearbetning av naturligt språk med toppmoderna transformeringsmodeller för att generera svar mot anpassade frågesvarsprojekt eller råtext. Frågesvar är en funktion i Language-tjänsten som utökas från QnA Maker-tjänsten med ytterligare funktioner som stöd för ostrukturerade dokument och exakta svar.

Den här anslutningsappen är tillgänglig i följande produkter och regioner:

Tjänster	Class	Regioner
Copilot Studio	Premie	Alla Power Automate-regioner utom följande:      – China Cloud drivs av 21Vianet
Logiska appar	Norm	Alla Logic Apps-regioner utom följande:      – Regioner i Azure Kina
Power Apps	Premie	Alla Power Apps-regioner utom följande:      – China Cloud drivs av 21Vianet
Power Automate	Premie	Alla Power Automate-regioner utom följande:      – China Cloud drivs av 21Vianet

Kontakt
Namn	Support för frågesvar
URL	https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/overview
E-postmeddelande	qnamakersupport@microsoft.com

Metadata för anslutningsprogram
Utgivare	Mikrosot
Webbplats	https://azure.microsoft.com/en-us/services/cognitive-services/question-answering/#overview
Sekretesspolicy	https://privacy.microsoft.com/en-us/privacystatement
Kategorier	Artificiell intelligens; Webbplats

Language – Question Answering Connector är en anslutningsapp för att integrera power-appar med vår nya funktion för frågesvar i Language Service. Med den här anslutningsappen kan användarna nu ansluta till de nya och förbättrade funktionerna i Frågesvar. Det finns åtgärder i den här anslutningsappen som hjälper användarna att

• Generera svar från projektet
• Hämta projektmetadata
• Generera svar från angiven text under en viss tidsperiod, vi planerar att distribuera fler åtgärder för att ge fler funktioner till våra kunder.

Förutsättningar

Följ anvisningarna här för att skapa ett anpassat frågesvarsprojekt.

Hämta autentiseringsuppgifter

1. När du har distribuerat projektet klickar du på Hämta förutsägelse-URL.
2. Hämta webbplats-URL:en från värdnamnet för förutsägelse-URL:en och din kontonyckel som skulle vara Ocp-Apim-Subscription-Key.
3. Skapa en anslutning med hjälp av din kontonyckel och webbplats-URL.

Kom igång med anslutningsappen

Använda anslutningsprogram i ett flöde

1. Gå till Microsoft Power Automate och klicka på Skapa och välj "Instant Cloud flow".
2. För att testa den här anslutningsappen kan du klicka på "Utlös ett flöde manuellt" och klicka på Create.
3. Klicka på "Nytt steg" och sök efter "Language – Question Answering" och välj bland de tre åtgärderna.

Åtgärder:

Generera svar från project

1. Den här åtgärden hjälper dig att besvara den angivna frågan med hjälp av din kunskapsbas i projektet.
2. Du kan ge den här frågan för att generera svar från ditt "Sample-project"
3. Läs mer om begärandetexten härifrån: Frågesvar – Få svar – REST API (Azure Cognitive Services) | Microsoft Docs

Hämta projektmetadata

1. Den här åtgärden hjälper dig att hämta alla metadata för projektet.
2. Ge projektnamnet för att hämta metadata för projektet.

Generera svar från angivet text

1. Den här åtgärden hjälper dig att besvara den angivna frågan med hjälp av den angivna texten. Om du bara vill använda den här åtgärden behöver svar på anpassade frågor inte aktiveras på språkresursen.
2. Den här åtgärden kräver inte ett anpassat frågesvarsprojekt. Den behöver bara en språkresurs. Du kan skapa en språkresurs och kopiera din slutpunkt och nyckel från Azure-portalen, i avsnittet Nycklar och slutpunkter, till webbplats-URL respektive kontonyckel.
3. Fråga " hur lång tid det tar att ladda ytan? " på följande text: " Ström och laddning. Det tar två till fyra timmar att ladda Surface Pro 4-batteriet helt från ett tomt tillstånd. Det kan ta längre tid om du använder Surface för energiintensiva aktiviteter som spel- eller videoströmning medan du laddar den "".
4. Läs mer om begärandetexten härifrån: Frågesvar – Hämta svar från text – REST API (Azure Cognitive Services) | Microsoft Docs

Svar

Generera svar från project

Det returnerar ett svar från ditt "Sample-project" för frågan "Tillgänglighet". Mer information om svarsobjektet för den här åtgärden finns i Frågesvar – Få svar – REST API (Azure Cognitive Services) | Microsoft Docs

Generera svar från angivet text

Den extraherar svaret på din fråga från den angivna texten. Mer information om svarsobjektet finns i Svar på frågor – Hämta svar från text – REST API (Azure Cognitive Services) | Microsoft Docs .

Hämta projektmetadata

Det hämtar det begärda projektets metadata. Mer information om svarsobjektet finns i Frågesvarsprojekt – Hämta projektinformation – REST API (Azure Cognitive Services) | Microsoft Docs .

Kända problem och begränsningar

Vi har inte hittat några, kontakta oss om du hittar någon på qnamakersupport@microsoft.com

Vanliga fel och åtgärder

Läs den här dokumentationen: https://docs.microsoft.com/en-us/rest/api/cognitiveservices/questionanswering/question-answering

Vanliga frågor

Läs den här dokumentationen: https://docs.microsoft.com/en-us/azure/cognitive-services/language-service/question-answering/overview

Skapa en anslutning

Anslutningsappen stöder följande autentiseringstyper:

API-nyckel	API-nyckel	Alla regioner	Shareable
Azure AD-integrerat	Använd Azure Active Directory för att komma åt din Azure Blob Storage.	Alla regioner	Går inte att dela
Standard [INAKTUELL]	Det här alternativet är endast för äldre anslutningar utan en explicit autentiseringstyp och tillhandahålls endast för bakåtkompatibilitet.	Alla regioner	Går inte att dela

API-nyckel

Autentiserings-ID: keyBasedAuth

Tillämpligt: Alla regioner

API-nyckel

Det här är en delningsbar anslutning. Om power-appen delas med en annan användare delas även anslutningen. Mer information finns i Översikt över anslutningsappar för arbetsyteappar – Power Apps | Microsoft Docs

Namn	Typ	Description	Krävs
Kontonyckel	securestring	Slutpunktsnyckeln för språkresursen som ska kopieras från Azure-portalen	Sann
Webbplats-URL	snöre	Värdnamn för din språkresurs som ska kopieras från Azure-portalen	Sann

Azure AD-integrerat

Autentiserings-ID: tokenBasedAuth

Tillämpligt: Alla regioner

Använd Azure Active Directory för att komma åt din Azure Blob Storage.

Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.

Namn	Typ	Description	Krävs
Webbplats-URL	snöre	Värdnamn för din språkresurs som ska kopieras från Azure-portalen	Sann

Standard [INAKTUELL]

Tillämpligt: Alla regioner

Det här alternativet är endast för äldre anslutningar utan en explicit autentiseringstyp och tillhandahålls endast för bakåtkompatibilitet.

Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.

Namn	Typ	Description	Krävs
Kontonyckel	securestring	Slutpunktsnyckeln för språkresursen som ska kopieras från Azure-portalen	Sann
Webbplats-URL	snöre	Värdnamn för din språkresurs som ska kopieras från Azure-portalen	Sann

Begränsningsgränser

Name	Anrop	Förnyelseperiod
API-anrop per anslutning	100	60 sekunder

Åtgärder

Generera svar från angivet text	Den här åtgärden hjälper dig att besvara den angivna frågan med hjälp av den angivna texten.
Generera svar från Project	Den här åtgärden hjälper dig att besvara den angivna frågan med hjälp av din kunskapsbas i projektet.
Hämta projektmetadata	Den här åtgärden hjälper dig att hämta alla metadata för projektet.

Generera svar från angivet text

Åtgärds-ID:

GetAnswersFromText

Den här åtgärden hjälper dig att besvara den angivna frågan med hjälp av den angivna texten.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Question	question	True	string	Användarfråga för att fråga mot de angivna textposterna.
Id-nummer	id	True	string	Unik identifierare för textposten.
texten	text	True	string	Textinnehåll i posten.
Language	language		string	Språk för textposterna. Det här är BCP-47-representation av ett språk.
Strängindextyp	stringIndexType		string	Anger den metod som används för att tolka strängförskjutningar. Standardvärdet är Textelement (Graphemes) enligt Unicode v8.0.0. Mer information finns i https://aka.ms/text-analytics-offsets.
API-version	api-version	True	string	Det här är klient-API-versionen.

Returer

Representerar svarsresultatet.

Body

AnswersFromTextResult

Generera svar från Project

Åtgärds-ID:

GenerateAnswer

Den här åtgärden hjälper dig att besvara den angivna frågan med hjälp av din kunskapsbas i projektet.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Projektnamn	projectName	True	string	Det här är det projektnamn som du vill använda.
Question	question	True	string	Användarfråga för att köra frågor mot projektet.
Användar-ID	userId		string	Unik identifierare för användaren.
Topp #	top		integer	Maximalt antal svar som ska returneras för frågan.
Tröskelvärde för konfidens	confidenceScoreThreshold		float	Minsta tröskelvärdespoäng för svar. Värdeintervall från 0 till 1.
Rankningstyp	rankerType		string	Typ av rangordning som ska användas.
QnA-ID	qnaId		string	Det här är det exakta QnA-ID:t som ska hämtas från projektet.
Föregående QnA-ID	previousQnaId		integer	QnA-ID för svarsresultat i föregående tur.
Föregående användarfråga	previousUserQuery		string	Tidigare användarfråga.
key	key		string	Metadatanyckel från metadataordlistan som används i QnA.
värde	value		string	Metadatavärde från metadataordlistan som används i QnA.
Koppla metadata med	logicalOperation		string	Ange "OR" eller "AND" för motsvarande logiska åtgärd för metadatafilter.
Källfilter	sourceFilter		string	Hitta QnA:er som är associerade med någon av de angivna källorna i projektet.
Koppla filter med	logicalOperation		string	Logisk åtgärd som används för att koppla metadatafilter med källfilter.
Aktivera exakt svar	enable		boolean	Aktivera eller inaktivera Förutsägelse av svarsintervall.
Tröskelvärde för konfidens	confidenceScoreThreshold		float	Minsta tröskelvärdespoäng som krävs för att inkludera ett exakt svar, värdet varierar från 0 till 1.
Topp #	topAnswersWithSpan		integer	Antal toppsvar som ska beaktas för exakt svarsförutsägelse från 1 till 10.
Inkludera ostrukturerade källor	includeUnstructuredSources		boolean	Flagga för att aktivera frågor över ostrukturerade källor.
Distributionsnamn	deploymentName	True	string	Det här är den specifika distributionen av det projekt som du vill använda.
API-version	api-version	True	string	Det här är klient-API-versionen.

Returer

Representerar en lista över frågesvar.

Body

AnswersResult

Hämta projektmetadata

Åtgärds-ID:

GetProjectDetails

Den här åtgärden hjälper dig att hämta alla metadata för projektet.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Projektnamn	ProjectNamePathParameter	True	string	Namnet på projektet som ska användas.
API-version	api-version	True	string	Det här är klient-API-versionen.

Returer

Representerar projektet.

Body

ProjectMetadata

Definitioner

ProjectMetadata

Representerar projektet.

Name	Sökväg	Typ	Description
projektnamn	projectName	string	Namnet på projektet.
beskrivning	description	string	Beskrivning av projektet.
Language	language	Language	Språk för textposterna. Det här är BCP-47-representation av ett språk.
defaultAnswer	settings.defaultAnswer	string	Svarssvar som standard när ingen bra matchning hittas i Kunskapsbasen.
multilingualResource	multilingualResource	boolean	Resurs aktiverad för flera språk mellan projekt eller inte.
createdDateTime	createdDateTime	date-time	Datum-tid för projektskapande.
lastModifiedDateTime	lastModifiedDateTime	date-time	Representerar projektets senast ändrade datum-tid.
lastDeployedDateTime	lastDeployedDateTime	date-time	Representerar projektets senaste distributionsdatum.

Language

Språk för textposterna. Det här är BCP-47-representation av ett språk.

Språk för textposterna. Det här är BCP-47-representation av ett språk.

Language

string

AnswersResult

Representerar en lista över frågesvar.

Name	Sökväg	Typ	Description
svar	answers	array of KnowledgeBaseAnswer	Representerar svarsresultatlistan.
isUserQuestionAmbiguous	isUserQuestionAmbiguous	boolean	Returnerar ett booleskt värde om användarens fråga var tvetydig.

KnowledgeBaseAnswer

Representerar projektsvar.

Name	Sökväg	Typ	Description
frågor	questions	array of string	Lista över frågor som är associerade med svaret.
svar	answer	string	Besvara text.
Tröskelvärde för konfidens	confidenceScore	float	Svar på konfidenspoäng, värdet varierar från 0 till 1.
QnA-ID	id	integer	ID för QnA-resultatet.
källa	source	string	Källa för QnA-resultat.
metadata	metadata	object	Metadata som är associerade med svaret, användbara för att kategorisera eller filtrera frågesvar.
dialog	dialog	KnowledgeBaseAnswerDialog	Dialogruta som är associerad med Svar.
answerSpan	answerSpan	AnswerSpan	Svarsintervallobjekt för QnA.

KnowledgeBaseAnswerDialog

Dialogruta som är associerad med Svar.

Name	Sökväg	Typ	Description
isContextOnly	isContextOnly	boolean	Att markera om en fråga endast är relevant med en tidigare fråga eller inte. Om det är sant ska du inte inkludera denna QnA som sökresultat för frågor utan kontext. annars, om det är falskt, ignorerar kontexten och inkluderar denna QnA i sökresultatet.
prompter	prompts	array of KnowledgeBaseAnswerPrompt	Lista över frågor som är associerade med svaret.

KnowledgeBaseAnswerPrompt

Fråga efter ett svar.

Name	Sökväg	Typ	Description
displayOrder	displayOrder	integer	Index för prompten – används i ordning på prompterna.
qnaId	qnaId	integer	QnA-ID som motsvarar prompten.
displayText	displayText	string	Text som visas för att representera en fråga om uppföljning.

AnswerSpan

Svarsintervallobjekt för QnA.

Name	Sökväg	Typ	Description
texten	text	string	Förutsagd text med exakt svar.
Tröskelvärde för konfidens	confidenceScore	float	Förutsagd poäng för exakt svar, värdet varierar från 0 till 1.
offset	offset	integer	Exakt svarsförskjutning från början av svaret.
length	length	integer	Längden på det exakta svaret.

AnswersFromTextResult

Representerar svarsresultatet.

Name	Sökväg	Typ	Description
svar	answers	array of TextAnswer	Representerar svarsresultatet.

TextAnswer

Representerar svarsresultat.

Name	Sökväg	Typ	Description
svar	answer	string	Svara på text.
Tröskelvärde för konfidens	confidenceScore	float	Svar på konfidenspoäng, värdet varierar från 0 till 1.
Id-nummer	id	string	Post-ID.
answerSpan	answerSpan	AnswerSpan	Svarsintervallobjekt för QnA.
offset	offset	integer	Meningsförskjutningen från början av dokumentet.
length	length	integer	Längden på meningen.