Referência de Ações

Ações são os blocos de construção que você adiciona em:

• Workflows > Passos
• Agentes de IA > Ações para pré-ações e pós-ações
• Botões de notificação que executam lógica de acompanhamento

Cada ação faz um trabalho: chamar uma API, enviar uma mensagem, atualizar um registro, executar outro workflow ou preparar dados para passos posteriores.

Nem toda ação está disponível em todo construtor. Algumas ações só fazem sentido em workflows, algumas são projetadas para pré-ações ou pós-ações de assistentes, e algumas requerem um contexto de conversa ativo.

Como usar esta referência

Use estas páginas para responder a três perguntas práticas:

1. Qual ação devo escolher?
2. Quais campos preciso preencher?
3. Qual resultado posso reutilizar em um passo posterior?

Se você precisar de ajuda para escrever expressões para campos dinâmicos, consulte o Editor de Expressões CEL.

Reutilizando resultados de passos anteriores

A maioria das ações disponibiliza dados para passos posteriores. Você geralmente os referencia com step(0), step(1) e assim por diante.

Exemplos:

• step(0).data
• step(1).status
• step(2).choices[0].message.content

Use Depurar tudo ou depuração passo a passo para inspecionar o formato exato da saída antes de criar condições baseadas nela.

Metadados compartilhados de execução

Quando você quer saber como um passo em si foi executado, use o objeto aninhado executionContext. Isso mantém os metadados do executor separados das saídas próprias da ação.

Campos comuns:

• step(0).executionContext.status -- running, completed, skipped ou failed
• step(0).executionContext.startedAt
• step(0).executionContext.finishedAt
• step(0).executionContext.safeError.code
• step(0).executionContext.safeError.userMessage
• step(0).executionContext.safeError.retryable
• step(0).executionContext.safeResult

Exemplos:

• get(step(0), 'executionContext.status') == 'completed'
• get(step(1), 'executionContext.safeError.code') == 'unsupported_media_format'
• get(step(2), 'executionContext.safeResult.reason') == 'condition_false'

safeError e safeResult são sanitizados para ramificação e depuração. Eles não incluem stack traces brutos, segredos ou payloads do provedor.

Algumas ações já usam campos de nível superior como step(N).status para suas próprias saídas, por exemplo, um código de status HTTP. Prefira step(N).executionContext.status quando você se refere ao resultado da ação em si.

Disponibilidade e contexto

• Use ações de conversa apenas quando a execução atual já possui uma conversa para trabalhar.
• Use ações específicas de assistente apenas onde ações de assistente são suportadas.
• Se uma ação depende de um recurso específico, como memória de conversa ou um workflow filho, certifique-se de que esse recurso já está configurado antes de confiar na ação em produção.

Categorias

Categoria	Uso típico
IA e assistentes	Gerar texto, enviar trabalho para outro assistente, limpar memória ou encerrar uma sessão de assistente
Dados	Criar, buscar, pesquisar, atualizar, excluir ou acionar workflows em seus dados da empresa
Mensagens	Enviar respostas para a conversa atual ou enviar mensagens proativamente a um cliente
Integrações	Chamar APIs externas com requisições HTTP
Mídia	Salvar arquivos no storage e reutilizar suas URLs
Notificações	Alertar membros da equipe dentro do AutoTalk
Segurança	Gerar tokens JWT temporários
Estado da sessão	Armazenar valores para expressões CEL posteriores na mesma execução

Escolhendo a ação certa

• Use Gerar Resposta LLM quando quiser saída direta do modelo.
• Use Enviar Mensagem ao Assistente quando quiser que outro assistente trate a requisição.
• Use Compor Resposta da Conversa quando quiser responder na conversa atual.
• Use Enviar Mensagem ao Cliente quando precisar enviar uma mensagem diretamente a um cliente específico.
• Use Pesquisar Dados da Empresa quando precisar de uma lista.
• Use Buscar Dados da Empresa quando já souber qual registro deseja.
• Use Executar Workflow quando quiser que um workflow chame outro.

Ações que não retornam campos reutilizáveis

Algumas ações são principalmente efeitos colaterais e não fornecem um resultado de passo significativo para reutilizar.

Exemplos comuns:

• Limpar Memória da Conversa
• Finalizar Sessão do Assistente
• Criar Notificação do Profissional

Use-as quando precisar do efeito em si, não de um valor para lógica posterior.