# 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.

<p class="callout warning">🧩 Este recurso faz parte do módulo <strong>Agentes Inteligentes</strong>. 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).</p>

<p class="callout success">📹 <strong>VÍDEO</strong> — Passo a passo completo: abrir o assistente, preencher o passo <strong>Perfil</strong>, escrever as instruções em <strong>Comportamento</strong>, vincular uma base em <strong>Conhecimento</strong> e escolher o provedor em <strong>Configurações</strong>. Cole o embed do YouTube neste ponto.</p>

## 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)](/books/agentes-de-ia/page/configurar-seu-provedor-de-ia-chave-propria))
- 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
1. Na aba **Agentes**, clique em **Novo agente**. Abre o assistente com os passos **Perfil**, **Comportamento**, **Conhecimento** e **Configurações** na lateral.

<p class="callout info">🖼️ <strong>PRINT</strong> — Janela <strong>Novo agente</strong> com a navegação lateral (<strong>Perfil</strong>, <strong>Comportamento</strong>, <strong>Conhecimento</strong>, <strong>Configurações</strong>) e o passo <strong>Perfil</strong> aberto.</p>

2. 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.
3. 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](/books/agentes-de-ia/page/escrever-boas-instrucoes-prompt-para-o-agente).
4. No passo **Conhecimento**, marque as bases que o agente pode consultar. Para criar bases, veja [Alimentar a base de conhecimento (upload de documentos / RAG)](/books/agentes-de-ia/page/alimentar-a-base-de-conhecimento-upload-de-documentos-rag).
5. 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](/books/agentes-de-ia/page/definir-supervisao-humana-e-hand-off-para-agente-humano)).
6. 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)](/books/agentes-de-ia/page/configurar-seu-provedor-de-ia-chave-propria).
- **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)](/books/agentes-de-ia/page/configurar-seu-provedor-de-ia-chave-propria)
- [Escrever boas instruções (prompt) para o agente](/books/agentes-de-ia/page/escrever-boas-instrucoes-prompt-para-o-agente)
- [Alimentar a base de conhecimento (upload de documentos / RAG)](/books/agentes-de-ia/page/alimentar-a-base-de-conhecimento-upload-de-documentos-rag)
- [Definir supervisão humana e hand-off para agente humano](/books/agentes-de-ia/page/definir-supervisao-humana-e-hand-off-para-agente-humano)