Expressões de preparação

Nota: existem muitas práticas recomendadas importantes para as expressões de treino descritas no guia de práticas recomendadas de design de agentes.

As frases de preparação são frases de exemplo do que os utilizadores finais podem escrever ou dizer, denominadas expressões do utilizador final. Para cada intenção, cria muitas expressões de preparação. Quando uma expressão do utilizador final se assemelha a uma destas expressões, o Dialogflow faz corresponder a intenção.

Por exemplo, a expressão de preparação "Quero pizza" prepara o seu agente para reconhecer expressões do utilizador final semelhantes a essa expressão, como "Comprar uma pizza" ou "Pedir pizza".

Não tem de definir todos os exemplos possíveis, porque a aprendizagem automática incorporada do Dialogflow expande a sua lista com outras frases semelhantes. Deve criar, pelo menos, 10 a 20 (consoante a complexidade da intenção) expressões de preparação, para que o seu agente possa reconhecer uma variedade de expressões do utilizador final. Por exemplo, se quiser que a sua intenção reconheça a expressão de um utilizador final sobre a sua cor favorita, pode definir as seguintes frases de treino:

• "Gosto de vermelho"
• "A minha cor favorita é o amarelo"
• "black"
• "O azul é a minha cor favorita"
• …

Onde encontrar estes dados

Ao criar um agente, é mais comum usar a consola do Dialogflow ES (visite a documentação, abra a consola). As instruções abaixo focam-se na utilização da consola. Para aceder aos dados de expressões de treino:

1. Aceda à consola do Dialogflow ES.
2. Selecione um agente.
3. Selecione Intenções no menu da barra lateral esquerda.
4. Selecione uma intenção.
5. Desloque a página para baixo até à secção Frases de preparação.

Se estiver a criar um agente através da API em vez da consola, consulte a referência de intenções. Os nomes dos campos da API são semelhantes aos nomes dos campos da consola. As instruções abaixo realçam as diferenças importantes entre a consola e a API.

Adicione expressões de preparação

Para adicionar expressões de treino a uma intenção:

1. Clique no campo de texto que apresenta "Adicionar expressão do utilizador".
2. Escreva as suas expressões de treino e prima a tecla Enter após cada uma.

Anote as expressões de preparação

Nota: existem muitas práticas recomendadas importantes para as anotações de expressões de preparação descritas no guia de práticas recomendadas de design de agentes.

Quando uma intenção é correspondida no tempo de execução, o Dialogflow fornece os valores extraídos da expressão do utilizador final como parâmetros. Cada parâmetro tem um tipo, denominado tipo de entidade, que determina exatamente como os dados são extraídos. Ao contrário da entrada bruta do utilizador final, os parâmetros são dados estruturados que podem ser facilmente usados para realizar alguma lógica ou gerar respostas.

Quando cria um agente, controla a forma como os dados são extraídos anotando partes das suas expressões de preparação e configurando os parâmetros associados.

Por exemplo, considere uma expressão de preparação como "Qual é a previsão para amanhã em Tóquio?" Deve anotar "amanhã" com um parâmetro date e "Tóquio" com um parâmetro location. Quando anota partes de uma expressão de preparação, o Dialogflow reconhece que estas partes são apenas exemplos de valores reais que serão fornecidos pelos utilizadores finais no tempo de execução. Para uma expressão do utilizador final, como "Qual é a previsão para sexta-feira em Lisboa?", O Dialogflow extrairia o parâmetro date de "sexta-feira" e o parâmetro location de "Sydney".

Quando cria um agente com a consola, a maioria das anotações é criada automaticamente quando adiciona expressões de preparação que contêm partes que podem ser associadas a um tipo de entidade existente. Estas partes são realçadas na consola. Pode editar estas anotações e parâmetros conforme necessário.

Para anotar manualmente uma expressão de preparação com a consola:

1. Selecione a parte da expressão de treino que quer anotar.
2. Selecione o tipo de entidade pretendido na lista.
3. É criado um parâmetro para si na tabela de parâmetros abaixo.
4. Clique no botão Guardar e aguarde até que a caixa de diálogo Formação de agentes indique que a formação está concluída.

Quando cria um agente com a API, tem de anotar as expressões de preparação e configurar os parâmetros manualmente. Consulte os tipos TrainingPhrase e Parameter na referência de intenções. O campo Part.alias associa as anotações de expressões de preparação a parâmetros específicos.

Entidades implícitas criadas por expressões de treino

Nota: deve definir as entidades explicitamente, em vez de depender de valores de entidades personalizadas definidos implicitamente.

A maioria das entidades personalizadas é definida explicitamente através da criação de tipos de entidades e da adição de entradas de entidades. No entanto, as entidades personalizadas também podem conter valores implícitos. Isto acontece quando anota texto de uma expressão de preparação, em que o texto anotado não é um valor definido pelo tipo de entidade selecionado. O texto anotado torna-se um valor de referência de entidade para a entrada de entidade adicionada implicitamente. Se o tipo de entidade for uma entidade de mapa, o texto também se torna um sinónimo da entrada da entidade.

Modos de exemplo e modelo

Atenção: o modo de modelo foi descontinuado. Use sempre o modo de exemplo para novas expressões de treino.

Cada expressão de preparação pode estar num de dois modos:

• Modo de exemplo: Indicado por à esquerda da expressão de preparação. As expressões de preparação no modo de exemplo são escritas em linguagem natural e são anotadas para a extração de parâmetros.
• Modo de modelo: Indicado por à esquerda da expressão de treino. As expressões de preparação no modo de modelo contêm referências diretas a tipos de entidades.