Langue - Réponse aux questions
L’API Language - Questions Answering est un service basé sur le cloud qui fournit un traitement en langage naturel avancé avec l’état des modèles transformateurs d’art pour générer des réponses à des projets de réponses aux questions personnalisées ou du texte brut. La réponse aux questions est une fonctionnalité du service Language qui est améliorée à partir du service QnA Maker avec des fonctionnalités supplémentaires telles que la prise en charge des documents non structurés et des réponses précises.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - China Cloud géré par 21Vianet |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Chine |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - China Cloud géré par 21Vianet |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - China Cloud géré par 21Vianet |
| Contact | |
|---|---|
| Nom | Prise en charge des réponses aux questions |
| URL | https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/overview |
| Messagerie électronique | qnamakersupport@microsoft.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Microsot |
| Site internet | https://azure.microsoft.com/en-us/services/cognitive-services/question-answering/#overview |
| Politique de confidentialité | https://privacy.microsoft.com/en-us/privacystatement |
| Catégories | IA; Site internet |
Language - Question Answering Connector est un connecteur permettant d’intégrer n’importe quelle application Power à notre nouvelle fonctionnalité de réponse aux questions dans le service language. Avec ce connecteur, les utilisateurs peuvent désormais se connecter aux nouvelles fonctionnalités ainsi qu’aux fonctionnalités améliorées de la réponse aux questions. Il existe des actions dans ce connecteur qui aident les utilisateurs à
- Générer des réponses à partir d’un projet
- Obtenir les métadonnées du projet
- Générez des réponses à partir d’un texte fourni sur une période donnée, nous prévoyons de déployer davantage d’actions pour donner plus de fonctionnalités à nos clients.
Prerequisites
Suivez les instructions ci-dessous pour créer un projet de réponse aux questions personnalisées.
Comment obtenir des informations d’identification
- Après avoir déployé votre projet, cliquez sur « Obtenir l’URL de prédiction ».
- Obtenez votre URL de site à partir du nom d’hôte de l’URL de prédiction et de votre clé de compte, qui serait la clé Ocp-Apim-Subscription-Key.
- Créez une connexion à l’aide de votre clé de compte et de votre URL de site.
Bien démarrer avec votre connecteur
Utiliser le connecteur dans un flux
- Accédez à Microsoft Power Automate , puis cliquez sur Créer et sélectionnez « Flux cloud instantané ».
- Pour tester ce connecteur, vous pouvez cliquer sur « Déclencher manuellement un flux », puis cliquer sur
Create.
- Cliquez sur « Nouvelle étape » et recherchez « Langue – Réponse aux questions » et choisissez parmi les trois actions.
Actions :
Générer une réponse à partir de Project
- Cette action permet de répondre à la question spécifiée à l’aide de votre base de connaissances dans votre projet.
- Vous pouvez donner cette requête pour générer une réponse à partir de votre projet « Sample-project »
- En savoir plus sur le corps de la requête ici : Réponse aux questions - Obtenir des réponses - API REST (Azure Cognitive Services) | Microsoft Docs
Obtenir les métadonnées du projet
- Cette action permet d’obtenir toutes les métadonnées de votre projet.
- Donnez le nom de votre projet pour obtenir les métadonnées de votre projet.
Générer une réponse à partir du texte fourni
- Cette action permet de répondre à la question spécifiée à l’aide du texte fourni. Pour utiliser uniquement cette action, la réponse aux questions personnalisées n’a pas besoin d’être activée sur la ressource language.
- Cette action ne nécessite pas de projet de réponses aux questions personnalisées. Il a uniquement besoin d’une ressource language. Vous pouvez créer une ressource de langue et copier votre point de terminaison et votre clé à partir du portail Azure, dans la section Clés et Point de terminaison, vers l’URL du site et la clé de compte respectivement.
- Requête « combien de temps faut-il pour charger la surface ? « sur le texte suivant : " Puissance et charge. Il faut deux à quatre heures pour charger entièrement la batterie Surface Pro 4 à partir d’un état vide. Cela peut prendre plus de temps si vous utilisez votre Surface pour des activités gourmandes en puissance comme le jeu ou la diffusion en continu vidéo pendant que vous chargez «
- En savoir plus sur le corps de la requête ici : Réponse aux questions - Obtenir des réponses à partir du texte - API REST (Azure Cognitive Services) | Microsoft Docs
Réponse
Générer une réponse à partir de Project
Elle renvoie une réponse de votre « exemple de projet » pour la question « Accessibilité ». Pour en savoir plus sur l’objet de réponse pour cette action, consultez Réponses aux questions - Obtenir des réponses - API REST (Azure Cognitive Services) | Microsoft Docs
Générer la réponse à partir du texte fourni
Il extrait la réponse à votre question à partir du texte donné. Pour en savoir plus sur l’objet de réponse, consultez Réponse aux questions - Obtenir des réponses à partir du texte - API REST (Azure Cognitive Services) | Microsoft Docs .
Obtenir les métadonnées du projet
Elle obtient les métadonnées du projet demandées. Pour en savoir plus sur l’objet réponse, consultez Projets de réponses aux questions - Obtenir les détails du projet - API REST (Azure Cognitive Services) | Microsoft Docs .
Problèmes connus et limitations
Nous n’avons trouvé aucun, s’il vous plaît nous contacter si vous trouvez à qnamakersupport@microsoft.com
Erreurs courantes et solutions
Reportez-vous à cette documentation : https://docs.microsoft.com/en-us/rest/api/cognitiveservices/questionanswering/question-answering
Questions fréquentes (FAQ)
Reportez-vous à cette documentation : https://docs.microsoft.com/en-us/azure/cognitive-services/language-service/question-answering/overview
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Clé API | ApiKey | Toutes les régions | Partageable |
| Azure AD Intégré | Utilisez Azure Active Directory pour accéder à votre Stockage Blob Azure. | Toutes les régions | Non partageable |
| Valeur par défaut [DÉCONSEILLÉE] | Cette option concerne uniquement les connexions plus anciennes sans type d’authentification explicite et est fournie uniquement pour la compatibilité descendante. | Toutes les régions | Non partageable |
Clé API
ID d’authentification : keyBasedAuth
Applicable : Toutes les régions
ApiKey
Il s’agit d’une connexion partageable. Si l’application d’alimentation est partagée avec un autre utilisateur, la connexion est également partagée. Pour plus d’informations, consultez la vue d’ensemble des connecteurs pour les applications de canevas - Power Apps | Microsoft Docs
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| Clé de compte | securestring | Clé de point de terminaison de votre ressource de langue à copier à partir du portail Azure | Vrai |
| URL du site | ficelle | Nom d’hôte de votre ressource de langue à copier à partir du portail Azure | Vrai |
Azure AD Intégré
ID d’authentification : tokenBasedAuth
Applicable : Toutes les régions
Utilisez Azure Active Directory pour accéder à votre Stockage Blob Azure.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| URL du site | ficelle | Nom d’hôte de votre ressource de langue à copier à partir du portail Azure | Vrai |
Valeur par défaut [DÉCONSEILLÉE]
Applicable : Toutes les régions
Cette option concerne uniquement les connexions plus anciennes sans type d’authentification explicite et est fournie uniquement pour la compatibilité descendante.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| Clé de compte | securestring | Clé de point de terminaison de votre ressource de langue à copier à partir du portail Azure | Vrai |
| URL du site | ficelle | Nom d’hôte de votre ressource de langue à copier à partir du portail Azure | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Générer une réponse à partir de Project |
Cette action permet de répondre à la question spécifiée à l’aide de votre base de connaissances dans votre projet. |
| Générer une réponse à partir du texte fourni |
Cette action permet de répondre à la question spécifiée à l’aide du texte fourni. |
| Obtenir les métadonnées du projet |
Cette action permet d’obtenir toutes les métadonnées de votre projet. |
Générer une réponse à partir de Project
Cette action permet de répondre à la question spécifiée à l’aide de votre base de connaissances dans votre projet.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom du projet
|
projectName | True | string |
Il s’agit du nom du projet que vous souhaitez utiliser. |
|
Question
|
question | True | string |
Question de l’utilisateur à interroger sur le projet. |
|
ID d’utilisateur
|
userId | string |
Identificateur unique de l’utilisateur. |
|
|
Retour au début #
|
top | integer |
Nombre maximal de réponses à renvoyer pour la question. |
|
|
Seuil de confiance
|
confidenceScoreThreshold | float |
Score de seuil minimal pour les réponses. La valeur est comprise entre 0 et 1. |
|
|
Type ranker
|
rankerType | string |
Type de ranker à utiliser. |
|
|
QnA ID
|
qnaId | string |
Il s’agit de l’ID QnA exact à extraire du projet. |
|
|
ID QnA précédent
|
previousQnaId | integer |
ID QnA du résultat de réponse du tour précédent. |
|
|
Requête utilisateur précédente
|
previousUserQuery | string |
Requête utilisateur précédente. |
|
|
key
|
key | string |
Clé de métadonnées du dictionnaire de métadonnées utilisée dans le QnA. |
|
|
value
|
value | string |
Valeur des métadonnées du dictionnaire de métadonnées utilisée dans le QnA. |
|
|
Joindre des métadonnées avec
|
logicalOperation | string |
Définissez « OR » ou « AND » pour l’opération logique correspondante pour les filtres de métadonnées. |
|
|
Filtre source
|
sourceFilter | string |
Recherchez des QnAs associées à l’une des sources fournies dans le projet. |
|
|
Joindre des filtres avec
|
logicalOperation | string |
Opération logique utilisée pour joindre le filtre de métadonnées avec le filtre source. |
|
|
Activer une réponse précise
|
enable | boolean |
Activez ou désactivez la prédiction de l’étendue de réponse. |
|
|
Seuil de confiance
|
confidenceScoreThreshold | float |
Score de seuil minimal requis pour inclure une réponse précise, la valeur est comprise entre 0 et 1. |
|
|
Retour au début #
|
topAnswersWithSpan | integer |
Nombre de réponses principales à prendre en compte pour une prédiction de réponse précise comprise entre 1 et 10. |
|
|
Inclure des sources non structurées
|
includeUnstructuredSources | boolean |
Indicateur pour activer la requête sur des sources non structurées. |
|
|
Nom du déploiement
|
deploymentName | True | string |
Il s’agit du déploiement spécifique du projet que vous souhaitez utiliser. |
|
Version de l’API
|
api-version | True | string |
Il s’agit de la version de l’API cliente. |
Retours
Représente la liste des réponses aux questions.
- Corps
- AnswersResult
Générer une réponse à partir du texte fourni
Cette action permet de répondre à la question spécifiée à l’aide du texte fourni.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Question
|
question | True | string |
Question de l’utilisateur à interroger sur les enregistrements de texte donnés. |
|
pièce d'identité
|
id | True | string |
Identificateur unique de l’enregistrement de texte. |
|
texte
|
text | True | string |
Contenu texte de l’enregistrement. |
|
Language
|
language | string |
Langue des enregistrements de texte. Il s’agit de la représentation BCP-47 d’une langue. |
|
|
Type d’index de chaîne
|
stringIndexType | string |
Spécifie la méthode utilisée pour interpréter les décalages de chaîne. Valeur par défaut des éléments de texte (Graphemes) en fonction d’Unicode v8.0.0. Pour plus d’informations, consultez https://aka.ms/text-analytics-offsets. |
|
|
Version de l’API
|
api-version | True | string |
Il s’agit de la version de l’API cliente. |
Retours
Représente les résultats de la réponse.
- Corps
- AnswersFromTextResult
Obtenir les métadonnées du projet
Cette action permet d’obtenir toutes les métadonnées de votre projet.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom du projet
|
ProjectNamePathParameter | True | string |
Nom du projet à utiliser. |
|
Version de l’API
|
api-version | True | string |
Il s’agit de la version de l’API cliente. |
Retours
Représente le projet.
- Corps
- ProjectMetadata
Définitions
ProjectMetadata
Représente le projet.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
nom_projet
|
projectName | string |
Nom du projet. |
|
descriptif
|
description | string |
Description du projet. |
|
Language
|
language | Language |
Langue des enregistrements de texte. Il s’agit de la représentation BCP-47 d’une langue. |
|
defaultAnswer
|
settings.defaultAnswer | string |
Réponse par défaut quand aucune bonne correspondance n’est trouvée dans la base de connaissances. |
|
multilingueResource
|
multilingualResource | boolean |
Ressource activée pour plusieurs langages entre les projets ou non. |
|
createdDateTime
|
createdDateTime | date-time |
Date de création du projet. |
|
lastModifiedDateTime
|
lastModifiedDateTime | date-time |
Représente l’heure de la dernière modification du projet. |
|
lastDeployedDateTime
|
lastDeployedDateTime | date-time |
Représente la date du dernier déploiement du projet. |
Language
Langue des enregistrements de texte. Il s’agit de la représentation BCP-47 d’une langue.
Langue des enregistrements de texte. Il s’agit de la représentation BCP-47 d’une langue.
- Language
- string
AnswersResult
Représente la liste des réponses aux questions.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
answers
|
answers | array of KnowledgeBaseAnswer |
Représente la liste des résultats de la réponse. |
|
isUserQuestionAmbiguous
|
isUserQuestionAmbiguous | boolean |
Retourne une valeur booléenne si la question de l’utilisateur était ambiguë. |
KnowledgeBaseAnswer
Représente la réponse du projet.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
questionne
|
questions | array of string |
Liste des questions associées à la réponse. |
|
répondre
|
answer | string |
Texte de réponse. |
|
Seuil de confiance
|
confidenceScore | float |
Score de confiance de la réponse, la valeur est comprise entre 0 et 1. |
|
QnA ID
|
id | integer |
ID du résultat QnA. |
|
Source
|
source | string |
Source du résultat QnA. |
|
metadata
|
metadata | object |
Métadonnées associées à la réponse, utiles pour catégoriser ou filtrer les réponses aux questions. |
|
fenêtre de dialogue
|
dialog | KnowledgeBaseAnswerDialog |
Boîte de dialogue associée à La réponse. |
|
answerSpan
|
answerSpan | AnswerSpan |
Objet d’étendue de réponse de QnA. |
KnowledgeBaseAnswerDialog
Boîte de dialogue associée à La réponse.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
isContextOnly
|
isContextOnly | boolean |
Marquer si une invite est pertinente uniquement avec une question précédente ou non. Si la valeur est true, n’incluez pas ce QnA comme résultat de recherche pour les requêtes sans contexte ; sinon, si la valeur est false, ignore le contexte et inclut ce QnA dans le résultat de la recherche. |
|
invites
|
prompts | array of KnowledgeBaseAnswerPrompt |
Liste des invites associées à la réponse. |
KnowledgeBaseAnswerPrompt
Demander une réponse.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
displayOrder
|
displayOrder | integer |
Index de l’invite : utilisé dans l’ordre des invites. |
|
qnaId
|
qnaId | integer |
ID QnA correspondant à l’invite. |
|
displayText
|
displayText | string |
Texte affiché pour représenter une invite de questions de suivi. |
AnswerSpan
Objet d’étendue de réponse de QnA.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
texte
|
text | string |
Texte prédit de réponse précise. |
|
Seuil de confiance
|
confidenceScore | float |
Score prédit de réponse précise, la valeur est comprise entre 0 et 1. |
|
offset
|
offset | integer |
Décalage précis de la réponse par rapport au début de la réponse. |
|
length
|
length | integer |
Longueur de la réponse précise. |
AnswersFromTextResult
Représente les résultats de la réponse.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
answers
|
answers | array of TextAnswer |
Représente les résultats de la réponse. |
TextAnswer
Représente le résultat de la réponse.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
répondre
|
answer | string |
Texte de réponse. |
|
Seuil de confiance
|
confidenceScore | float |
Score de confiance de la réponse, la valeur est comprise entre 0 et 1. |
|
pièce d'identité
|
id | string |
ID d’enregistrement. |
|
answerSpan
|
answerSpan | AnswerSpan |
Objet d’étendue de réponse de QnA. |
|
offset
|
offset | integer |
Décalage de phrase du début du document. |
|
length
|
length | integer |
Longueur de la phrase. |