Skip to main content
Um assistente de etapa é um agente de IA amarrado a uma etapa do funil. Quando o projeto entra ou sai daquela etapa, o assistente roda sozinho, recebe o contexto do projeto e devolve um resultado que é gravado de volta no projeto.
A diferença para uma automação é o tipo de trabalho. A automação executa ações determinadas — mover, notificar, criar. O assistente produz conteúdo: resume, classifica, redige, extrai informação de um texto solto.

Onde configurar

Dois caminhos levam ao mesmo lugar:
  • Pelo menu Assistentes de etapa, que lista todos os assistentes da conta com etapa, agente de IA e status.
  • Pelo botão Assistentes dentro da configuração de uma etapa, já vinculado a ela.

Como configurar

1

Nome

Identifica o assistente nas listas e nos registros de execução.
2

Agente de IA

Qual agente executa a tarefa. O agente traz o modelo e as ferramentas; o assistente traz o momento e a instrução.
3

Etapa

A etapa do funil à qual o assistente pertence.
4

Prompt

A instrução dada ao agente. Aceita sintaxe avançada, então o prompt pode incorporar dados do projeto e da etapa em vez de ser um texto fixo. Veja Sintaxe avançada.
5

Executar quando

O gatilho: ao entrar na etapa, ao sair da etapa ou manualmente.
6

Saída e tratamento de falha

Onde o resultado é gravado e o que acontece se a execução falhar. Detalhado abaixo.

Quando o assistente roda

Entrar na etapa

Dispara quando o projeto é movido para a etapa. É o gatilho mais usado: o item chega e já vem processado.

Sair da etapa

Dispara quando o projeto deixa a etapa. Bom para consolidar o que foi feito ali antes de seguir.

Manual

Só roda quando alguém pede. Para tarefas que dependem de julgamento sobre quando fazer.
Assistentes com gatilho automático podem ganhar também a opção Habilitar execução manual, que permite rodá-los sob demanda sem perder o disparo automático. Útil para reprocessar um caso específico.
Apenas assistentes ativos são executados. Um assistente inativo continua salvo e editável, mas nunca dispara.

O que fazer com o resultado

O resultado do assistente pode ser gravado de duas formas, e as duas podem ser usadas ao mesmo tempo.
O resultado é salvo como conteúdo do projeto, junto do restante do material. É a opção direta, boa para resumos, análises e textos redigidos.
Para gravar em campo de formulário, peça a saída no formato certo dentro do próprio prompt. “Responda apenas com uma das opções: baixo, médio, alto” produz um resultado que cabe em um campo de seleção; “analise o caso” não.

Quando a execução falha

Chamadas de IA falham por motivos variados: o modelo indisponível, um tempo de resposta estourado, saldo insuficiente. Você decide o que acontece com o projeto nesse caso. A opção Mover para a etapa em caso de falha envia o projeto para uma etapa escolhida quando a execução não dá certo. Se nenhuma etapa for indicada, o projeto fica onde está.
Uma etapa de “Revisão manual” como destino de falha transforma o erro em fila de trabalho, em vez de deixar itens travados sem ninguém perceber.

Acompanhando as execuções

Cada execução gera um registro, acessível pelo botão Execuções do assistente. O registro guarda o resultado, o momento da execução e o desfecho de cada destino separadamente — é possível a gravação no conteúdo do projeto dar certo e a gravação no campo de formulário falhar, e o registro mostra isso.
A execução é assíncrona. O projeto se move na hora e o assistente roda em seguida, em segundo plano. Resultados aparecem alguns instantes depois da movimentação.

Custo e limites

Assistentes consomem créditos de IA. Um assistente com gatilho automático roda a cada movimentação, então o custo acompanha o volume do funil. Veja Créditos de IA.
A quantidade de assistentes de etapa também é limitada pelo plano. Ao atingir o teto, a criação de novos assistentes é bloqueada.

Arquivar

Assistentes podem ser arquivados e desarquivados. Arquivar preserva a configuração e o histórico de execuções, mas tira o assistente de operação.

Próximos passos

Automações

Para ações determinadas, em vez de conteúdo gerado.

Créditos de IA

Como o consumo é medido e recarregado.