Manuais

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Observação: o recurso Playbook é excluído do SLA do Dialogflow.

Um playbook é o elemento básico dos agentes generativos. Um agente generativo normalmente tem muitos playbooks, e cada um deles é definido para lidar com tarefas específicas. Os dados do playbook são enviados ao LLM, que tem as informações necessárias para responder a perguntas e realizar tarefas. Cada playbook pode disponibilizar informações, enviar consultas para serviços externos ou adiar o processamento de conversas para um fluxo ou outro playbook para lidar com subtarefas.

Limitações

Considere as seguintes limitações:

• Os agentes que usam playbooks não oferecem suporte ao envio de um SMS companion call da rota de intent de boas-vindas padrão no fluxo inicial padrão, mas você pode ativar a opção de SMS companion call nos fluxos padrão.

Suporte ao idioma

Os playbooks oferecem suporte às mesmas linguagens dos modelos do Gemini.

Suporte a região

Os playbooks têm suporte nas seguintes regiões:

• global
• asia-south1
• asia-southeast1
• asia-northeast1
• australia-southeast1
• eu (multirregião)
• europe-west1
• europe-west2
• europe-west3
• northamerica-northeast1
• us (multirregião)
• us-central1
• us-east1
• us-west1

Dados do playbook

Um playbook é composto pelos seguintes dados:

• Nome do playbook: um nome conciso em linguagem natural que ajuda os desenvolvedores e o LLM a entender quais tarefas o playbook processa.
• Metas: descrição de alto nível do que o playbook precisa alcançar
• Instruções: define as etapas do processo que devem ser seguidas para alcançar a meta.
• Exemplos: conversas de exemplo que são exemplos de comandos de poucos disparos para o LLM
• Parâmetros: são usados para armazenar informações sobre uma conversa, como entrada do usuário, informações do sistema do usuário, resultados de ações e assim por diante.

Tipos de playbook

Ao criar um playbook, selecione o tipo que você quer: de tarefas ou de rotinas.

Playbooks de tarefas

Os playbooks de tarefas são o tipo original de playbook. Elas são usadas para dividir tarefas complexas em subtarefas menores e reutilizáveis. Eles são usados para modelar estágios de conversa composição, em que cada estágio se comunica por parâmetros de entrada e saída.

O exemplo a seguir mostra um playbook de tarefa (chamador) chamando outro playbook de tarefa (chamado):

1. O autor da chamada inicia a chamada.
2. O autor da chamada fornece os parâmetros de entrada necessários ao chamado.
3. O chamador processa essas informações, executa a função designada e retorna os parâmetros de saída.
4. O autor da chamada recebe parâmetros do destinatário.

Qualquer playbook de rotina ou tarefa pode chamar outro playbook de tarefa, mas um playbook de tarefa não pode chamar outro playbook de rotina.

Playbooks de rotina

Os manuais de rotina são um novo tipo de manual. Elas são usadas para modelar estágios de conversa sequenciais, em que cada estágio é completo e independente. Eles podem chamar playbooks de tarefas para decompor tarefas maiores em subtarefas menores e fazer a transição para outros playbooks ou fluxos de rotina.

O exemplo a seguir mostra um playbook de rotina (A) fazendo a transição para outro playbook de rotina (B), fazendo a transição para um fluxo (C):

1. O playbook de rotina A pode ler os parâmetros de sessão quando ele é iniciado e gravar os parâmetros de sessão pouco antes de sair.
2. O playbook de rotina A sai e faz a transição para o playbook de rotina B.
3. O playbook de rotina B pode ler parâmetros de sessão quando ele é iniciado e gravar parâmetros de sessão pouco antes de sair.
4. O playbook B sai e faz a transição para o fluxo C.
5. O fluxo C pode ler e gravar parâmetros de sessão.

Se um playbook de rotina não fizer a transição para outro playbook ou fluxo de rotina, a sessão vai retornar ao último fluxo ativo ou será encerrada se não houver um.

Os playbooks de rotina têm o seguinte comportamento de gerenciamento de parâmetros:

• Quando um playbook de rotina é inserido, os valores atribuídos aos parâmetros de entrada são equivalentes aos parâmetros de sessão com o mesmo nome.
• Quando um playbook de rotina é encerrado, ele gera valores para os parâmetros de saída e os atribui a parâmetros de sessão com o mesmo nome.

Manual padrão

Quando você cria um agente generativo usando o console de agentes conversacionais, um Playbook generativo padrão é criado automaticamente.

O playbook padrão é o ponto de partida para as conversas. Por isso, ele tem algumas diferenças importantes em relação a outros playbooks:

• O playbook padrão não recebe um resumo das rodadas de conversa anteriores.
• O playbook padrão não pode definir nem receber parâmetros de entrada.

Importar e exportar playbooks

Depois de criar playbooks usando o console de agentes de conversação, você pode exportá-los para uso em outro agente. Para exportar um playbook:

1. Acesse a lista de playbooks.
2. Clique no botão de exportação do playbook que você quer exportar.
3. Selecione as opções de exportação.
4. Clique em Exportar.

Para importar um playbook exportado anteriormente:

1. Acesse a lista de playbooks.
2. Clique em Importar.
3. Selecione as opções de importação.
4. Clique em Importar.