Question Answering - Get Answers
Responde a la pregunta especificada mediante el knowledge base.
POST {Endpoint}/language/:query-knowledgebases?projectName={projectName}&deploymentName={deploymentName}&api-version=2021-10-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
Endpoint
|
path | True |
string |
Punto de conexión de Cognitive Services compatible (por ejemplo, https://.api.cognitiveservices.azure.com). |
api-version
|
query | True |
string |
Versión de API del cliente. |
deployment
|
query | True |
string |
Nombre de la implementación específica del proyecto que se va a usar. |
project
|
query | True |
string |
Nombre del proyecto que se va a usar. |
Encabezado de la solicitud
Nombre | Requerido | Tipo | Description |
---|---|---|---|
Ocp-Apim-Subscription-Key | True |
string |
Cuerpo de la solicitud
Nombre | Tipo | Description |
---|---|---|
answerSpanRequest |
Para configurar la característica de predicción de intervalo de respuestas. |
|
confidenceScoreThreshold |
number |
Puntuación de umbral mínima para las respuestas, el valor oscila entre 0 y 1. |
context |
Objeto de contexto con la información de QnA anterior. |
|
filters |
Filtre las preguntas y respuestas según la lista de metadatos y los orígenes de knowledge base especificados. |
|
includeUnstructuredSources |
boolean |
(Opcional) Marca para habilitar la consulta sobre orígenes no estructurados. |
qnaId |
integer |
Identificador exacto de QnA que se va a capturar del knowledge base, este campo tiene prioridad sobre la pregunta. |
question |
string |
Pregunta del usuario para consultar en el knowledge base. |
rankerType |
Tipo de clasificador que se va a usar. |
|
top |
integer |
Número máximo de respuestas que se devolverán para la pregunta. |
userId |
string |
Identificador único del usuario. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Una respuesta correcta para obtener respuestas de knowledge base. |
|
Other Status Codes |
Respuesta de error. |
Seguridad
Ocp-Apim-Subscription-Key
Type:
apiKey
In:
header
Ejemplos
Successful query
Sample Request
POST {Endpoint}/language/:query-knowledgebases?projectName=proj1&deploymentName=production&api-version=2021-10-01
{
"question": "how long it takes to charge surface?",
"top": 3,
"userId": "sd53lsY=",
"confidenceScoreThreshold": 0.2,
"context": {
"previousQnaId": 9,
"previousUserQuery": "Where are QnA Maker quickstarts?"
},
"rankerType": "Default",
"filters": {
"metadataFilter": {
"metadata": [
{
"key": "category",
"value": "api"
},
{
"key": "editorial",
"value": "chitchat"
}
],
"logicalOperation": "AND"
},
"sourceFilter": [
"filename1.pdf",
"https://www.wikipedia.org/microsoft"
],
"logicalOperation": "AND"
},
"answerSpanRequest": {
"enable": true,
"confidenceScoreThreshold": 0.2,
"topAnswersWithSpan": 1
},
"includeUnstructuredSources": true
}
Sample Response
{
"answers": [
{
"questions": [
"Power and charging"
],
"answer": "Power and charging**\n\nIt takes two to four hours to charge the Surface Pro 4 battery fully from an empty state. It can take longer if you’re using your Surface for power-intensive activities like gaming or video streaming while you’re charging it.\n\nYou can use the USB port on your Surface Pro 4 power supply to charge other devices, like a phone, while your Surface charges. The USB port on the power supply is only for charging, not for data transfer. If you want to use a USB device, plug it into the USB port on your Surface.",
"confidenceScore": 0.65,
"id": 20,
"source": "surface-pro-4-user-guide-EN.pdf",
"metadata": {
"category": "api",
"editorial": "chitchat"
},
"dialog": {
"isContextOnly": false,
"prompts": [
{
"displayOrder": 1,
"qnaId": 23,
"displayText": "prompt1"
},
{
"displayOrder": 2,
"qnaId": 36,
"displayText": "prompt2"
}
]
},
"answerSpan": {
"text": "two to four hours",
"confidenceScore": 0.3,
"offset": 33,
"length": 50
}
},
{
"questions": [
"Charge your Surface Pro 4"
],
"answer": "**Charge your Surface Pro 4**\n\n1. Connect the two parts of the power cord.\n\n2. Connect the power cord securely to the charging port.\n\n3. Plug the power supply into an electrical outlet.",
"confidenceScore": 0.32,
"id": 13,
"source": "surface-pro-4-user-guide-EN.pdf"
}
]
}
Definiciones
Nombre | Description |
---|---|
Answers |
Parámetros para consultar un knowledge base. |
Answer |
Objeto de intervalo de respuestas de QnA. |
Answers |
Representa la lista de respuestas a preguntas. |
enable |
Habilite o deshabilite la predicción de Intervalo de respuestas. |
Error |
Objeto de error. |
Error |
Código de error legible. |
Error |
Respuesta de error. |
Inner |
Código de error legible. |
Inner |
Objeto que contiene información más específica sobre el error. Según las directrices de la API de Microsoft One: https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses. |
Knowledge |
Representa knowledge base respuesta. |
Knowledge |
Objeto de contexto con la información de QnA anterior. |
Knowledge |
Cuadro de diálogo asociado a Answer. |
Knowledge |
Solicite una respuesta. |
Logical |
Establezca en "OR" o "AND" para usar la operación lógica correspondiente. |
Metadata |
Busque las preguntas y respuestas asociadas a la lista de metadatos especificada. |
Metadata |
Objeto para proporcionar el par clave-valor para cada metadato. |
Query |
filtra por knowledge base. |
Ranker |
Tipo de clasificador que se va a usar. |
Short |
Para configurar la característica de predicción de intervalo de respuestas. |
AnswersOptions
Parámetros para consultar un knowledge base.
Nombre | Tipo | Description |
---|---|---|
answerSpanRequest |
Para configurar la característica de predicción de intervalo de respuestas. |
|
confidenceScoreThreshold |
number |
Puntuación de umbral mínima para las respuestas, el valor oscila entre 0 y 1. |
context |
Objeto de contexto con la información de QnA anterior. |
|
filters |
Filtre las preguntas y respuestas según la lista de metadatos y los orígenes de knowledge base especificados. |
|
includeUnstructuredSources |
boolean |
(Opcional) Marca para habilitar la consulta sobre orígenes no estructurados. |
qnaId |
integer |
Identificador exacto de QnA que se va a capturar del knowledge base, este campo tiene prioridad sobre la pregunta. |
question |
string |
Pregunta del usuario para consultar en el knowledge base. |
rankerType |
Tipo de clasificador que se va a usar. |
|
top |
integer |
Número máximo de respuestas que se devolverán para la pregunta. |
userId |
string |
Identificador único del usuario. |
AnswerSpan
Objeto de intervalo de respuestas de QnA.
Nombre | Tipo | Description |
---|---|---|
confidenceScore |
number |
Puntuación de predicción del intervalo de respuestas, intervalos de valor de 0 a 1. |
length |
integer |
Longitud del intervalo de respuesta. |
offset |
integer |
Desplazamiento del intervalo de respuesta desde el principio de la respuesta. |
text |
string |
Texto previsto del intervalo de respuestas. |
AnswersResult
Representa la lista de respuestas a preguntas.
Nombre | Tipo | Description |
---|---|---|
answers |
Representa la lista de resultados de respuesta. |
enable
Habilite o deshabilite la predicción de Intervalo de respuestas.
Nombre | Tipo | Description |
---|---|---|
True |
Boolean |
Error
Objeto de error.
Nombre | Tipo | Description |
---|---|---|
code |
Uno de los conjuntos de códigos de error definidos por el servidor. |
|
details |
Error[] |
Matriz de detalles sobre errores específicos que llevaron a este error notificado. |
innererror |
Objeto que contiene información más específica que el objeto actual sobre el error. |
|
message |
string |
Representación legible del error. |
target |
string |
Destino del error. |
ErrorCode
Código de error legible.
Nombre | Tipo | Description |
---|---|---|
AzureCognitiveSearchIndexLimitReached |
string |
|
AzureCognitiveSearchIndexNotFound |
string |
|
AzureCognitiveSearchNotFound |
string |
|
AzureCognitiveSearchThrottling |
string |
|
Forbidden |
string |
|
InternalServerError |
string |
|
InvalidArgument |
string |
|
InvalidRequest |
string |
|
NotFound |
string |
|
OperationNotFound |
string |
|
ProjectNotFound |
string |
|
ServiceUnavailable |
string |
|
TooManyRequests |
string |
|
Unauthorized |
string |
ErrorResponse
Respuesta de error.
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
InnerErrorCode
Código de error legible.
Nombre | Tipo | Description |
---|---|---|
AzureCognitiveSearchNotFound |
string |
|
AzureCognitiveSearchThrottling |
string |
|
ExtractionFailure |
string |
|
InvalidParameterValue |
string |
|
InvalidRequest |
string |
|
KnowledgeBaseNotFound |
string |
InnerErrorModel
Objeto que contiene información más específica sobre el error. Según las directrices de la API de Microsoft One: https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
Nombre | Tipo | Description |
---|---|---|
code |
Uno de los conjuntos de códigos de error definidos por el servidor. |
|
details |
object |
Detalles del error. |
innererror |
Objeto que contiene información más específica que el objeto actual sobre el error. |
|
message |
string |
Mensaje de error. |
target |
string |
Destino de error. |
KnowledgeBaseAnswer
Representa knowledge base respuesta.
Nombre | Tipo | Description |
---|---|---|
answer |
string |
Texto de respuesta. |
answerSpan |
Responda al objeto span de QnA con respecto a la pregunta del usuario. |
|
confidenceScore |
number |
Puntuación de confianza de respuesta, el valor oscila entre 0 y 1. |
dialog |
Cuadro de diálogo asociado a Answer. |
|
id |
integer |
Id. del resultado de QnA. |
metadata |
object |
Metadatos asociados a la respuesta, útiles para clasificar o filtrar respuestas a preguntas. |
questions |
string[] |
Lista de preguntas asociadas a la respuesta. |
source |
string |
Origen del resultado de QnA. |
KnowledgeBaseAnswerContext
Objeto de contexto con la información de QnA anterior.
Nombre | Tipo | Description |
---|---|---|
previousQnaId |
integer |
Id. de respuesta de QnA del turno superior anterior. |
previousUserQuery |
string |
Consulta de usuario anterior. |
KnowledgeBaseAnswerDialog
Cuadro de diálogo asociado a Answer.
Nombre | Tipo | Description |
---|---|---|
isContextOnly |
boolean |
Para marcar si una solicitud solo es relevante con una pregunta anterior o no. Si es true, no incluya esta QnA como resultado de búsqueda para consultas sin contexto; de lo contrario, si es false, omite el contexto e incluye este QnA en el resultado de la búsqueda. |
prompts |
Lista de mensajes asociados a la respuesta. |
KnowledgeBaseAnswerPrompt
Solicite una respuesta.
Nombre | Tipo | Description |
---|---|---|
displayOrder |
integer |
Índice del símbolo del sistema: se usa para ordenar las solicitudes. |
displayText |
string |
Texto que se muestra para representar un aviso de preguntas de seguimiento. |
qnaId |
integer |
Id. de QnA correspondiente al símbolo del sistema. |
LogicalOperationKind
Establezca en "OR" o "AND" para usar la operación lógica correspondiente.
Nombre | Tipo | Description |
---|---|---|
AND |
string |
|
OR |
string |
MetadataFilter
Busque las preguntas y respuestas asociadas a la lista de metadatos especificada.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
logicalOperation | AND |
Operación usada para combinar filtros de metadatos. |
|
metadata |
Objeto para proporcionar el par clave-valor para cada metadato. |
MetadataRecord
Objeto para proporcionar el par clave-valor para cada metadato.
Nombre | Tipo | Description |
---|---|---|
key |
string |
Clave de metadatos del diccionario de metadatos usado en la QnA. |
value |
string |
Valor de metadatos del diccionario de metadatos usado en la QnA. |
QueryFilters
filtra por knowledge base.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
logicalOperation | AND |
Operación lógica que se usa para combinar el filtro de metadatos con el filtro de origen. |
|
metadataFilter |
Busque las preguntas y respuestas asociadas a la lista de metadatos especificada. |
||
sourceFilter |
string[] |
Busque preguntas y respuestas asociadas a cualquiera de las listas de orígenes especificadas en knowledge base. |
RankerKind
Tipo de clasificador que se va a usar.
Nombre | Tipo | Description |
---|---|---|
Default |
string |
Clasificador predeterminado. |
QuestionOnly |
string |
Solo clasificador de preguntas. |
ShortAnswerOptions
Para configurar la característica de predicción de intervalo de respuestas.
Nombre | Tipo | Description |
---|---|---|
confidenceScoreThreshold |
number |
Puntuación de umbral mínima necesaria para incluir un intervalo de respuesta, intervalos de valor de 0 a 1. |
enable |
Habilite o deshabilite la predicción de Intervalo de respuestas. |
|
topAnswersWithSpan |
integer |
Número de principales respuestas que se deben tener en cuenta para la predicción de intervalos de 1 a 10. |