Selo de estado:
Beta— a área de agentes é liberada por workspace. Atualizado em 2026-10-03.
Em IA → Agentes, clique em Criar agente (canto superior direito).
1. Escolha um ponto de partida#
A tela pergunta O que você deseja criar? e oferece dois caminhos.
Descrever com as suas palavras. No campo "Descreva o que você gostaria que esse agente fizesse" você escreve em português — por exemplo "quero um agente que acompanhe vendas e me avise quando uma região cair" — e clica em Montar meu agente (durante: "Montando…"). A tela mostra o resultado sob o título Confira se é isto, com as linhas Nome, O que ele faz, Dados, Ferramentas e Memória. Aí você segue com Criar e continuar configurando ou volta com Escrever de outro jeito.
Partir de um template. Em Ou escolha por área estão as categorias Analisar dados, Financeiro, Comercial, Marketing, Operações e Agente personalizado, com modelos prontos — Diretor Comercial, Analista Financeiro, Monitor de Pipelines e outros. O botão do cartão é Usar template (no personalizado, Descrever o meu).
Nada é criado até você confirmar: a própria tela diz "Você revisa antes de qualquer coisa ser criada."
2. A tela do agente e suas abas#
Depois de criado, o agente abre numa tela só, com o nome no topo e os botões Salvar rascunho e Publicar. Logo abaixo ficam as abas:
| Aba | Para que serve |
|---|---|
| Desenho | Onde o agente é montado: o que ele sabe fazer, o que pode ler, a quem pode perguntar |
| Testar | Conversar com o agente para ver se ele responde direito (Acompanhar) |
| Atividade | Cada execução, com passos, custo e o que ele propôs (Acompanhar) |
| Agenda | Fazer o agente rodar sozinho no horário (Agendamento) |
| Memória | O que ele guardou e o que espera confirmação (Memória) |
Trocar de aba não perde nada: o desenho que você ainda não salvou continua lá quando você volta.
3. Escreva o que ele deve fazer#
No campo O que este agente deve fazer, explique como você explicaria para uma pessoa nova no time. Ex.: "acompanhar receita e pedidos por região, e apontar o que saiu do padrão". É a partir daqui que o agente decide o que responder.
4. Monte o agente no Desenho#
O desenho mostra a linha principal — Quem pergunta → O agente → Resposta — e, ao lado, a lista Arraste (ou clique) para o desenho, separada em quatro grupos:
- O que ele sabe fazer — as ferramentas: Consultar dados, Consultar documentos, Ver o catálogo, Montar gráfico, Consultar painéis, Ver execuções, Reprocessar pipeline, Enviar por e-mail, Enviar no WhatsApp, Chamar uma API externa e Conectar ferramenta externa (MCP). As que ainda não existem aparecem com em breve — o produto prefere dizer isso a esconder a opção.
- Tabelas que ele pode ler — as tabelas do seu datalake.
- Documentos — as bases de Conhecimento.
- Especialistas — outros agentes publicados (Equipes).
Ligar a caixa é dar a permissão
O que está ligado no agente é o que ele pode usar — e nada mais. Uma tabela que não está no desenho não existe para ele. Para tirar, use Tirar do desenho na caixa.
Ponha as caixas
Arraste (ou clique) cada item que o agente vai usar. O que já está no desenho aparece apagado na lista, com a dica "Já está no desenho".
Clique numa caixa para ver o que ela faz
Abre um painel com O que faz, O que NÃO faz e o risco dela: "Só lê. Nunca altera nada.", "Faz alterações de verdade." ou "Sai para fora do ingestia.io."
Confira o que ela entrega
Nas caixas de consulta, Ver o que esta caixa entrega mostra uma prévia do que o agente vai receber.
Decida sobre a confirmação
Nas caixas que mudam alguma coisa, Pedir minha confirmação antes de agir vem ligado. É o padrão seguro: o agente propõe e espera uma pessoa decidir.
Organize, se quiser
Arrumar reorganiza as caixas na tela. Não muda o que o agente pode fazer.
Enviar o resultado por e-mail ou WhatsApp
As caixas Enviar por e-mail e Enviar no WhatsApp levam a resposta do agente para fora. Quem recebe é você que define, nunca o agente:
Ponha a caixa no desenho
Arraste Enviar por e-mail ou Enviar no WhatsApp para o desenho.
Abra a caixa
Clique nela. Aparece a lista Quem recebe.
Acrescente os destinatários
Digite o e-mail (ex.: nome@empresa.com) ou o celular com DDD e clique no + (Acrescentar). Repita para cada pessoa.
Salve
Clique em Salvar rascunho e, quando estiver pronto, Publicar.
Ao final você deve ver: os nomes na lista Quem recebe. Sem ninguém cadastrado, a caixa não manda nada — o agente avisa em vez de falhar em silêncio. No WhatsApp, quem responder SAIR para de receber, sem você precisar fazer nada.
Para mandar o resultado todo dia no mesmo horário, combine a caixa de envio com a aba Agenda (Agendamento).
5. Ajustes opcionais#
A configuração tem três níveis, e você troca entre eles no topo:
| Nível | O que ele mostra |
|---|---|
| Simples | "O essencial. A plataforma decide o resto por você." |
| Avançado | "Modelo, memória e limites, quando você quiser mandar neles." |
| Expert | "Instruções de sistema e políticas. Para quem opera IA." |
No modo Avançado aparecem:
- Modelo — deixe em Automático (recomendado). A plataforma escolhe considerando qualidade, custo e disponibilidade, e troca sozinha se um provedor falhar.
- Memória — o que ele lembra de uma conversa para outra: Sem memória, Lembrar desta conversa, Lembrar preferências de quem pergunta ou Memória da empresa.
- Otimizar para — Equilíbrio, Qualidade, Velocidade ou Menor custo.
- Limite de etapas — quantos passos ele pode dar numa resposta.
Quando o agente coordena outros, aparece Especialistas da equipe: ele só pode perguntar a quem estiver marcado ali.
No modo Expert aparece o campo Instruções de sistema, onde você escreve regras da empresa em texto livre; elas têm a última palavra sobre o que o agente aprendeu sozinho.
O teto de gasto por execução existe na definição do agente, mas hoje não tem campo nesta tela: sem valor próprio, vale o teto do workspace. Dizemos isso em vez de mandar você procurar um campo que não está lá.
6. Teste antes de publicar#
Salvar rascunho guarda o que você montou sem publicar nada. Abra a aba Testar para experimentar: enquanto o agente não está publicado, a própria tela avisa que você está testando o rascunho. Depois de cada resposta, Ver como cheguei a essa resposta mostra o caminho que ele fez.
7. Publique#
Publicar congela uma versão — e é essa versão que atende as pessoas. Se faltar alguma coisa, a tela diz o que falta, em português, em vez de só desabilitar o botão: "Para publicar, falta …", seguido do que precisa ser feito.
Enquanto não publicar, o agente fica como Rascunho e não responde a mais ninguém.
Ao final você deve ver: o selo Ativo e a versão publicada no topo da tela, e o cartão do agente em IA → Agentes com o mesmo selo.
Depois de publicado#
- Aba Testar — perguntar a ele
- Aba Desenho — ajustar e publicar de novo
- Aba Atividade — cada execução, com passos, custo e o que ele propôs
- Aba Agenda — fazer ele rodar sozinho
- Aba Memória — ver e apagar o que ele lembra
- Pausar / Ativar — tirar do ar sem apagar nada
- Duplicar (ícone de cópia, no cartão da lista) — a cópia nasce sempre em rascunho
Na lista de agentes, os botões Conversar, Configurar e Atividade de cada cartão abrem as mesmas telas direto, sem passar pelas abas.
Quem pode o quê#
| Ação | Quem pode |
|---|---|
| Ver a lista | Qualquer pessoa do workspace |
| Conversar | Membro ou acima |
| Criar, configurar e publicar | Administrador ou acima |