Alguns produtos e recursos estão sendo renomeados. Os recursos de playbook generativo e de fluxo também estão sendo migrados para um único console consolidado. Confira os detalhes.
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Por padrão, os playbooks usam LLMs para controlar a conversa, realizar ações e responder aos usuários finais.
Se você precisar de um controle mais explícito sobre o comportamento do agente,
use
fluxos
ou ações condicionais, descritas neste guia.
As ações condicionais são uma configuração opcional para playbooks.
É possível definir acionadores e condições de conversa que invocam ações específicas, como responder com uma mensagem específica, chamar uma ferramenta externa, invocar outro playbook ou realizar qualquer outra ação especificada.
Gatilhos
É possível definir gatilhos que são a primeira etapa para determinar se uma ação condicional é aplicável.
A seguir, descrevemos os tipos de acionadores e os acionadores específicos para cada tipo:
Etapa do ciclo de vida
Início do playbook:
acionado na primeira vez que um playbook é iniciado.
Antes de o LLM decidir a próxima ação:
acionado sempre antes de o LLM prever a próxima ação.
Antes de o LLM executar a próxima ação:
acionado sempre antes de o LLM executar uma ação.
Evento
Evento personalizado
Nenhuma entrada do usuário
Condições
Depois que um acionador é ativado, a segunda etapa é avaliar as condições fornecidas opcionalmente.
As condições são fornecidas usando a mesma
sintaxe de condição
usada pelas rotas de fluxo.
Se nenhuma condição for fornecida, apenas o acionador será usado para iniciar ações.
Use a seguinte sintaxe para fazer referência a parâmetros e ações anteriores/seguintes:
$last-action.name = "query_order" AND $last-action.status != SUCCESS
$last-action.name = "query_order" AND $last-action.output.orders = null
Ações
Depois que um gatilho e uma avaliação de condição opcional ocorrem,
é possível configurar as seguintes ações:
Fornecer uma resposta ao usuário final: texto, resposta condicional, payload personalizado e áudio pré-gravado.
Ao fornecer texto, você pode inserir [pause], [pauseShort] ou [pause long] para inserir pausas na fala do agente.
Exemplo: How can I help you today? [pause long] I can help with....
Substituir a próxima ação do LLM: uso de ferramentas, invocação, conclusão, transição e invocação de playbook e fluxo.
Mudar as configurações de fala:
nome do modelo, sem tempo limite de fala, sensibilidade do ponto final, adaptação.
Ativar a interrupção
Permitir o cancelamento da reprodução de respostas parciais
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[[["\u003cp\u003eThis page explains conditional actions, an optional feature for playbooks that allows for more control over agent behavior beyond default LLM-driven interactions.\u003c/p\u003e\n"],["\u003cp\u003eConditional actions are activated by triggers, such as lifecycle stages (like playbook start or before an LLM action) or events (like custom events or no user input).\u003c/p\u003e\n"],["\u003cp\u003eAfter a trigger, optional conditions can be evaluated using a specific syntax to determine if an action should be initiated, similar to how flow routes operate, with no conditions causing the trigger to initiate actions.\u003c/p\u003e\n"],["\u003cp\u003eConditions can reference session parameters, playbook input parameters, and details about the last or next action, including their name, input, output, and status.\u003c/p\u003e\n"],["\u003cp\u003eUpon trigger and condition evaluation, a variety of actions can be configured, including responding to the user, overriding LLM actions, modifying speech settings, and enabling features like barge-in or DTMF.\u003c/p\u003e\n"]]],[],null,["# Conditional actions\n\nBy default,\nplaybooks use LLMs to control the conversation,\ntake actions, and respond to end-users.\nIf you need more explicit control over the agent's behavior,\nyou can use\n[flows](/dialogflow/cx/docs/concept/flow)\nor *conditional actions*, which are described in this guide.\n\nConditional actions are an optional configuration for playbooks.\nYou can set conversation triggers and conditions that invoke specific actions\nlike responding with a specific message,\ncalling an external tool,\ninvoking another playbook,\nor performing any other specified action.\n\nTriggers\n--------\n\nYou can define triggers that are the first step\nin determining whether a conditional action is applicable.\nThe following describes trigger types\nand the specific triggers for each type:\n\n- **Lifecycle stage**\n - **Playbook start**: Triggered the first time a playbook is started.\n - **Before the LLM decides its next action**: Triggered every time before the LLM predicts the next action.\n - **Before the LLM executes its next action**: Triggered every time before the LLM executes an action.\n- **Event**\n - **Custom event**\n - **No input from user**\n\nConditions\n----------\n\nOnce a trigger occurs,\nthe second step is to evaluate any optionally supplied conditions.\nConditions are supplied using the same\n[condition syntax](/dialogflow/cx/docs/reference/condition)\nused by flow routes.\n\nIf no conditions are supplied,\nthe trigger alone will be used to initiate actions.\n\nYou can use the following syntax to reference parameters\nand last/next actions:\n\n- Session parameters\n - `$session.params.PARAMETER_NAME`\n- Playbook input parameters\n - `$playbook.input.INPUT_FIELD_NAME`\n- Last action (previously executed action)\n - `$last-action.name`\n - `$last-action.input.INPUT_FIELD_NAME`\n - `$last-action.output.OUTPUT_FIELD_NAME`\n - `$last-action.status`\n- Next action (LLM predicted next action)\n - `$next-action.name`\n - `$next-action.input.INPUT_FIELD_NAME`\n\nYou can also use\n[system functions](/dialogflow/cx/docs/reference/system-functions).\n\nExamples:\n\n- `$session.params.current_user = null`\n- `$last-action.name = \"query_order\"`\n- `$last-action.name = \"query_order\" AND $last-action.status != SUCCESS`\n- `$last-action.name = \"query_order\" AND $last-action.output.orders = null`\n\nActions\n-------\n\nOnce a trigger and optional condition evaluation have occurred,\nyou can configure the following actions to take place:\n\n- **Provide a response to the end-user** : text, conditional response, custom payload, and [pre-recorded audio](#pre-recorded-audio). When supplying text, you can insert `[pause]`, `[pauseShort]`, or `[pause long]` to inject pauses in agent speech. Sample: `How can I help you today? [pause long] I can help with...`.\n- **Override the next LLM action**: tool use, playbook invocation, playbook completion, flow invocation, playbook transition, flow transition.\n- **Change speech settings**: model name, no speech timeout, endpointer sensitivity, adaptation.\n- **Enable barge-in**\n- **Allow cancellation of partial response playback**\n- **Send Call Companion SMS**\n- **Enable DTMF** : see [DTMF for telephony integrations](/dialogflow/cx/docs/concept/dtmf)"]]
