Língua - Resposta a perguntas
A Language - Question Answering API é um serviço baseado em nuvem que fornece processamento avançado de linguagem natural com modelos de transformadores de última geração para gerar respostas contra projetos personalizados de resposta a perguntas ou texto bruto. A resposta a perguntas é um recurso do serviço Language que é aprimorado a partir do serviço QnA Maker com recursos adicionais, como suporte para documentos não estruturados e respostas precisas.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure China |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Contato | |
|---|---|
| Nome | Suporte de Resposta a Perguntas |
| URL | https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/overview |
| qnamakersupport@microsoft.com |
| Metadados do conector | |
|---|---|
| Editora | Microssoto |
| Sítio Web | https://azure.microsoft.com/en-us/services/cognitive-services/question-answering/#overview |
| Política de privacidade | https://privacy.microsoft.com/en-us/privacystatement |
| Categorias | IA; Sítio Web |
Idioma - O Conector de Resposta a Perguntas é um conector para integrar qualquer aplicativo Power com nosso novo recurso de Resposta a Perguntas no serviço de Idiomas. Com esse conector, os usuários agora podem se conectar aos novos e aprimorados recursos de Resposta a Perguntas. Há ações neste conector que ajudam os usuários a
- Gerar respostas a partir do projeto
- Obter metadados do projeto
- Gerar respostas a partir do texto fornecido Ao longo de um período de tempo, planejamos lançar mais ações para dar mais funcionalidades aos nossos clientes.
Pré-requisitos
Siga as instruções aqui para criar um projeto de resposta a perguntas personalizado.
Como obter credenciais
- Depois de implantar seu projeto, clique em "Obter URL de previsão".
- Obtenha o URL do seu Site a partir do nome de anfitrião do URL de Previsão e da sua chave de Conta que seria a Ocp-Apim-Subscription-Key.
- Crie uma conexão usando sua Chave de Conta e URL do Site.
Introdução ao conector
Usar conector em um fluxo
- Vá para Microsoft Power Automate e clique em Criar e selecione "Instant Cloud flow".
- Para testar este conector, você pode clicar em "Acionar manualmente um fluxo" e clicar em
Create.
- Clique em "Nova etapa" e pesquise "Idioma – Resposta à pergunta" e escolha entre as três ações.
Ações:
Gerar resposta do projeto
- Esta ação ajuda a responder à pergunta especificada usando sua base de conhecimento em seu projeto.
- Você pode dar esta consulta para gerar resposta a partir do seu "Sample-project"
- Saiba mais sobre o corpo da solicitação aqui: Resposta a perguntas - Obter respostas - API REST (Serviços Cognitivos do Azure) | Documentos Microsoft
Obter metadados do projeto
- Esta ação ajuda a obter todos os metadados do seu projeto.
- Dê o nome do seu projeto para obter metadados do seu projeto.
Gerar resposta a partir do texto fornecido
- Esta ação ajuda a responder à pergunta especificada usando o texto fornecido. Para usar apenas essa ação, a Resposta a Perguntas Personalizadas não precisa ser habilitada no recurso Idioma.
- Esta ação não requer um projeto de resposta a perguntas personalizadas. Necessita apenas de um recurso linguístico. Você pode criar um recurso de idioma e copiar seu ponto de extremidade e chave do portal do Azure, na seção Chaves e Ponto de Extremidade, para URL do Site e Chave de Conta, respectivamente.
- Consulta " quanto tempo demora a carregar a superfície? " sobre o seguinte texto: " Potência e carregamento. Demora duas a quatro horas a carregar totalmente a bateria do Surface Pro 4 a partir de um estado vazio. Pode demorar mais tempo se estiver a utilizar o Surface para atividades que consomem muita energia, como jogos ou streaming de vídeo, enquanto o carrega "
- Saiba mais sobre o corpo da solicitação aqui: Resposta a perguntas - Obter respostas de texto - API REST (Serviços Cognitivos do Azure) | Documentos Microsoft
Resposta
Gerar resposta do projeto
Ele retornará uma resposta do seu "Projeto de amostra" para a pergunta "Acessibilidade". Para saber mais sobre o objeto de resposta para esta ação, visite Resposta a perguntas - Obter respostas - API REST (Serviços Cognitivos do Azure) | Documentos Microsoft
Gerar resposta a partir do texto fornecido
Ele irá extrair a resposta para a sua pergunta do texto dado. Para saber mais sobre o objeto de resposta, visite Resposta a perguntas - Obter respostas de texto - API REST (Serviços Cognitivos do Azure) | Documentos da Microsoft .
Obter metadados do projeto
Ele obtém os metadados do projeto solicitado. Para saber mais sobre o objeto de resposta, visite Projetos de resposta a perguntas - Obter detalhes do projeto - API REST (Serviços Cognitivos do Azure) | Documentos da Microsoft .
Problemas conhecidos e limitações
Nós não encontramos nenhum, por favor, entre em contato conosco se você encontrar algum em qnamakersupport@microsoft.com
Erros e soluções comuns
Consulte esta documentação: https://docs.microsoft.com/en-us/rest/api/cognitiveservices/questionanswering/question-answering
FAQ
Consulte esta documentação: https://docs.microsoft.com/en-us/azure/cognitive-services/language-service/question-answering/overview
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Chave Api | ApiKey | Todas as regiões | Compartilhável |
| Azure AD Integrado | Use o Azure Ative Directory para acessar seu Armazenamento de Blob do Azure. | Todas as regiões | Não compartilhável |
| Padrão [DEPRECATED] | Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores. | Todas as regiões | Não compartilhável |
Chave Api
ID de autenticação: keyBasedAuth
Aplicável: Todas as regiões
ApiKey
Esta é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a Visão geral de conectores para aplicativos de tela - Power Apps | Documentos Microsoft
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave da conta | securestring | A chave de ponto de extremidade para seu recurso de idioma a ser copiado do portal do Azure | Verdade |
| Site URL | cadeia (de caracteres) | Nome do host do seu recurso de idioma a ser copiado do portal do Azure | Verdade |
Azure AD Integrado
ID de autenticação: tokenBasedAuth
Aplicável: Todas as regiões
Use o Azure Ative Directory para acessar seu Armazenamento de Blob do Azure.
Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Site URL | cadeia (de caracteres) | Nome do host do seu recurso de idioma a ser copiado do portal do Azure | Verdade |
Padrão [DEPRECATED]
Aplicável: Todas as regiões
Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.
Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave da conta | securestring | A chave de ponto de extremidade para seu recurso de idioma a ser copiado do portal do Azure | Verdade |
| Site URL | cadeia (de caracteres) | Nome do host do seu recurso de idioma a ser copiado do portal do Azure | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Gerar resposta a partir do texto fornecido |
Esta ação ajuda a responder à pergunta especificada usando o texto fornecido. |
| Gerar resposta do Project |
Esta ação ajuda a responder à pergunta especificada usando sua base de conhecimento em seu projeto. |
| Obter metadados do projeto |
Esta ação ajuda a obter todos os metadados do seu projeto. |
Gerar resposta a partir do texto fornecido
Esta ação ajuda a responder à pergunta especificada usando o texto fornecido.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Question
|
question | True | string |
Pergunta do usuário para consultar os registros de texto fornecidos. |
|
id
|
id | True | string |
Identificador exclusivo para o registro de texto. |
|
enviar SMS
|
text | True | string |
Conteúdo do texto do registo. |
|
Linguagem
|
language | string |
Língua dos registos de texto. Esta é a representação BCP-47 de uma língua. |
|
|
Tipo de índice de cadeia de caracteres
|
stringIndexType | string |
Especifica o método usado para interpretar deslocamentos de cadeia de caracteres. O padrão é Elementos de texto (grafemas) de acordo com Unicode v8.0.0. Para obter informações adicionais, consulte https://aka.ms/text-analytics-offsets. |
|
|
Versão da API
|
api-version | True | string |
Esta é a versão da API do cliente. |
Devoluções
Representa os resultados da resposta.
Gerar resposta do Project
Esta ação ajuda a responder à pergunta especificada usando sua base de conhecimento em seu projeto.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do Projeto
|
projectName | True | string |
Este é o nome do projeto que você deseja usar. |
|
Question
|
question | True | string |
Pergunta do usuário para consultar o projeto. |
|
ID de utilizador
|
userId | string |
Identificador exclusivo para o usuário. |
|
|
Início #
|
top | integer |
Número máximo de respostas a devolver para a pergunta. |
|
|
Limiar de Confiança
|
confidenceScoreThreshold | float |
Pontuação mínima para as respostas. O valor varia de 0 a 1. |
|
|
Tipo de ranker
|
rankerType | string |
Tipo de ranker a utilizar. |
|
|
QnA ID
|
qnaId | string |
Este é o ID QnA exato para buscar no projeto. |
|
|
ID QnA anterior
|
previousQnaId | integer |
Resultado anterior da resposta QnA ID. |
|
|
Consulta de usuário anterior
|
previousUserQuery | string |
Consulta de usuário anterior. |
|
|
chave
|
key | string |
Chave de metadados do dicionário de metadados usado no QnA. |
|
|
valor
|
value | string |
Metadata Value do dicionário de metadados usado no QnA. |
|
|
Junte-se a metadados com
|
logicalOperation | string |
Defina 'OR' ou 'AND' para a operação lógica correspondente para filtros de metadados. |
|
|
Filtro de origem
|
sourceFilter | string |
Encontre QnAs que estão associados a qualquer uma das fontes fornecidas no projeto. |
|
|
Junte filtros com
|
logicalOperation | string |
Operação lógica usada para unir o filtro de metadados com o filtro de origem. |
|
|
Permitir uma resposta precisa
|
enable | boolean |
Habilite ou desabilite a previsão de Extensão de Resposta. |
|
|
Limiar de Confiança
|
confidenceScoreThreshold | float |
Pontuação mínima necessária para incluir uma resposta precisa, o valor varia de 0 a 1. |
|
|
Início #
|
topAnswersWithSpan | integer |
Número de respostas principais a serem consideradas para a previsão precisa de respostas de 1 a 10. |
|
|
Incluir fontes não estruturadas
|
includeUnstructuredSources | boolean |
Sinalizador para habilitar a consulta sobre fontes não estruturadas. |
|
|
Nome da implantação
|
deploymentName | True | string |
Esta é a implantação específica do projeto que você deseja usar. |
|
Versão da API
|
api-version | True | string |
Esta é a versão da API do cliente. |
Devoluções
Representa a lista de respostas às perguntas.
- Body
- AnswersResult
Obter metadados do projeto
Esta ação ajuda a obter todos os metadados do seu projeto.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do Projeto
|
ProjectNamePathParameter | True | string |
O nome do projeto a ser usado. |
|
Versão da API
|
api-version | True | string |
Esta é a versão da API do cliente. |
Devoluções
Representa o projeto.
- Body
- ProjectMetadata
Definições
Metadados do Projeto
Representa o projeto.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
nome_do_projeto
|
projectName | string |
Nome do projeto. |
|
descrição
|
description | string |
Descrição do projeto. |
|
Linguagem
|
language | Language |
Língua dos registos de texto. Esta é a representação BCP-47 de uma língua. |
|
defaultAnswer
|
settings.defaultAnswer | string |
Resposta de resposta padrão quando nenhuma boa correspondência é encontrada na Base de conhecimento. |
|
multilingueRecurso
|
multilingualResource | boolean |
Recurso habilitado para vários idiomas em projetos ou não. |
|
createdDateTime
|
createdDateTime | date-time |
Data-hora de criação do projeto. |
|
lastModifiedDateTime
|
lastModifiedDateTime | date-time |
Representa a data-hora da última modificação do projeto. |
|
lastDeployedDateTime
|
lastDeployedDateTime | date-time |
Representa a data-hora da última implantação do projeto. |
Linguagem
Língua dos registos de texto. Esta é a representação BCP-47 de uma língua.
Língua dos registos de texto. Esta é a representação BCP-47 de uma língua.
- Linguagem
- string
RespostasResultado
Representa a lista de respostas às perguntas.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
answers
|
answers | array of KnowledgeBaseAnswer |
Representa a lista Resultado da Resposta. |
|
isUserQuestionAmbiguous
|
isUserQuestionAmbiguous | boolean |
Retorna um valor booleano se a pergunta do usuário for ambígua. |
KnowledgeBaseAnswer
Representa a resposta do projeto.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
perguntas
|
questions | array of string |
Lista de perguntas associadas à resposta. |
|
resposta
|
answer | string |
Texto da resposta. |
|
Limiar de Confiança
|
confidenceScore | float |
Pontuação de confiança da resposta, o valor varia de 0 a 1. |
|
QnA ID
|
id | integer |
ID do resultado do QnA. |
|
origem
|
source | string |
Fonte do resultado QnA. |
|
metadados
|
metadata | object |
Metadados associados à resposta, úteis para categorizar ou filtrar respostas a perguntas. |
|
diálogo
|
dialog | KnowledgeBaseAnswerDialog |
Caixa de diálogo associada à Resposta. |
|
answerSpan
|
answerSpan | AnswerSpan |
Objeto de extensão de resposta do QnA. |
KnowledgeBaseAnswerDialog
Caixa de diálogo associada à Resposta.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
isContextOnly
|
isContextOnly | boolean |
Para marcar se um prompt é relevante apenas com uma pergunta anterior ou não. Se verdadeiro, não inclua este QnA como resultado de pesquisa para consultas sem contexto; caso contrário, se false, ignora o contexto e inclui este QnA no resultado da pesquisa. |
|
Prompts
|
prompts | array of KnowledgeBaseAnswerPrompt |
Lista de prompts associados à resposta. |
KnowledgeBaseAnswerPrompt
Solicite uma resposta.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
displayEncomendar
|
displayOrder | integer |
Índice do prompt - usado na ordenação dos prompts. |
|
qnaId
|
qnaId | integer |
ID QnA correspondente ao prompt. |
|
displayText
|
displayText | string |
Texto exibido para representar um prompt de pergunta de acompanhamento. |
AnswerSpan
Objeto de extensão de resposta do QnA.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
enviar SMS
|
text | string |
Texto previsto de resposta precisa. |
|
Limiar de Confiança
|
confidenceScore | float |
Pontuação prevista de resposta precisa, o valor varia de 0 a 1. |
|
offset
|
offset | integer |
A resposta precisa desloca-se desde o início da resposta. |
|
length
|
length | integer |
A extensão da resposta precisa. |
AnswersFromTextResult
Representa os resultados da resposta.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
answers
|
answers | array of TextAnswer |
Representa os resultados da resposta. |
TextAnswer
Representa o resultado da resposta.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
resposta
|
answer | string |
Texto da resposta. |
|
Limiar de Confiança
|
confidenceScore | float |
Pontuação de confiança da resposta, o valor varia de 0 a 1. |
|
id
|
id | string |
ID do registo. |
|
answerSpan
|
answerSpan | AnswerSpan |
Objeto de extensão de resposta do QnA. |
|
offset
|
offset | integer |
A frase deslocada desde o início do documento. |
|
length
|
length | integer |
A duração da frase. |