Criar um agente de IA no builder

Monte um agente de IA que atende os seus contatos automaticamente, passando pelo assistente em quatro passos: identidade, comportamento, conhecimento e configurações.
🧩 Este recurso faz parte do módulo Agentes Inteligentes. Se ele não aparecer na sua conta, fale com o administrador para ativá-lo. Veja [Entender planos, módulos e o que está incluído](/books/comece-por-aqui/page/entender-planos-modulos-e-o-que-esta-incluido).
📹 VÍDEO — Passo a passo completo: abrir o assistente, preencher o passo Perfil, escrever as instruções em Comportamento, vincular uma base em Conhecimento e escolher o provedor em Configurações. Cole o embed do YouTube neste ponto.
Objetivo
Criar um agente de IA no assistente e salvá-lo pronto para uso.
Pré-requisitos
Perfil Administrador
Módulo Agentes Inteligentes ativo
Pelo menos um provedor de IA cadastrado (veja Configurar seu provedor de IA (chave própria))
Acesse pelo computador — esta tela não está disponível no celular
Tempo estimado
10 minutos.
Caminho de acesso
Bots → Agentes Inteligentes → aba Agentes → Novo agente
Passo a passo
Na aba Agentes, clique em Novo agente. Abre o assistente com os passos Perfil, Comportamento, Conhecimento e Configurações na lateral.
🖼️ PRINT — Janela Novo agente com a navegação lateral (Perfil, Comportamento, Conhecimento, Configurações) e o passo Perfil aberto.
No passo Perfil, preencha o Nome (obrigatório) e, se quiser, um Apelido. Defina o Tom (ex.: Consultivo e Acolhedor), o Formato / comprimento, o Perfil (ex.: Vendedor, SDR, Suporte) e o Objetivo do agente. Use Assinar a conversa para acrescentar a assinatura ao fim de cada resposta.
No passo Comportamento, escreva as Instruções (system prompt) que orientam o agente e, se necessário, Outras regras / restrições. Dicas de redação em Escrever boas instruções (prompt) para o agente.
No passo Conhecimento, marque as bases que o agente pode consultar. Para criar bases, veja Alimentar a base de conhecimento (upload de documentos / RAG).
No passo Configurações, escolha o Provedor (obrigatório) e o Modelo. Ajuste, se quiser, Máx. turnos, Máx. tokens e a Transferência para humano (veja Definir supervisão humana e hand-off para agente humano).
Clique em Salvar.
Resultado esperado
Aparece a mensagem "Agente criado" e o agente passa a constar na aba Agentes como um card. Todo agente novo nasce como Rascunho — ao editá-lo, mude o Status para Ativo no passo Configurações quando estiver pronto para atender.
Erros comuns
Sintoma: aparece "Selecione um provedor de IA (passo Configurações)". Solução: o assistente abre o passo Configurações — escolha um Provedor. Se a lista estiver vazia, cadastre um em Configurar seu provedor de IA (chave própria).
Sintoma: aparece "Nome é obrigatório". Solução: volte ao passo Perfil e preencha o Nome.
Sintoma: a tela mostra "Acesso restrito". Solução: apenas administradores gerenciam agentes; peça o perfil ao administrador.
Artigos relacionados
Configurar seu provedor de IA (chave própria)
Escrever boas instruções (prompt) para o agente
Alimentar a base de conhecimento (upload de documentos / RAG)
Definir supervisão humana e hand-off para agente humano