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 um controle mais 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 gatilhos, que são a primeira etapa para determinar se uma ação condicional é aplicável. Veja a seguir os tipos de gatilho e os gatilhos 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 que o LLM execute a próxima ação: acionado sempre antes que o LLM execute 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, somente o acionador será usado para iniciar as ações.

Use a seguinte sintaxe para referenciar 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 (ação prevista pelo LLM)
    • $next-action.name
    • $next-action.input.INPUT_FIELD_NAME

Também é possível 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 acionador 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 personalizado e áudio pré-gravado. Ao fornecer texto, é possível inserir [pause], [pauseShort] ou [pause long] para injetar 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 de playbook, conclusão de playbook, invocação de fluxo, transição de playbook, transição de fluxo.
  • Mudar as configurações de fala: nome do modelo, tempo limite sem fala, sensibilidade do endpoint, adaptação.
  • Ativar interrupção
  • Permitir o cancelamento da reprodução de respostas parciais
  • Enviar SMS do Call Companion
  • Ativar DTMF: consulte DTMF para integrações de telefonia.