Skip to main content
Um agente é um funcionário de IA: tem um papel, instruções (a “personalidade” e as regras), habilidades, acesso a ferramentas e dados, e um nível de acesso por pessoa. Esta página ensina a criar e configurar do zero — sem depender de ninguém.
Lista de agentes

📸 Screenshot a inserir [/pt/inteligencia/agentes]: lista de Agentes (Inteligência → Agentes), com o botão 'Criar agente' destacado.

​
Criar um agente em 3 minutos

1

Abra Inteligência → Agentes e clique em “Criar agente”

Você verá duas formas de começar: descrever em linguagem natural (recomendado) ou preencher manualmente. Comece pela descrição — é mais rápido.
2

Descreva o papel com 1–3 frases concretas

Quanto mais específico, melhor o resultado. Compare:O iTeam já sugere nome, descrição, tom de voz e habilidades com base nisso.
3

Revise o rascunho

Ajuste nome e instruções se quiser. Você não precisa acertar tudo agora — dá para editar depois a qualquer momento.
4

Salve e teste

Abra o Chat com Agentes, selecione o agente e faça um pedido real (ex.: “qual foi o faturamento de ontem?”). Se ele pedir um dado/ferramenta que ainda não tem, volte e configure (próxima seção).

​
Configuração campo a campo

Abra um agente e você verá as seções abaixo. Aqui está o que cada uma faz e como preencher.
  • Nome: curto e reconhecível (“Analista Financeiro”). Aparece na lista do chat.
  • Papel: uma frase que resume a função. Ajuda você e a equipe a saber para que serve.
  • Ícone: escolha um ícone que represente a função — facilita achar na lista quando você tiver vários agentes.
É aqui que você define comportamento, prioridades e limites. Pense como um “manual do cargo”. Uma boa instrução costuma ter:
  1. Quem ele é e o objetivo — “Você é um analista de vendas. Seu objetivo é dar visibilidade rápida do faturamento.”
  2. Como agir — tom (formal/informal), formato preferido (“sempre responda com um número-chave + 1 gráfico”).
  3. Regras e limites — “Nunca envie e-mail sem aprovação.” / “Considere apenas pedidos pagos.”
  4. Contexto da empresa — termos, metas, definições (“FTD = primeiro depósito”).
Escreva as instruções como se estivesse treinando um funcionário no primeiro dia. Contexto vale mais que adjetivos.
Capacidades extras (buscar na web, gerar relatórios, etc.). Ative só as que o papel exige — menos habilidades = respostas mais focadas. Como funcionam as Skills →
Define a quais dados/sistemas o agente pode chegar. Sem isso, ele responde “no geral”; com isso, responde com os seus números.
  • Conecte a fonte em Recursos → Fontes de Dados e/ou APIs.
  • Depois, libere a fonte para este agente nesta seção.
  • Teste com uma pergunta simples (“quantas linhas tem a tabela X?”).
Por padrão fica em Automático — o iTeam escolhe o melhor modelo para cada pedido (rápido para perguntas simples, mais robusto para tarefas complexas). Só fixe um modelo específico se tiver um motivo claro; o automático cobre a maioria dos casos.
Define quem na empresa enxerga e usa este agente. Há três níveis:Owner/Admin da empresa têm acesso a tudo automaticamente. Para os demais, conceda explicitamente — ou dê acesso por projeto (quem tem o projeto herda o agente). Detalhes em Segurança & Acessos →
O acesso ao agente vale também para os widgets dele: quem não tem acesso ao agente não vê seus widgets.
Lista as telas interativas que o agente criou e deixa você montar o menu (ordenar, agrupar). Tudo sobre Widgets →
Edição de agente

📸 Screenshot a inserir [/pt/inteligencia/agentes]: tela de edição do agente, mostrando as abas/seções (Identidade, Instruções, Skills, Ferramentas, Acesso).

​
Receitas prontas (copie e adapte)

Papel: “Analista de dados que responde perguntas sobre faturamento, depósitos e clientes a partir do banco da empresa.” Configurar: conecte a Fonte de Dados; libere para o agente; nas instruções, defina os termos do negócio. Teste: “faturamento dos últimos 7 dias por dia, em gráfico”.
Papel: “Gera e envia o resumo diário de vendas.” Configurar: crie o agente, depois crie uma Tarefa recorrente ou um Processo atribuído a ele. Dica: deixe o envio externo exigindo aprovação até confiar no resultado.
Papel: “Responde dúvidas de clientes com base na nossa base de conhecimento, no tom da marca.” Configurar: ative skills de busca; nas instruções, cole as regras de atendimento.

​
Boas práticas

Um papel claro por agente

Agentes focados respondem melhor. Prefira vários especialistas a um “faz-tudo”.

Dê contexto nas instruções

Termos, metas e definições da empresa = respostas certeiras.

Menor acesso necessário

Conceda só as fontes/skills que o papel exige. Mais seguro e mais rápido.

Evolua com o uso

Viu o agente errar um termo? Ajuste a instrução. Ele melhora a cada ajuste.

​
Solução de problemas

Falta conectar/liberar a fonte. Vá em Fontes de Dados, conecte, e na seção Ferramentas e Fontes do agente, libere-a para ele.
Enriqueça as Instruções com contexto da empresa e peça formato (“responda com número + gráfico”). Conecte uma fonte de dados real.
Ela não tem acesso. Dê o nível adequado em Acesso (ou via projeto). Veja Segurança & Acessos.
Refine a instrução para ser mais específico no objetivo. Em conversas muito longas, comece uma nova conversa para “limpar” o contexto.

​
Próximos passos

Times de Agentes

Junte agentes que trabalham em conjunto.

Conversar

Coloque seu agente para trabalhar.