# Criar um agente de IA

> No AI Hub, crie o agente, escreva a mensagem do sistema com as informações da empresa, confira o modelo e salve. Depois, defina o agente como padrão.

Endereço: https://help.nextags.com.br/tutoriais/ia/criar-agente/
Tipo: Tutorial · Intermediário

Atualizado em: 25/10/2026

> **Resposta rápida**
>
> No **AI Hub**, clique em **Adicionar Novo**, dê um nome ao agente e clique em **Continuar**. No editor, escreva a **Mensagem do sistema** e clique em **Salvar**. Para o agente responder sozinho aos contatos, defina como padrão.

**Antes de começar**

- Um provedor de IA conectado. Veja [Conectar a OpenAI](https://help.nextags.com.br/tutoriais/ia/conectar-openai/), [Conectar o Google Gemini](https://help.nextags.com.br/tutoriais/ia/conectar-gemini/) ou [Conectar o Claude, o xAI ou o DeepSeek](https://help.nextags.com.br/tutoriais/ia/conectar-claude-xai-deepseek/).
- As informações que o agente vai usar: o que a empresa vende, horários, entregas, formas de pagamento e o que ele não pode prometer.

## Passo a passo

### Passo 1: Abra o AI Hub e clique em Adicionar Novo

No menu, clique em **AI Hub**. Na aba **Agentes de IA**, clique em **Adicionar Novo** (1).

![AI Hub na aba Agentes de IA, com o botão Adicionar Novo.](https://help.nextags.com.br/_img/ia-agentes/adicionar-novo.webp)
*1. Adicionar Novo.*

1. **Adicionar Novo**: cria um agente. Se a conta ainda não tem nenhum, o botão se chama **Criar Agente**.

### Passo 2: Dê um nome ao agente

Escreva um nome que diga para que serve o agente (1) e clique em **Continuar** (2). O editor do agente abre em seguida.

![Janela Adicionar Novo com o nome do agente preenchido e os botões Cancelar e Continuar.](https://help.nextags.com.br/_img/ia-agentes/nome-do-agente.webp)
*1. O nome do agente. 2. Continuar.*

1. O nome do agente, que aparece na lista do AI Hub. Exemplo: "Bia — Doce Encanto".
2. **Continuar**: cria o agente e abre o editor.

### Passo 3: Escreva a mensagem do sistema

No campo **Mensagem do sistema** (1), escreva quem é o agente, o que ele sabe sobre a empresa e como deve responder. Se o campo vier com um texto de exemplo, troque pelo seu.

![Editor do agente: o campo Mensagem do sistema (Prompt) com as instruções de uma confeitaria de exemplo e o ícone de ajustes à direita.](https://help.nextags.com.br/_img/ia-agentes/mensagem-do-sistema.webp)
*1. A mensagem do sistema. 2. Os ajustes do agente.*

1. **Mensagem do sistema (Prompt)**: as instruções do agente. O exemplo é de uma confeitaria fictícia.
2. O ícone de ajustes: o modelo de IA e o jeito de responder (próximo passo).

Como escrever um bom texto está em [Escrever a mensagem do sistema](https://help.nextags.com.br/tutoriais/ia/escrever-o-prompt/).

### Passo 4: Confira o modelo

Clique no ícone de ajustes, à direita de **Mensagem do sistema**. O agente já vem com um modelo escolhido para cada provedor conectado; troque só se precisar.

![Ajustes do agente: Tipo de resposta da IA, Modelo da OpenAI e do Claude com as setas de ordem, Temperatura, Max tokens, Reasoning effort e Verbosity.](https://help.nextags.com.br/_img/ia-agentes/ajustes.webp)
*Os ajustes do agente.*

1. **Tipo de resposta da IA**: só texto ou também mídia, botões e carrossel. Veja [Tipos de resposta](https://help.nextags.com.br/tutoriais/ia/respostas-elaboradas/).
2. **Modelo (OpenAI)**: o modelo do provedor. A lista vem da OpenAI.
3. **Modelo (Claude)**: cada provedor conectado tem o seu. As setas mudam a ordem dos provedores.
4. **Temperatura**: mais baixa, respostas mais previsíveis; mais alta, mais variadas. Vem com 0,4.
5. **Max tokens**: o tamanho máximo de cada resposta. Vem com 2048.
6. **Reasoning effort**: quanto o modelo pensa antes de responder. Só aparece com alguns modelos.
7. **Verbosity**: respostas mais curtas ou mais longas. Só aparece com alguns modelos da OpenAI.

Para fechar os ajustes, clique fora deles. Detalhes em [Modelo, temperatura e limite de tokens](https://help.nextags.com.br/tutoriais/ia/modelo-e-parametros/).

### Passo 5: Dê exemplos de conversa (opcional)

Embaixo da mensagem do sistema, clique em **Adicionar mensagens ao prompt** e escreva uma pergunta de cliente e a resposta que você espera. Os exemplos mostram ao agente o tom e o tamanho das respostas.

![Mensagens do prompt: um exemplo de pergunta do Usuário e de resposta do Assistente, com o botão Adicionar Novo.](https://help.nextags.com.br/_img/ia-agentes/exemplos.webp)
*1. Quem fala. 2. A resposta de exemplo. 3. Adicionar Novo.*

1. **Usuário** ou **Assistente**: escolha quem fala em cada mensagem. Usuário é o cliente; Assistente, o agente.
2. A resposta do agente no exemplo, no tom que você quer.
3. **Adicionar Novo**: acrescenta outra mensagem. O **X** apaga uma.

### Passo 6: Ações e ferramentas (opcional)

Mais abaixo ficam as **Ações de IA** e as **Ferramentas de IA**:

![Os cartões Ações de IA, com Adicionar regra, e Ferramentas de IA, com a lista para escolher as ferramentas.](https://help.nextags.com.br/_img/ia-agentes/acoes-e-ferramentas.webp)
*1. Adicionar regra. 2. Ferramentas de IA.*

1. **+ Adicionar regra**: o agente faz algo sozinho quando a situação que você descreve acontece, como pôr uma etiqueta ou transferir para a equipe. Veja [Ações de IA](https://help.nextags.com.br/tutoriais/ia/acoes-do-agente/) e [Quando o agente passa para a equipe](https://help.nextags.com.br/tutoriais/ia/passar-para-humano/).
2. **Ferramentas de IA**: o que o agente pode usar além do texto, como os arquivos, a pesquisa na web e as funções. Veja [Arquivos](https://help.nextags.com.br/tutoriais/ia/base-de-conhecimento/), [Pesquisa na web](https://help.nextags.com.br/tutoriais/ia/pesquisa-na-web/), [Funções de IA](https://help.nextags.com.br/tutoriais/ia/funcoes-do-agente/) e [Servidores MCP](https://help.nextags.com.br/tutoriais/ia/mcp-no-agente/).

### Passo 7: Salve

No alto da tela, clique em **Salvar** (1). A NexTags guarda o agente e volta para o AI Hub.

![A barra no alto da tela, com os botões Cancelar e Salvar.](https://help.nextags.com.br/_img/ia-agentes/salvar.webp)
*1. Salvar.*

1. **Salvar**: guarda o agente. **Cancelar** sai sem guardar o que você mudou.

## Pronto: como conferir

O agente aparece na lista do AI Hub, com a data em **Modificado** (1):

![O agente Bia — Doce Encanto no topo da lista de Agentes de IA, com a data de modificação.](https://help.nextags.com.br/_img/ia-agentes/agente-na-lista.webp)
*1. O agente novo na lista.*

1. O agente novo. Clique no nome para abrir o editor de novo.

O agente ainda não responde sozinho aos contatos. Para isso, teste e defina como padrão: veja [Testar e ajustar o agente](https://help.nextags.com.br/tutoriais/ia/testar-agente/) e [Agente padrão e resposta automática por IA](https://help.nextags.com.br/tutoriais/ia/agente-padrao/).

## Se não funcionou

### O AI Hub não mostra Adicionar Novo

Sem provedor de IA, o AI Hub mostra só **Conecte seu Provedor de IA**. Conecte um provedor primeiro. Veja [Conheça o AI Hub](https://help.nextags.com.br/tutoriais/ia/ia-hub/).

### Apareceu "Por favor, preencha todos os campos obrigatórios"

O nome do agente ficou vazio. Escreva um nome e clique em **Continuar**.

### Não aparece o Modelo de um provedor

O provedor não está conectado. Os ajustes mostram um **Modelo** só para os provedores conectados em **Configurações** › **Integrações**.

### Saí do editor e perdi o que escrevi

O editor só guarda com **Salvar**. **Cancelar** volta ao AI Hub sem guardar. Abra o agente e escreva de novo.

### O agente não responde aos contatos

Um agente só responde sozinho quando é o padrão e a **Resposta Automática por IA** está ligada. Veja [O agente de IA não está respondendo](https://help.nextags.com.br/perguntas/ia/ia-nao-responde/).

### Faça com a IA

Cole este pedido no ChatGPT ou no Claude:

```text
Vou criar um agente de IA na NexTags para atender os clientes da minha empresa. Leia este tutorial: https://help.nextags.com.br/tutoriais/ia/criar-agente.md

Escreva a mensagem do sistema do agente com estas partes: quem ele é, sobre a empresa, como responder, o que não fazer e quando chamar a equipe. Minha empresa: [nome, o que vende, cidade, horários, entregas, formas de pagamento]. Tom: [por exemplo, simpático e direto]. Use frases curtas e não invente preços.
```

> **Agentes pela API:**
> Para consultar ou atualizar os agentes a partir de outro sistema, use a API: [Listar agentes de IA](https://docs.nextags.com.br/referencia/agentes-de-ia/listar-agentes-de-ia/), [Atualizar agente de IA](https://docs.nextags.com.br/referencia/agentes-de-ia/atualizar-agente-de-ia/) e o guia [Agentes de IA pela API](https://docs.nextags.com.br/guias/agentes-de-ia-pela-api/).
