---
title: Criar seu primeiro Agent
description: Passo a passo para criar e publicar seu primeiro Agent no Atende Direito em poucos minutos.
---

# Criar seu primeiro Agent

Vamos criar juntos um Agent simples — um atendente que recebe mensagens dos seus clientes, entende o que eles precisam e responde de forma amigável. Depois que você entender o básico, é só personalizar.

<Captura legenda="Tela inicial do Agent Builder com a listagem de agents" src="/img/agents-lista.png" />

## Antes de começar

Você vai precisar de:
- Acesso ao Agent Builder (menu lateral da plataforma)
- Pelo menos um modelo de IA configurado (ex.: GPT-4o, Claude Sonnet)

<Dica>

Se você ainda não tem um modelo configurado, peça ao administrador da sua conta para habilitar um provedor de IA nas configurações da plataforma.

</Dica>

<Secao icon="list-checks">Passo a passo</Secao>

<Passos>
  <Passo>

**Abra o Agent Builder** no menu lateral da plataforma e clique em **Novo Agent**.

<Captura legenda="Menu lateral com Agentes destacado e tela de listagem de agents" src="/img/agents-lista.png" />

  </Passo>
  <Passo>

**Preencha o nome e a descrição** do Agent na aba **Identidade**. Escolha um nome que identifique claramente o papel dele — por exemplo, "Atendente de Dúvidas Jurídicas" ou "Assistente de Vendas".

Ainda na aba Identidade, defina a **aparência** do Agent: uma **cor** (código hexadecimal, no formato `#RRGGBB`) e um **ícone**, escolhido entre os ícones disponíveis na plataforma. Essa cor e ícone formam o **badge** do Agent — a marca visual que aparece no painel de conversa toda vez que ele responde um cliente. Um preview do badge é exibido ali mesmo enquanto você escolhe, para conferir como vai ficar.

<Captura legenda="Aba Identidade do assistente de criação do Agent, com os campos Nome, Descrição, Tipo e Instrução (System Prompt)." src="/img/agents-wizard-identidade.png" />

<Dica>

Cor e ícone são opcionais, mas ajudam bastante quem acompanha o atendimento: quando vários agents atuam no mesmo canal, o badge colorido no chat deixa claro, num olhar, **qual** agent respondeu cada mensagem. Veja como o badge aparece em [Controle da IA no chat → Quem respondeu cada mensagem](/guia/atendimento/controle-da-ia-no-chat#quem-respondeu-cada-mensagem).

</Dica>

  </Passo>
  <Passo>

**Escolha o tipo** do Agent. Para começar, selecione **LLM** (o mais simples — um único modelo que recebe suas instruções e responde). Você pode mudar o tipo depois.

<Captura legenda="Formulário de identidade do agent com as opções de tipo LLM, Sequencial, Paralelo e Loop" src="/img/agents-wizard-identidade.png" />

  </Passo>
  <Passo>

**Escreva as instruções** do Agent. Esse é o coração da configuração — é aqui que você "treina" seu atendente. Explique em linguagem natural: quem ele é, como deve se comportar, quais temas pode responder e quais deve recusar.

Exemplo:
```
Você é um assistente de atendimento da empresa Advocacia Silva. 
Responda dúvidas sobre nossos serviços de forma educada e objetiva.
Não forneça aconselhamento jurídico específico — oriente o cliente a agendar uma consulta.
```

<Captura legenda="Campo Instrução (System Prompt) do Agent preenchido com um exemplo de instrução, na aba Identidade." src="/img/agent-instrucoes-campo.png" />

  </Passo>
  <Passo>

**Selecione o modelo de IA** na seção "Modelo". Escolha o provedor (ex.: OpenAI) e o modelo (ex.: `gpt-4o`). Para a maioria dos casos, as configurações padrão já funcionam bem.

<Captura legenda="Seção Modelo no formulário de identidade do agent" src="/img/agents-wizard-identidade.png" />

  </Passo>
  <Passo>

**Salve e teste** o Agent. Use o botão **Testar** (ou o painel de chat lateral) para enviar uma mensagem e ver como ele responde. Ajuste as instruções se necessário.

  </Passo>
  <Passo>

**Publique o Agent** quando estiver satisfeito com o comportamento. A partir daí, ele pode ser chamado dentro de um fluxo ou vinculado a um canal de atendimento.

<Captura legenda="Revisão e publicação do Agent — confirmação antes de ativar o fluxo" src="/img/agents-wizard-revisao.png" />

  </Passo>
</Passos>

<Cuidado>

**Editar um Agent já publicado não muda o comportamento em produção até você publicar de novo.** A plataforma sempre roda a versão congelada da última publicação — não o estado "ao vivo" das suas configurações. Se você editar Skills, MCP Servers, Ferramentas de Função, Conhecimento ou qualquer outro recurso do Agent depois de publicá-lo pelo menos uma vez, ele fica marcado internamente como desatualizado em relação à configuração atual. As conversas continuam usando a versão antiga até você clicar em **Publicar** de novo — aí a marcação some e a nova versão passa a valer.

</Cuidado>

## Próximos passos

Agora que seu Agent está no ar, você pode aprofundar cada área:

- [Instruções e modelo](/guia/agents/instrucoes-modelo) — como escrever boas instruções e configurar o modelo de IA
- [Memória](/guia/agents/memoria) — fazer o Agent lembrar de conversas anteriores
- [Conhecimento](/guia/agents/conhecimento) — conectar documentos e bases de dados ao Agent
- [Guardrails](/guia/agents/guardrails) — definir regras de segurança e comportamento
- [Ferramentas](/guia/agents/ferramentas) — dar superpoderes ao Agent (busca web, conexões externas, MCP)

<Cuidado>

Um Agent publicado começa a responder imediatamente quando acionado por um fluxo ou canal. Teste sempre antes de vincular a um canal de produção.

</Cuidado>