Este guia mostra como criar e testar um agente de encomenda de camisolas simples com manuais de procedimentos. Quando interage com este agente, pode perguntar pela localização da loja, saber o horário de funcionamento da loja ou fazer uma encomenda de camisolas.
Antes de começar
Antes de ler este guia, deve fazer o seguinte:
- Se ainda não o fez, siga as instruções de configuração.
Acerca dos guias interativos
Um agente é composto por um ou mais manuais de soluções. Cada manual tem um âmbito claramente definido e limitado. Um guia interativo tem os seguintes dados:
| X | Item |
|---|---|
| Nome | Um nome usado para identificar o manual de soluções. |
| Objetivo | Os objetivos são descrições de alto nível do que o manual deve alcançar. |
| Instruções | As instruções são passos de alto nível que devem ser seguidos para alcançar o objetivo do manual. |
| Exemplos | Os exemplos são conversas de amostra entre um utilizador final e o agente. Estes exemplos são efetivamente exemplos de comandos de poucos disparos para o MDG. |
Crie o agente
Para criar o agente:
Aceda à consola de agentes de conversação:
Se ainda não o tiver feito, selecione ou crie um projeto.
Clique em Criar agente.
Clique em Crie o seu.
Indique "Shirt Ordering - Playbooks" para o nome do agente.
Indique uma localização.
Indique um fuso horário.
Indique um idioma predefinido.
Selecione Playbook para a opção Início da conversa.
Clique em Criar.
A interface do utilizador direciona para o livro de jogadas predefinido denominado Livro de jogadas generativo predefinido.
Clique no botão anterior para ver a lista de manuais de soluções.
Crie o manual de vendas
O manual de estratégias Encomendar processa as encomendas de camisolas. Para criar este manual:
- Clique em Criar.
- Selecione a opção Guia interativo de tarefas.
- Introduza o nome do manual:
Order. Introduza o seguinte objetivo:
You are a shirt store ordering assistant. Help customers purchase shirts. Help the customer choose a size and color. The shirts come in small, medium, and large. The shirts can be red, green, or blue.Introduza as seguintes instruções:
- If the customer has not provided a size, ask them to choose a size. - If the customer has not provided a color, ask them to choose a color. - Once the customer has selected a size and color for the shirt, repeat the selection to the customer, and ask them to confirm the selection. - Once the customer has confirmed their selection, let them know that the shirt is now ordered. - Do not provide prices or collect payment. - Do not collect the customer's name or address.Clique em Guardar.
Clique no botão anterior para voltar à lista de manuais de vendas.
Crie o manual de informações
O manual de estratégias Informações processa perguntas sobre a loja. Para criar este manual:
- Clique em Criar.
- Selecione a opção Guia interativo de tarefas.
- Introduza o nome do manual:
Information. Introduza o seguinte objetivo:
You provide information about a shirt store. The store is open between 8 AM and 6 PM every day. The store is located at 1007 Mountain Drive, Gotham City, NJ.Introduza as seguintes instruções:
- If the customer asks for the store location, provide them with the address. - If the customer asks for the store hours, provide them with the hours.Clique em Guardar.
Clique no botão anterior para voltar à lista de manuais de vendas.
Atualize o Playbook predefinido
Quando criou a aplicação pela primeira vez, foi criado um guia interativo predefinido para si. Este Playbook deve orientar a conversa para os Playbooks adequados com objetivos específicos. Nas instruções abaixo, pode ver como o Playbook predefinido faz referência aos outros Playbooks. Para atualizar este guia interativo:
- Clique no manual de estratégias predefinido. Este guia interativo tem uma estrela realçada.
Introduza o seguinte objetivo:
You are an assistant for a shirt store. Your name is "Samantha". Your job is to direct customers to other playbooks based on the customer's questions.Introduza as seguintes instruções:
- If the customer hasn't been greeted yet, greet the customer, introduce yourself, and ask the user how you can help. - If the customer wants information about the store, route them to ${PLAYBOOK: Information} - If the customer wants to purchase a shirt, route them to ${PLAYBOOK: Order}Clique em Guardar.
Tenha em atenção que as referências ao manual de estratégias estão realçadas porque ainda não existem exemplos. Estas informações vão ser adicionadas na secção seguinte.
Clique no botão anterior para voltar à lista de manuais de vendas.
Forneça exemplos
Neste ponto, a sua estratégia está funcional. No entanto, tem de fornecer exemplos para garantir respostas de qualidade.
Pode fornecer manualmente exemplos no separador Exemplos quando tiver um manual aberto. No entanto, é frequentemente mais fácil ter uma conversa com o manual de procedimentos em funcionamento e guardar a conversa como exemplo.
Uma conversa de exemplo com um guião predefinido é curta. Este guia interativo só tem de lhe indicar outro guia interativo. Para ter uma conversa com o guião predefinido:
- Feche ou cancele qualquer painel que possa estar presente no lado direito do ecrã.
- Clique no botão do simulador na navegação da linha superior.
- Para o recurso, selecione o guia interativo predefinido.
- Use o modelo predefinido ou selecione uma alternativa.
- Na caixa de texto com a indicação Introduza a entrada do utilizador,
escreva
Helloe, de seguida, prima Enter. - O manual responde com uma saudação.
Para guardar esta conversa como exemplo:
- Selecione o guia interativo predefinido no menu pendente Invocações.
- Clique no botão Guardar como exemplo perto da parte superior direita da interface.
- É aberto o painel do editor de exemplos. Pode usar este editor para adicionar, editar, eliminar ou reordenar ações.
- Indique o nome do exemplo:
Greeting. - Atualize as respostas do manual conforme necessário.
- Desloque a página para baixo até Terminar exemplo com informações de saída
e introduza
The user is greeted.na secção Resumo. - Clique no ícone de guardar.
Adicione um exemplo de localização para o manual de informações:
- Feche ou cancele qualquer painel que possa estar presente no lado direito do ecrã.
- Se necessário, repõe a conversa com o botão reset restart_alt.
- Selecione o manual de informações no menu pendente Recurso de início do simulador.
- Introduza a mensagem:
Where are you located?. - O manual responde com uma localização.
- Selecione o manual de informações no menu pendente Invocações.
- Clique no botão Guardar como exemplo.
- Indique o nome do exemplo:
Location. - Antes de guardar esta conversa como exemplo, tem de eliminar a ação que contém "Onde se encontra". Apenas os exemplos de guião predefinidos podem começar com uma ação do utilizador.
- Para fornecer o exemplo com o contexto que iniciou a conversa,
expanda a secção Resumo da conversa anterior...
e introduza o seguinte
no campo Exemplo de início com informações de entrada:
The customer asked "Where are you located?". - Para fornecer o exemplo com o contexto que completa a conversa,
expanda a secção Resumo da execução do plano de ação...
e introduza o seguinte
no campo Terminar exemplo com informações de saída:
The store is located at 1007 Mountain Drive, Gotham City, NJ.. - Clique no ícone de guardar.
Adicione um exemplo de horário para o manual de informações:
- Semelhante aos passos acima,
mas introduza a mensagem:
What are your hours?e dê o nomeHoursao exemplo.
Adicione um exemplo de seleção para o guia interativo de encomendas:
Semelhante aos passos acima, mas dê o nome
Selectionao exemplo, selecione o manual de vendas de encomendas e envie as seguintes mensagens:I want to buy a shirtLargeGreenYes
Teste o agente
O seu agente está agora pronto para ser testado. Abra o painel do simulador e converse com o agente. Não tem de ter as mesmas conversas que acima. Por exemplo, pode perguntar a este agente que cores estão disponíveis para camisas. Se não estiver a obter o comportamento desejado, pode melhorar as respostas refinando os exemplos e criando novos.
Interagir com o agente através da API
Consulte Interações com a API.