Manuais

Um playbook é o elemento básico dos agentes generativos. Um agente generativo normalmente tem vários 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 de 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 de acompanhante de chamada pela rota de intent de boas-vindas padrão no fluxo inicial padrão, mas é possível ativar a opção de SMS de acompanhante de chamada em fluxos padrão.
• Os playbooks não são compatíveis com a entrada DTMF de sistemas telefônicos.

Suporte ao idioma

Consulte a coluna Playbooks na referência de idioma. Os idiomas marcados para playbooks foram testados quanto à qualidade com modelos gemini-2.0-flash e gemini-1.5-flash-002.

Ao usar outros idiomas além do inglês, defina seus exemplos no idioma de destino, deixando as instruções em inglês. Para alguns idiomas e casos de uso, você pode receber respostas um pouco melhores se fornecer instruções adicionais no idioma de destino.

Suporte a modelos

É possível selecionar o modelo de LLM usado no playbook nos seguintes locais:

• Selecione o modelo de LLM no nível do agente.

  • Na configuração do agente do console de agentes de conversação -> IA generativa -> Playbook, selecione o modelo pelo nome de exibição no menu suspenso de todos os modelos disponíveis.
  • Especifique o nome do modelo no campo GenerativeSettings.llm_model_settings.model se você usar a API para atualizar a configuração do agente (consulte GenerativeSettings).

• Substituição da seleção de modelo no nível da solicitação.

  • No simulador do console de agentes de conversação, selecione o modelo pelo nome de exibição no menu suspenso ao testar um playbook.
  • Especifique o nome do modelo no campo DetectIntentRequest.query_params.llm_model_settings.model se você estiver testando o agente pela API (consulte DetectIntentRequest).

Nome do modelo	Especificação do modelo	Etapa do lançamento
gemini-2.0-flash-001	Gemini 2.0 Flash	GA
gemini-2.0-flash-lite-001	Gemini 2.0 Flash Lite	Prévia pública
gemini-2.5-flash	Gemini 2.5 Flash	Prévia pública
gemini-1.5-flash-001	Gemini 1.5 Flash	Legado
gemini-1.5-flash-002	Gemini 1.5 Flash	Legado

Suporte a regiões

Os playbooks são compatíveis com as seguintes regiões:

• global
• asia-south1
• asia-southeast1
• asia-southeast2
• asia-northeast1
• australia-southeast1
• eu (multirregional)
• europe-west1
• europe-west2
• europe-west3
• europe-west4
• europe-west6
• northamerica-northeast1
• us (multirregional)
• us-central1
• us-east1
• us-west1

Dados do playbook

Um playbook é composto pelos seguintes dados:

• Nome do manual: um nome conciso em linguagem natural que ajuda os desenvolvedores e o LLM a entender quais tarefas o manual processa.
• Metas: descrição de alto nível do que o playbook precisa realizar
• Instruções: define as etapas do processo que devem ser seguidas para alcançar a meta.
• Exemplos: conversas de amostra que são exemplos de comandos de poucos disparos eficazes 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 manual, você seleciona o tipo que quer: manual de tarefas ou de rotina.

Playbooks de tarefas

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

A seguir, mostramos um playbook de tarefas (chamador) chamando outro playbook de tarefas (chamado):

1. O autor da chamada inicia o destinatário.
2. O autor da chamada fornece os parâmetros de entrada necessários ao destinatário.
3. O destinatário processa essas informações, executa a função designada e retorna 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 de rotina.

Manuais de rotinas

Os manuais de rotina são um novo tipo de manual. Eles são usados 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.

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

1. O playbook de rotina A pode ler parâmetros de sessão quando é iniciado e gravar parâmetros de sessão pouco antes de sair.
2. O playbook de rotina A é encerrado e passa para o playbook de rotina B.
3. O playbook de rotina B pode ler parâmetros de sessão quando é iniciado e gravar parâmetros de sessão pouco antes de sair.
4. O playbook de rotina B é encerrado e passa 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 voltar 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 parâmetros de entrada dele recebem valores 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 dos agentes de conversação, um playbook generativo padrão é criado automaticamente.

O playbook padrão é o ponto de partida para as conversas e tem algumas distinções importantes de outros playbooks:

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

Criar um playbook

Para criar um playbook:

1. Clique no ícone do playbook na navegação à esquerda do console.
2. Clique no botão Criar novo.
3. Selecione o tipo de manual Rotina ou Tarefa.
4. Forneça dados do playbook.

Usar a geração de IA para criar um playbook

Ao criar um playbook, um painel de IA generativa é aberto. Você pode usar isso para gerar dados de playbook.

Importar e exportar playbooks

Depois de criar playbooks usando o console de agentes de conversação, é possível exportá-los para usar em outro agente. Para exportar um playbook:

1. Navegue até 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 que você exportou anteriormente:

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