Ações condicionais

Por padrão, os playbooks usam LLMs para controlar a conversa, realizar ações e responder aos usuários finais. Se você precisar de mais controle explícito sobre o comportamento do agente, use fluxos ou ações condicionais, que são descritos neste guia.

As ações condicionais são uma configuração opcional para playbooks. É possível definir gatilhos 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 acionadores que são a primeira etapa para determinar se uma ação condicional é aplicável. Confira a seguir os tipos de acionador 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 que o LLM decida a próxima ação: ativado sempre que o LLM prevê a próxima ação.
    • Antes que o LLM execute a próxima ação: acionado sempre que o LLM executa uma ação.
  • Evento
    • Evento personalizado
    • Nenhuma entrada do usuário

Condições

Depois que um acionador ocorre, 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, o acionador será usado sozinho para iniciar ações.

Use a seguinte sintaxe para fazer referência a parâmetros e ações anteriores/seguintes:

  • Parâmetros de sessão
    • $session.params.PARAMETER_NAME
  • Parâmetros de entrada do playbook
    • $playbook.input.INPUT_FIELD_NAME
  • Última ação (ação executada anteriormente)
    • $last-action.name
    • $last-action.input.INPUT_FIELD_NAME
    • $last-action.output.OUTPUT_FIELD_NAME
    • $last-action.status
  • Próxima ação (próxima ação prevista pelo LLM)
    • $next-action.name
    • $next-action.input.INPUT_FIELD_NAME

Você também pode usar funções do sistema.

Exemplos:

  • $session.params.current_user = null
  • $last-action.name = "query_order"
  • $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 ocorrerem, você poderá configurar as seguintes ações:

  • Fornecer uma resposta ao usuário final: texto, resposta condicional, payload do cliente
  • Substituir a próxima ação do LLM: uso da ferramenta, invocação do playbook, conclusão do playbook, invocação do fluxo, transição do playbook, transição do fluxo
  • Mudar as configurações de fala: nome do modelo, sem tempo limite de fala, sensibilidade do endpointer, adaptação
  • Ativar a interrupção
  • Permitir o cancelamento da reprodução de resposta parcial
  • Enviar SMS do Assistente de chamadas
  • Ativar DTMF: consulte DTMF para integrações de telefonia.