Formação

Quando o seu agente é preparado, o Dialogflow usa os seus dados de preparação para criar modelos de aprendizagem automática especificamente para o seu agente. Estes dados de preparação consistem principalmente em intenções, expressões de preparação de intenções e entidades referenciadas num agente, que são usados eficazmente como etiquetas de dados de aprendizagem automática. No entanto, os modelos de agentes são criados com base em respostas de comandos de parâmetros, definições de agentes e muitos outros dados associados ao seu agente.

Sempre que alterar o agente, deve garantir que o agente é preparado antes de tentar usá-lo. Consoante as definições do agente, a formação pode ocorrer de forma automática ou manual.

Também pode usar a ferramenta de preparação para analisar e importar dados de conversas reais e para melhorar os dados de preparação.

Preparação automática do agente de rascunho

Por predefinição, a formação de agentes para um agente de rascunho é executada automaticamente sempre que atualiza e guarda o agente a partir da consola. As caixas de diálogo pop-up apresentam o estado desta preparação.

No entanto, a atualização do agente com a API não aciona a preparação automática.

Formação manual de agentes de rascunho

Pode atualizar as definições de ML para desativar a preparação automática de um agente rascunho.

Se o seu agente tiver mais de 780 intenções, ou se tiver desativado a definição de preparação automática, tem de executar a preparação manualmente.

Para formar manualmente um agente a partir da consola, clique no botão Formar nas definições de ML.

Para formar manualmente um agente com a API, chame o método train no tipo Agent.

Preparação automática da versão do agente

Sempre que é criada uma nova versão do agente, esta é preparada automaticamente.

Para criar uma nova versão do agente a partir da consola, clique no botão Publicar uma versão no separador Ambientes.

Para criar uma nova versão do agente com a API, chame o método create para o Tipo de versão para criar uma nova versão do agente.

Ferramenta de formação

A ferramenta de preparação é usada para rever as entradas dos utilizadores finais enviadas para o seu agente e para melhorar os dados de preparação. Com a ferramenta, pode:

  • Reveja as entradas reais dos utilizadores finais e as intenções que correspondem a cada interação de conversa com o modelo de agente atual.
  • Adicione as expressões do utilizador final destas conversas às frases de preparação das intenções correspondentes, de intenções diferentes ou de intenções alternativas.
  • Importe expressões de utilizadores finais que preparou ou captou de conversas reais.

A ferramenta usa dados do histórico do agente para carregar conversas, pelo que o registo de interações tem de estar ativado para usar a ferramenta. A ferramenta de preparação só mostra expressões do utilizador final. Para ver os dados de conversas do agente e do utilizador final, consulte o histórico do agente mais completo.

Para abrir a ferramenta de formação:

  1. Aceda à consola do Dialogflow ES.
  2. Selecione o seu agente perto da parte superior do menu da barra lateral esquerda.
  3. Clique em Formação no menu da barra lateral esquerda.

Lista de conversas

Quando abre a ferramenta, é apresentada a lista de conversas. Esta é uma lista de conversas recentes por ordem cronológica inversa. Cada linha na lista apresenta um resumo de uma conversa. A tabela seguinte descreve cada um dos elementos da IU:

Elemento da IU Descrição
Conversa A primeira expressão do utilizador final na conversa.
Data A data em que a conversa ocorreu ou foi importada.
Quando uma conversa é usada para atualizar dados de preparação (conforme descrito abaixo), o indicador de estado da linha mostra uma marca de verificação verde.

Vista de treino

Quando clica numa linha da lista de conversas, abre a conversa na vista de preparação. A vista de preparação mostra uma lista de interações conversacionais e oferece controlos para adicionar estes dados aos seus dados de preparação.

Quando edita os dados apresentados ou clica num botão de tarefa à direita, cria tarefas de atualização de dados de preparação que são colocadas em fila para guardar. Quando terminar de criar tarefas, clique no botão Aprovar para executar todas as tarefas em fila. Após a aprovação, deve preparar o agente manualmente.

Captura de ecrã da vista de treino

A tabela seguinte descreve cada um dos elementos da IU:

Elemento da IU Descrição
Data A data em que a conversa ocorreu ou foi importada.
Pedidos O número de linhas da conversa.
Sem correspondência O número de linhas para as quais não existe uma intenção correspondente.
O utilizador diz A expressão do utilizador final para a linha.
Intenção A intenção desta linha correspondeu ao modelo de agente atual. Pode clicar no link para alterar a intenção associada para uma intenção nova ou existente.
Coloca em fila uma tarefa para adicionar a expressão do utilizador final para a linha como uma frase de preparação à intenção atualmente selecionada. O ícone fica verde quando uma tarefa é colocada em fila.
Coloca em fila uma tarefa para adicionar a expressão do utilizador final para a linha como uma frase de preparação à intenção de alternativa predefinida. Isto cria um exemplo negativo. O ícone fica laranja quando uma tarefa é colocada em fila.
Coloca uma tarefa em fila para eliminar a linha. O ícone fica vermelho quando uma tarefa é colocada em fila.
Aprovar Executa tarefas em fila para todas as linhas.

Notas

Quando analisa uma conversa na vista de preparação, as expressões do utilizador final mostram as entidades correspondentes como anotações realçadas. Para adicionar ou editar uma anotação:

  1. Clique numa anotação ou selecione as palavras que quer anotar.
  2. Escolha uma entidade existente no menu.

Captura de ecrã com anotações

Importe conversas

Pode importar ficheiros de dados de conversas que preparou ou capturou para a ferramenta de preparação. A importação de conversas pode ser usada para melhorar um agente existente. Para carregar uma conversa, clique no botão Carregar na parte superior da página. Em seguida, pode analisar estes dados para os adicionar aos dados de preparação, conforme descrito acima.

A seguir, descreve-se o formato do conteúdo do ficheiro, as respetivas limitações e os resultados:

  • Cada ficheiro carregado resulta numa única conversa na ferramenta de preparação.
  • Os pedidos não são enviados para a API detect intent, por conseguinte, não são ativados contextos nem são encontradas intenções correspondentes.
  • Um único ficheiro de texto ou um arquivo ZIP que pode conter até 10 ficheiros de texto.
  • Um carregamento não pode exceder 3 MB.
  • Os ficheiros devem conter apenas expressões de utilizadores finais delimitadas por novas linhas.
  • Idealmente, os ficheiros só devem incluir dados úteis como expressões de preparação.
  • A ordem das expressões do utilizador final não é importante.

Segue-se um exemplo de ficheiro:

I want information about my account.
What is my checking account balance?
How do I transfer money to my savings account?

Limitações

  • A ferramenta de preparação só está disponível para a global região.
  • A ferramenta de preparação não tem em consideração a definição de limite de classificação de ML para a correspondência de intenções. Pode ver intenções diferentes correspondidas no tempo de execução e na ferramenta de preparação, mesmo que o modelo do agente não tenha sido alterado.
  • As entradas do utilizador final que contêm valores de parâmetros obrigatórios podem não corresponder às intenções esperadas na ferramenta de preparação, embora correspondam corretamente no tempo de execução. Isto pode acontecer nas seguintes situações:
    • Não existem expressões de treino anotadas nesse intento.
    • A entrada difere significativamente das expressões de preparação.

Práticas recomendadas

Use a ferramenta de preparação em várias fases do desenvolvimento

Use a ferramenta de preparação em várias fases do desenvolvimento do agente e refine os dados de preparação em cada fase:

  • Antes de lançar o seu agente para produção, teste-o com um pequeno grupo de utilizadores.
  • Pouco depois de o agente ser lançado para produção, verifique se as conversas reais estão a comportar-se como esperado.
  • Sempre que forem feitas alterações significativas ao seu agente, verifique se as novas alterações estão a funcionar como esperado.
  • Execute a ferramenta periodicamente para agentes de produção, para fazer análises regulares.

Importe dados de qualidade

As seguintes opções podem ser origens de dados úteis:

  • Registos de conversas com agentes humanos do serviço de apoio ao cliente.
  • Conversas de apoio ao cliente online (email, fóruns, Perguntas frequentes).
  • Perguntas dos clientes nas redes sociais.

Deve evitar os seguintes tipos de dados:

  • Expressões de utilizadores finais de formato longo e não conversacionais.
  • Expressões do utilizador final que não são relevantes para nenhuma das intenções no seu agente.
  • Registos de coisas não ditas pelos utilizadores finais (por exemplo, respostas de agentes do serviço de apoio ao cliente).