Manuais

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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

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

Ao usar idiomas diferentes do inglês, defina seus exemplos no idioma de destino, mas deixe as instruções em inglês. Para determinados idiomas e casos de uso, você pode receber respostas um pouco melhores se também fornecer instruções no idioma de destino.

Suporte a modelos

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

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

  • Em "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).

• Como substituir a seleção de modelo no nível da solicitação.

  • No simulador do console do agente 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	Nome de exibição do modelo	Especificação do modelo	Etapa do lançamento	Região disponível
gemini-pro	gemini-1.0-pro-001	Gemini 1.0 Pro	GA	Todas as regiões de playbook
gemini-1.5-flash	gemini-1.5-flash-001	Gemini 1.5 Flash	GA	Todas as regiões de playbook
gemini-1.5-flash-002	gemini-1.5-flash-002	Gemini 1.5 Flash 002	Prévia pública	Todas as regiões de playbook
gemini-2.0-flash-001	gemini-2.0-flash-001	Gemini 2.0 Flash	Prévia pública	Em várias regiões da UE, dos EUA e regiões únicas com suporte da Vertex AI.

As datas de desativação do modelo são alinhadas às da Vertex AI. Consulte Versões do modelo para mais informações.

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. 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.

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 parâmetros de sessão quando ele é iniciado e gravar 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 de conversação, um playbook generativo padrão é criado automaticamente.

O playbook padrão é o ponto de partida das 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.