Idioma: respuesta a preguntas
Language - Question Answering API es un servicio basado en la nube que proporciona procesamiento avanzado de lenguaje natural con modelos de transformadores de última generación para generar respuestas contra proyectos personalizados de respuesta a preguntas o texto sin formato. La respuesta a preguntas es una característica del servicio language que se mejora del servicio QnA Maker con características adicionales, como la compatibilidad con documentos no estructurados y respuestas precisas.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - China Cloud operado por 21Vianet |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure China |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - China Cloud operado por 21Vianet |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - China Cloud operado por 21Vianet |
| Contacto | |
|---|---|
| Nombre | Compatibilidad con respuestas a preguntas |
| URL | https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/overview |
| Correo Electrónico | qnamakersupport@microsoft.com |
| Metadatos del conector | |
|---|---|
| Publicador | Microsot |
| Website | https://azure.microsoft.com/en-us/services/cognitive-services/question-answering/#overview |
| Directiva de privacidad | https://privacy.microsoft.com/en-us/privacystatement |
| Categorías | IA; Sitio web |
Language: Question Answering Connector es un conector para integrar cualquier aplicación de Power con nuestra nueva característica de respuesta a preguntas dentro del servicio language. Con este conector, los usuarios ahora pueden conectarse a las nuevas características mejoradas de Respuesta a preguntas. Hay acciones en este conector que ayudan a los usuarios a
- Generación de respuestas a partir del proyecto
- Obtener metadatos del proyecto
- Generar respuestas del texto proporcionado durante un período de tiempo, tenemos previsto implementar más acciones para proporcionar más funcionalidades a nuestros clientes.
Prerrequisitos
Siga las instrucciones que se indican aquí para crear un proyecto de respuesta a preguntas personalizado.
Obtención de credenciales
- Después de implementar el proyecto, haga clic en "Obtener dirección URL de predicción".
- Obtenga la dirección URL del sitio del nombre de host de prediction URL y su clave de cuenta, que sería Ocp-Apim-Subscription-Key.
- Cree una conexión mediante la clave de cuenta y la dirección URL del sitio.
Introducción al conector
Uso del conector en un flujo
- Vaya a Microsoft Power Automate y haga clic en Crear y seleccione "Flujo de nube instantánea".
- Para probar este conector, puede hacer clic en "Desencadenar manualmente un flujo" y hacer clic en
Create.
- Haga clic en "Nuevo paso" y busque "Idioma – Respuesta a preguntas" y elija entre las tres acciones.
Acciones:
Generar respuesta a partir de Project
- Esta acción ayuda a responder a la pregunta especificada mediante la base de conocimiento del proyecto.
- Puede proporcionar esta consulta para generar una respuesta a partir de "Sample-project"
- Obtenga más información sobre el cuerpo de la solicitud aquí: Respuesta a preguntas: Obtención de respuestas: API REST (Azure Cognitive Services) | Microsoft Docs
Obtener metadatos del proyecto
- Esta acción ayuda a obtener todos los metadatos del proyecto.
- Asigne el nombre del proyecto para obtener metadatos del proyecto.
Generar respuesta a partir del texto proporcionado
- Esta acción ayuda a responder a la pregunta especificada mediante el texto proporcionado. Para usar solo esta acción, no es necesario habilitar respuesta a preguntas personalizadas en el recurso de lenguaje.
- Esta acción no requiere un proyecto de respuesta a preguntas personalizado. Solo necesita un recurso de lenguaje. Puede crear un recurso de idioma y copiar el punto de conexión y la clave desde Azure Portal, en la sección Claves y punto de conexión, en url del sitio y clave de cuenta, respectivamente.
- Consulta " ¿Cuánto tiempo tarda en cargarse la superficie? " en el texto siguiente: " Alimentación y carga. La batería Surface Pro 4 tarda dos o cuatro horas en cargarse completamente desde un estado vacío. Puede tardar más si usas Surface para actividades que consumen mucha energía, como juegos o streaming de vídeo mientras la
- Obtenga más información sobre el cuerpo de la solicitud aquí: Respuesta a preguntas: Obtención de respuestas de texto: API REST (Azure Cognitive Services) | Microsoft Docs
Respuesta
Generar respuesta a partir de Project
Devolverá una respuesta de "Sample-project" para la pregunta "Accesibilidad". Para más información sobre el objeto de respuesta de esta acción, visite Respuesta a preguntas: Obtener respuestas: API REST (Azure Cognitive Services) | Microsoft Docs
Generar respuesta a partir del texto proporcionado
Extraerá la respuesta de la pregunta del texto especificado. Para más información sobre el objeto de respuesta, visite Respuesta a preguntas: Obtención de respuestas de texto: API REST (Azure Cognitive Services) | Microsoft Docs .
Obtener metadatos del proyecto
Obtiene los metadatos del proyecto solicitado. Para obtener más información sobre el objeto de respuesta, visite Question Answering Projects - Get Project Details - REST API (Azure Cognitive Services) | Microsoft Docs .
Problemas y limitaciones conocidos
No hemos encontrado ninguno, por favor póngase en contacto con nosotros si usted encuentra alguno en qnamakersupport@microsoft.com
Errores y soluciones comunes
Consulte esta documentación: https://docs.microsoft.com/en-us/rest/api/cognitiveservices/questionanswering/question-answering
Preguntas más frecuentes
Consulte esta documentación: https://docs.microsoft.com/en-us/azure/cognitive-services/language-service/question-answering/overview
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Clave de API | ApiKey | Todas las regiones | Compartible |
| Azure AD integrado | Use Azure Active Directory para acceder a Azure Blob Storage. | Todas las regiones | No se puede compartir |
| Valor predeterminado [EN DESUSO] | Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores. | Todas las regiones | No se puede compartir |
Clave de API
Identificador de autenticación: keyBasedAuth
Aplicable: Todas las regiones
ApiKey
Se trata de una conexión que se puede compartir. Si la aplicación de energía se comparte con otro usuario, también se comparte la conexión. Para más información, consulte introducción a los conectores para aplicaciones de lienzo: Power Apps | Microsoft Docs
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Clave de cuenta | securestring | Clave de punto de conexión del recurso de idioma que se va a copiar de Azure Portal | Cierto |
| Dirección URL del sitio | cuerda / cadena | Nombre de host del recurso de idioma que se va a copiar desde Azure Portal | Cierto |
Azure AD integrado
Identificador de autenticación: tokenBasedAuth
Aplicable: Todas las regiones
Use Azure Active Directory para acceder a Azure Blob Storage.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Dirección URL del sitio | cuerda / cadena | Nombre de host del recurso de idioma que se va a copiar desde Azure Portal | Cierto |
Valor predeterminado [EN DESUSO]
Aplicable: Todas las regiones
Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Clave de cuenta | securestring | Clave de punto de conexión del recurso de idioma que se va a copiar de Azure Portal | Cierto |
| Dirección URL del sitio | cuerda / cadena | Nombre de host del recurso de idioma que se va a copiar desde Azure Portal | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Generar respuesta a partir de Project |
Esta acción ayuda a responder a la pregunta especificada mediante la base de conocimiento del proyecto. |
| Generar respuesta a partir del texto proporcionado |
Esta acción ayuda a responder a la pregunta especificada mediante el texto proporcionado. |
| Obtener metadatos del proyecto |
Esta acción ayuda a obtener todos los metadatos del proyecto. |
Generar respuesta a partir de Project
Esta acción ayuda a responder a la pregunta especificada mediante la base de conocimiento del proyecto.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre del proyecto
|
projectName | True | string |
Este es el nombre del proyecto que desea usar. |
|
Pregunta
|
question | True | string |
Pregunta del usuario que se va a consultar en el proyecto. |
|
Id. de usuario
|
userId | string |
Identificador único para el usuario. |
|
|
Arriba #
|
top | integer |
Número máximo de respuestas que se devolverán para la pregunta. |
|
|
Umbral de confianza
|
confidenceScoreThreshold | float |
Puntuación mínima del umbral para las respuestas. El valor oscila entre 0 y 1. |
|
|
Tipo de clasificador
|
rankerType | string |
Tipo de clasificador que se va a usar. |
|
|
Id. de QnA
|
qnaId | string |
Este es el identificador exacto de QnA que se va a capturar del proyecto. |
|
|
Id. de QnA anterior
|
previousQnaId | integer |
Resultado de respuesta superior anterior QnA ID. |
|
|
Consulta de usuario anterior
|
previousUserQuery | string |
Consulta de usuario anterior. |
|
|
key
|
key | string |
Clave de metadatos del diccionario de metadatos usado en QnA. |
|
|
value
|
value | string |
Valor de metadatos del diccionario de metadatos usado en QnA. |
|
|
Combinar metadatos con
|
logicalOperation | string |
Establezca "OR" o "AND" para la operación lógica correspondiente para los filtros de metadatos. |
|
|
Filtro de origen
|
sourceFilter | string |
Busque las entidades de calidad de servicio asociadas a cualquiera de las listas de orígenes especificadas en el proyecto. |
|
|
Combinación de filtros con
|
logicalOperation | string |
Operación lógica que se usa para combinar el filtro de metadatos con el filtro de origen. |
|
|
Habilitación de una respuesta precisa
|
enable | boolean |
Habilite o deshabilite la predicción de intervalo de respuestas. |
|
|
Umbral de confianza
|
confidenceScoreThreshold | float |
Puntuación mínima del umbral necesaria para incluir una respuesta precisa, intervalos de valor comprendidos entre 0 y 1. |
|
|
Arriba #
|
topAnswersWithSpan | integer |
Número de respuestas principales que se deben tener en cuenta para la predicción de respuesta precisa de 1 a 10. |
|
|
Incluir orígenes no estructurados
|
includeUnstructuredSources | boolean |
Marca para habilitar la consulta sobre orígenes no estructurados. |
|
|
Nombre del despliegue
|
deploymentName | True | string |
Esta es la implementación específica del proyecto que desea usar. |
|
Versión de la API
|
api-version | True | string |
Esta es la versión de la API de cliente. |
Devoluciones
Representa la lista de respuestas a preguntas.
- Body
- AnswersResult
Generar respuesta a partir del texto proporcionado
Esta acción ayuda a responder a la pregunta especificada mediante el texto proporcionado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Pregunta
|
question | True | string |
Pregunta del usuario para consultar los registros de texto especificados. |
|
id
|
id | True | string |
Identificador único del registro de texto. |
|
texto
|
text | True | string |
Contenido del texto del registro. |
|
Language
|
language | string |
Idioma de los registros de texto. Esta es la representación BCP-47 de un idioma. |
|
|
Tipo de índice de cadena
|
stringIndexType | string |
Especifica el método utilizado para interpretar los desplazamientos de cadena. El valor predeterminado es Text Elements (Graphemes) según Unicode v8.0.0. Para obtener más información, consulte https://aka.ms/text-analytics-offsets. |
|
|
Versión de la API
|
api-version | True | string |
Esta es la versión de la API de cliente. |
Devoluciones
Representa los resultados de la respuesta.
Obtener metadatos del proyecto
Esta acción ayuda a obtener todos los metadatos del proyecto.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre del proyecto
|
ProjectNamePathParameter | True | string |
Nombre del proyecto que se va a usar. |
|
Versión de la API
|
api-version | True | string |
Esta es la versión de la API de cliente. |
Devoluciones
Representa el proyecto.
- Body
- ProjectMetadata
Definiciones
ProjectMetadata
Representa el proyecto.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
projectName
|
projectName | string |
Nombre del proyecto. |
|
descripción
|
description | string |
Descripción del proyecto. |
|
Language
|
language | Language |
Idioma de los registros de texto. Esta es la representación BCP-47 de un idioma. |
|
defaultAnswer
|
settings.defaultAnswer | string |
Respuesta de respuesta predeterminada cuando no se encuentra ninguna coincidencia correcta en la base de conocimiento. |
|
multilingualResource
|
multilingualResource | boolean |
Recurso habilitado para varios lenguajes entre proyectos o no. |
|
createdDateTime
|
createdDateTime | date-time |
Fecha y hora de creación del proyecto. |
|
lastModifiedDateTime
|
lastModifiedDateTime | date-time |
Representa la fecha y hora de última modificación del proyecto. |
|
lastDeployedDateTime
|
lastDeployedDateTime | date-time |
Representa la última fecha y hora de implementación del proyecto. |
Language
Idioma de los registros de texto. Esta es la representación BCP-47 de un idioma.
Idioma de los registros de texto. Esta es la representación BCP-47 de un idioma.
- Language
- string
AnswersResult
Representa la lista de respuestas a preguntas.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
answers
|
answers | array of KnowledgeBaseAnswer |
Representa la lista de resultados de respuesta. |
|
isUserQuestionAmbiguous
|
isUserQuestionAmbiguous | boolean |
Devuelve un valor booleano si la pregunta del usuario era ambigua. |
KnowledgeBaseAnswer
Representa la respuesta del proyecto.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Preguntas
|
questions | array of string |
Lista de preguntas asociadas a la respuesta. |
|
respuesta
|
answer | string |
Texto de respuesta. |
|
Umbral de confianza
|
confidenceScore | float |
Puntuación de confianza de respuesta, el valor oscila entre 0 y 1. |
|
Id. de QnA
|
id | integer |
Identificador del resultado de QnA. |
|
source
|
source | string |
Origen del resultado de QnA. |
|
metadata
|
metadata | object |
Metadatos asociados a la respuesta, útiles para clasificar o filtrar respuestas a preguntas. |
|
diálogo
|
dialog | KnowledgeBaseAnswerDialog |
Cuadro de diálogo asociado a Answer. |
|
answerSpan
|
answerSpan | AnswerSpan |
Objeto de intervalo de respuestas de QnA. |
KnowledgeBaseAnswerDialog
Cuadro de diálogo asociado a Answer.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
isContextOnly
|
isContextOnly | boolean |
Para marcar si una solicitud solo es relevante con una pregunta anterior o no. Si es true, no incluya este QnA como resultado de búsqueda para las consultas sin contexto; de lo contrario, si es false, omite el contexto e incluye este QnA en el resultado de la búsqueda. |
|
mensajes
|
prompts | array of KnowledgeBaseAnswerPrompt |
Lista de mensajes asociados a la respuesta. |
KnowledgeBaseAnswerPrompt
Solicitar una respuesta.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
displayOrder
|
displayOrder | integer |
Índice del símbolo del sistema: se usa para ordenar las solicitudes. |
|
qnaId
|
qnaId | integer |
Id. de QnA correspondiente al símbolo del sistema. |
|
displayText
|
displayText | string |
Texto que se muestra para representar un mensaje de pregunta de seguimiento. |
AnswerSpan
Objeto de intervalo de respuestas de QnA.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
texto
|
text | string |
Texto previsto de respuesta precisa. |
|
Umbral de confianza
|
confidenceScore | float |
Puntuación de predicción de respuesta precisa, el valor oscila entre 0 y 1. |
|
offset
|
offset | integer |
Desplazamiento preciso de la respuesta desde el inicio de la respuesta. |
|
length
|
length | integer |
Longitud de la respuesta precisa. |
AnswersFromTextResult
Representa los resultados de la respuesta.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
answers
|
answers | array of TextAnswer |
Representa los resultados de la respuesta. |
TextAnswer
Representa el resultado de la respuesta.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
respuesta
|
answer | string |
Texto de respuesta. |
|
Umbral de confianza
|
confidenceScore | float |
Puntuación de confianza de respuesta, el valor oscila entre 0 y 1. |
|
id
|
id | string |
Id. de registro. |
|
answerSpan
|
answerSpan | AnswerSpan |
Objeto de intervalo de respuestas de QnA. |
|
offset
|
offset | integer |
Desplazamiento de oraciones desde el principio del documento. |
|
length
|
length | integer |
Longitud de la oración. |