Montar um agente

Um agente é um fluxo de etapas. Ele recebe dados, executa etapas em ordem e termina entregando um resultado.

Entrada  →  Etapa  →  Etapa  →  …  →  Resultado

As quatro perguntas de todo agente

Pergunta	Onde se responde
O que ele recebe?	Os campos de entrada
O que ele faz?	As etapas
Como decide o caminho?	Condições e escolhas
O que ele devolve?	A etapa Resultado

Os campos de entrada

Declare o que o agente recebe quando é acionado: nome, tipo, se é obrigatório e, quando fizer sentido, as opções válidas.

Tipo	Uso
Texto	Conteúdo livre
Número	Valores numéricos
Sim/não	Chaves de comportamento
Data e Data e hora	Períodos e prazos
Escolha entre opções	Um valor de uma lista fechada
Objeto e Lista	Estruturas vindas de outro sistema

Os campos declarados viram o formulário da execução manual, o formulário do agendamento e o contrato de quem chama por HTTP — os três, a partir da mesma declaração.

Declare opções em vez de texto livre

Um campo de escolha evita a classe inteira de falhas em que alguém digita "Financeiro" onde a condição compara com financeiro.

As etapas

São treze, em quatro famílias:

Família	Etapas
Dados	Consultar API · Reorganizar dados · Consultar dados corporativos · Executar automação · Preparar dados
Inteligência	Tarefa com IA · Gerar com um modelo
Controle	Condição · Escolher um caminho · Combinar resultados · Para cada item · Aguardar · Aprovação humana · Chamar outro agente
Saída	Resultado

Cada uma, com quando usar e o que produz, está em Tipos de etapa.

O resultado

Todo agente precisa de pelo menos uma etapa Resultado. É o que a API devolve a quem o acionou, e é onde você escolhe quais campos entregar.

A execução termina com sucesso no instante em que um Resultado conclui.

Os limites

Todo agente declara três freios, conferidos contra os tetos do espaço no momento da publicação:

Limite	O que faz
Tempo limite	Prazo total da execução. Estourou, a execução termina como expirada
Máximo de iterações	Teto de trabalho das etapas com IA
Profundidade de subagentes	Até onde a cadeia de agente-chamando-agente pode ir

Ver Limites.

Regras que a publicação verifica

A publicação recusa um fluxo estruturalmente quebrado — e a mensagem aponta a etapa:

• toda etapa precisa ser alcançável a partir do início;
• toda etapa que não é Resultado precisa ter saída;
• não pode haver ciclo entre etapas;
• precisa haver pelo menos um Resultado;
• um dado só pode ser referenciado por uma etapa que roda depois de quem o produz;
• toda etapa referenciada precisa existir.

Isso é deliberado: um beco sem saída descoberto às três da manhã custa muito mais caro que uma publicação recusada agora.

Nas páginas desta seção

🧩Tipos de etapa

As treze etapas, com quando usar cada uma.

Abrir →✨Tarefa com IA

A etapa mais poderosa — e como saber se ela cumpriu o objetivo.

Abrir →🔗Dados entre etapas

Como um dado sai de uma etapa e chega na outra.

Abrir →🔀Caminhos e repetição

Condições, escolhas, junções e laços.

Abrir →⏸️Aprovação e espera

Pausar por uma decisão humana ou por tempo.

Abrir →🌐Consultar uma API

Chamar um sistema externo com segurança.

Abrir →🗄️Consultar dados corporativos

Ler dados governados do Infinite Data.

Abrir →🔌Conexões

Servidor e credencial com nome próprio, usados pelo nome.

Abrir →🧰Componentes de sistema

E-mail, banco, SSH, SFTP, storage e CSV.

Abrir →🪝Chamar outro agente

Compor agentes sem duplicar lógica.

Abrir →🛟Quando algo falha

Tentativas, caminho de erro e degradação declarada.

Abrir →🧪Testar antes de publicar

Testar uma etapa isolada e fixar dados de exemplo.

Abrir →📚Modelos prontos

Dez agentes prontos para aplicar.

Abrir →

Próximos passos

• Tipos de etapa
• Publicar e ambientes