Idioma – Resposta a perguntas
A API de Linguagem – Resposta a Perguntas é um serviço baseado em nuvem que fornece processamento avançado de linguagem natural com modelos de transformador de última geração para gerar respostas contra projetos de resposta de perguntas personalizadas ou texto bruto. A resposta a perguntas é um recurso no serviço de linguagem que é aprimorado a partir do serviço QnA Maker com recursos adicionais, como suporte para documentos não estruturados e respostas precisas.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: - Regiões do Azure China |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Contato | |
|---|---|
| Nome | Suporte à resposta a perguntas |
| URL | https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/overview |
| qnamakersupport@microsoft.com |
| Metadados do conector | |
|---|---|
| Publicador | Microsot |
| Site | 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; Site |
Idioma – Conector de Resposta a Perguntas é um conector para integrar qualquer aplicativo Power ao nosso novo recurso de Resposta a Perguntas no serviço de Linguagem. Com esse conector, os usuários agora podem se conectar aos novos, bem como recursos aprimorados de Resposta a Perguntas. Há ações neste conector que ajudam os usuários a
- Gerar respostas do projeto
- Obter metadados do projeto
- Gerar respostas do texto fornecido durante um período de tempo, planejamos implementar 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 personalizadas.
Como obter credenciais
- Depois de implantar seu projeto, clique em "Obter URL de Previsão".
- Obtenha a URL do site do nome do host da URL de Previsão e sua chave de conta, que seria o Ocp-Apim-Subscription-Key.
de - Crie uma conexão usando a Chave de Conta e a URL do Site.
Introdução ao conector
Usar o Conector em um fluxo
- Acesse o Microsoft Power Automate e clique em Criar e selecione "Fluxo de Nuvem Instantânea".
Criar - Para testar esse conector, você pode clicar em "Disparar manualmente um fluxo" e clicar em
Create.
- Clique em "Nova Etapa" e pesquise "Idioma – Resposta a Perguntas" e escolha entre as três ações.
Ações:
Gerar resposta do Project
- Essa ação ajuda a responder à pergunta especificada usando sua base de dados de conhecimento em seu projeto.
- Você pode fornecer essa consulta para gerar resposta do seu projeto de "
- Saiba mais sobre o corpo da solicitação aqui: Resposta a perguntas – Obter respostas – API REST (Serviços Cognitivos do Azure) | Microsoft Docs
Obter metadados do projeto
- Essa ação ajuda a obter todos os metadados do seu projeto.
- Dê o nome do projeto para obter metadados do seu projeto.
Gerar resposta do texto fornecido
- Essa ação ajuda a responder à pergunta especificada usando o texto fornecido. Para usar somente essa ação, a Resposta a Perguntas Personalizadas não precisa ser habilitada no recurso De linguagem.
- Essa ação não requer um projeto de resposta a perguntas personalizadas. Ele só precisa de um recurso de linguagem. Você pode criar um recurso de idioma e copiar o ponto de extremidade e a chave do portal do Azure, na seção Chaves e Ponto de Extremidade, para a URL do Site e a Chave da Conta, respectivamente.
- Consulta " quanto tempo leva para carregar a superfície? " no seguinte texto: " Energia e carregamento. Leva de duas a quatro horas para carregar a bateria do Surface Pro 4 totalmente de um estado vazio. Pode levar mais tempo se você estiver usando o Surface para atividades com uso intensivo de energia, como jogos ou streaming de vídeo, enquanto você o carrega "
- Saiba mais sobre o corpo da solicitação a partir daqui: Respostas a perguntas – Obter respostas de texto – API REST (Serviços Cognitivos do Azure) | Microsoft Docs
Resposta
Gerar resposta do Project
Ele retornará uma resposta de seu "Projeto de exemplo" para a pergunta "Acessibilidade". Para saber mais sobre o objeto de resposta dessa ação, visite Respostas a Perguntas – Obter Respostas – API REST (Serviços Cognitivos do Azure) | Microsoft Docs
Gerar resposta com base no texto fornecido
Ele extrairá a resposta para sua pergunta do texto especificado. Para saber mais sobre o objeto de resposta, visite Responder perguntas – Obter respostas de texto – API REST (Serviços Cognitivos do Azure) | Microsoft Docs .
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) | Microsoft Docs .
Problemas e limitações conhecidos
Nós não encontramos nenhum, por favor, entre em contato conosco se você encontrar qualquer 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
perguntas frequentes
Consulte esta documentação: https://docs.microsoft.com/en-us/azure/cognitive-services/language-service/question-answering/overview
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Chave de API | ApiKey | Todas as regiões | Compartilhável |
| Integrado ao Azure AD | Use o Azure Active Directory para acessar o Armazenamento de Blobs do Azure. | Todas as regiões | Não compartilhável |
| Padrão [PRETERIDO] | Essa 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 de API
ID de autenticação: keyBasedAuth
Aplicável: todas as regiões
ApiKey
Essa é 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 dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave de Conta | secureString | A chave de ponto de extremidade para o recurso de idioma a ser copiado do portal do Azure | Verdade |
| URL do site | cadeia | Nome do host do recurso de idioma a ser copiado do portal do Azure | Verdade |
Integrado ao Azure AD
ID de autenticação: tokenBasedAuth
Aplicável: todas as regiões
Use o Azure Active Directory para acessar o Armazenamento de Blobs do Azure.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| URL do site | cadeia | Nome do host do recurso de idioma a ser copiado do portal do Azure | Verdade |
Padrão [PRETERIDO]
Aplicável: todas as regiões
Essa 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.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave de Conta | secureString | A chave de ponto de extremidade para o recurso de idioma a ser copiado do portal do Azure | Verdade |
| URL do site | cadeia | Nome do host do recurso de idioma a ser copiado do portal do Azure | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Gerar resposta do Project |
Essa ação ajuda a responder à pergunta especificada usando sua base de dados de conhecimento em seu projeto. |
| Gerar resposta do texto fornecido |
Essa ação ajuda a responder à pergunta especificada usando o texto fornecido. |
| Obter metadados do projeto |
Essa ação ajuda a obter todos os metadados do seu projeto. |
Gerar resposta do Project
Essa ação ajuda a responder à pergunta especificada usando sua base de dados de conhecimento em seu projeto.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do Projeto
|
projectName | True | string |
Este é o nome do Projeto que você deseja usar. |
|
Pergunta
|
question | True | string |
Pergunta do usuário a ser consultada no projeto. |
|
ID do Usuário
|
userId | string |
Identificador exclusivo do usuário. |
|
|
Início #
|
top | integer |
Número máximo de respostas a serem retornadas para a pergunta. |
|
|
Limite de confiança
|
confidenceScoreThreshold | float |
Pontuação mínima de limite para respostas. O valor varia de 0 a 1. |
|
|
Tipo de classificador
|
rankerType | string |
Tipo de classificador a ser usado. |
|
|
QnA ID
|
qnaId | string |
Esta é a ID de QnA exata a ser buscada do projeto. |
|
|
ID anterior do QnA
|
previousQnaId | integer |
A ID de QnA do resultado da resposta superior da curva anterior. |
|
|
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. |
|
|
value
|
value | string |
Valor de metadados do dicionário de metadados usado no QnA. |
|
|
Ingressar metadados com
|
logicalOperation | string |
Defina 'OR' ou 'AND' para a operação lógica correspondente para filtros de metadados. |
|
|
Filtro de origem
|
sourceFilter | string |
Localize QnAs associadas a qualquer uma das fontes fornecidas no projeto. |
|
|
Unir filtros com
|
logicalOperation | string |
Operação lógica usada para unir o filtro de metadados com o filtro de origem. |
|
|
Habilitar resposta precisa
|
enable | boolean |
Habilitar ou desabilitar a previsão do Período de Resposta. |
|
|
Limite de confiança
|
confidenceScoreThreshold | float |
A pontuação mínima de limite 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 de resposta precisa de 1 a 10. |
|
|
Incluir fontes não estruturadas
|
includeUnstructuredSources | boolean |
Sinalizador para habilitar a consulta em 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. |
Retornos
Representa a lista de respostas a perguntas.
- Corpo
- AnswersResult
Gerar resposta do texto fornecido
Essa ação ajuda a responder à pergunta especificada usando o texto fornecido.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Pergunta
|
question | True | string |
Pergunta do usuário para consultar os registros de texto especificados. |
|
id
|
id | True | string |
Identificador exclusivo para o registro de texto. |
|
enviar SMS
|
text | True | string |
Conteúdo de texto do registro. |
|
Linguagem
|
language | string |
Idioma dos registros de texto. Esta é a representação BCP-47 de um idioma. |
|
|
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 (Graphemes) 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. |
Retornos
Representa os resultados da resposta.
- Corpo
- AnswersFromTextResult
Obter metadados do projeto
Essa ação ajuda a obter todos os metadados do seu projeto.
Parâmetros
| Nome | Chave | Obrigató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. |
Retornos
Representa o projeto.
- Corpo
- ProjectMetadata
Definições
ProjectMetadata
Representa o projeto.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
projectName
|
projectName | string |
Nome do projeto. |
|
descrição
|
description | string |
Descrição do projeto. |
|
Linguagem
|
language | Language |
Idioma dos registros de texto. Esta é a representação BCP-47 de um idioma. |
|
defaultAnswer
|
settings.defaultAnswer | string |
Resposta padrão quando nenhuma correspondência boa é encontrada na Base de Dados de Conhecimento. |
|
multilingualResource
|
multilingualResource | boolean |
Recurso habilitado para vários idiomas em projetos ou não. |
|
createdDateTime
|
createdDateTime | date-time |
Data e 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 e hora da última implantação do projeto. |
Linguagem
Idioma dos registros de texto. Esta é a representação BCP-47 de um idioma.
Idioma dos registros de texto. Esta é a representação BCP-47 de um idioma.
- Linguagem
- string
AnswersResult
Representa a lista de respostas a perguntas.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
respostas
|
answers | array of KnowledgeBaseAnswer |
Representa a lista de resultados da resposta. |
|
isUserQuestionAmbiguous
|
isUserQuestionAmbiguous | boolean |
Retorna um valor booliano se a pergunta do usuário for ambígua. |
KnowledgeBaseAnswer
Representa a resposta do projeto.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Perguntas
|
questions | array of string |
Lista de perguntas associadas à resposta. |
|
responder
|
answer | string |
Texto da resposta. |
|
Limite de confiança
|
confidenceScore | float |
Pontuação de confiança de resposta, o valor varia de 0 a 1. |
|
QnA ID
|
id | integer |
ID do resultado do QnA. |
|
fonte
|
source | string |
Origem do resultado de QnA. |
|
metadados
|
metadata | object |
Metadados associados à resposta, úteis para categorizar ou filtrar respostas de pergunta. |
|
diálogo
|
dialog | KnowledgeBaseAnswerDialog |
Caixa de diálogo associada à Resposta. |
|
answerSpan
|
answerSpan | AnswerSpan |
Objeto de intervalo de resposta do QnA. |
KnowledgeBaseAnswerDialog
Caixa de diálogo associada à Resposta.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
isContextOnly
|
isContextOnly | boolean |
Para marcar se um prompt é relevante apenas com uma pergunta anterior ou não. Se for true, não inclua este QnA como resultado da pesquisa para consultas sem contexto; caso contrário, se for falso, ignorará o contexto e incluirá esse QnA no resultado da pesquisa. |
|
prompts
|
prompts | array of KnowledgeBaseAnswerPrompt |
Lista de prompts associados à resposta. |
KnowledgeBaseAnswerPrompt
Solicite uma resposta.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
displayOrder
|
displayOrder | integer |
Índice do prompt – usado na ordenação dos prompts. |
|
qnaId
|
qnaId | integer |
ID de QnA correspondente ao prompt. |
|
displayText
|
displayText | string |
Texto exibido para representar um prompt de pergunta de acompanhamento. |
AnswerSpan
Objeto de intervalo de resposta do QnA.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
enviar SMS
|
text | string |
Texto previsto de resposta precisa. |
|
Limite de confiança
|
confidenceScore | float |
A pontuação prevista de resposta precisa varia de 0 a 1. |
|
deslocamento
|
offset | integer |
O deslocamento preciso da resposta desde o início da resposta. |
|
length
|
length | integer |
O comprimento da resposta precisa. |
AnswersFromTextResult
Representa os resultados da resposta.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
respostas
|
answers | array of TextAnswer |
Representa os resultados da resposta. |
TextAnswer
Representa o resultado da resposta.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
responder
|
answer | string |
Texto da resposta. |
|
Limite de confiança
|
confidenceScore | float |
Pontuação de confiança de resposta, o valor varia de 0 a 1. |
|
id
|
id | string |
ID do registro. |
|
answerSpan
|
answerSpan | AnswerSpan |
Objeto de intervalo de resposta do QnA. |
|
deslocamento
|
offset | integer |
O deslocamento da sentença desde o início do documento. |
|
length
|
length | integer |
O comprimento da frase. |