> For the complete documentation index, see [llms.txt](https://zaiadocs.gitbook.io/recursos/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zaiadocs.gitbook.io/recursos/agentes/como-criar-um-agente.md).

# Como criar um agente

Este guia oferece um passo a passo para criar um agente de IA personalizado na plataforma Zaia, desde a configuração inicial até o teste em chat interno.

***

### Passo 1 — Acesse a plataforma

Acesse o site <https://platform.zaia.app>

***

### Passo 2 — Crie um novo agente

Clique em **"Criar Agente AI"** no menu lateral.

***

### Passo 3 — Escolha uma imagem (opcional)

Se desejar, faça o upload de uma imagem para o perfil do seu Agente.

***

### Passo 4 — Defina o nome do Agente

Preencha o campo **"Nome do Agente"** com o nome que será exibido nas conversas.

***

### Passo 5 — Defina o nome interno

Preencha o campo **"Nome interno"**. Esse nome não influencia no comportamento do Agente — ele serve apenas para identificação dentro da sua organização.

***

### Passo 6 — Escolha um template

Na seção **"Função do Agente"**, selecione o template desejado. Os templates disponíveis definem o ponto de partida do comportamento do Agente.

***

### Passo 7 — Confirme a criação

Clique em **"Criar Agente IA"** para salvar as informações e criar o agente.

***

### Passo 8 — Edite o comportamento do Agente

Nas definições do Agente, acesse a aba **"Instruções"** e edite o campo **"Comportamento do funcionário"**. Aqui você define como o Agente deve se comportar em todas as interações.

***

### Passo 9 — Salve o comportamento

Após editar, clique em **"Treinar Agente IA"** para salvar as instruções de comportamento.

***

### Passo 10 — Configure instruções específicas

Ainda na aba **"Instruções"**, você pode criar e editar instruções específicas além do comportamento geral. Clique em **"Adicionar instrução específica"** para criar novas instruções.

***

### Passo 11 — Defina o nome e a condição da instrução

Para cada instrução específica, defina:

* **Nome da instrução** — usado apenas internamente pela sua organização
* **Condição para a instrução ser escolhida** — define quando essa instrução será ativada (ex.: "A conversa acabou de ser iniciada")

***

### Passo 12 — Adicione variáveis para captura de dados

Em cada instrução, você pode definir quais dados o Agente deve coletar antes de executar as instruções. Selecione as variáveis desejadas no campo **"Dados que o Funcionário deve coletar"**.

***

### Passo 13 — Confirme a adição da variável

Após selecionar a variável, clique em **"Adicionar"** para incluí-la na instrução.

***

### Passo 14 — Salve a instrução

Com as variáveis e instruções configuradas, clique em **"Treinar Agente IA"** para salvar.

***

### Passo 15 — Acesse as configurações do Agente

Clique na aba **"2. Configurações"** para definir as configurações gerais do Agente.

***

### Passo 16 — Edite o nome e nome interno (se necessário)

Nessa aba, você pode revisar e alterar o **nome do Agente** e o **nome interno**.

***

### Passo 17 — Configure o tom de voz, modelo e mensagem inicial

Nessa mesma tela, defina:

* **Tom de Voz** — como o Agente se comunicará nas conversas
* **Modelo do Agente** — o modelo de linguagem que será utilizado para gerar respostas
* **Mensagem Inicial** — a primeira mensagem que o Agente enviará ao usuário ao iniciar uma conversa

***

### Passo 18 — Salve as configurações

Clique em **"Treinar Agente IA"** para salvar as configurações.

***

### Passo 19 — Acesse o perfil da empresa

Clique na aba **"3. Perfil da empresa"** para preencher as informações da empresa para a qual o Agente irá trabalhar.

***

### Passo 20 — Preencha os dados da empresa

Informe:

* **Nome da empresa**
* **Setor da empresa**
* **Site da empresa** (se houver)

***

### Passo 21 — Fale sobre a empresa

No campo **"Fale sobre a sua empresa"**, adicione uma breve descrição da empresa. Essa informação ajuda o Agente a contextualizar melhor suas respostas.

***

### Passo 22 — Salve o perfil da empresa

Clique em **"Treinar Agente IA"** para salvar todas as informações.

***

### Passo 23 — Teste o Agente no chat interno

Para começar a testar, clique no nome do seu Agente no menu lateral. O chat interno ficará disponível para envio de mensagens.

***

### Passo 24 — Converse com o Agente

No chat interno, escreva mensagens para testar o funcionamento do Agente e verificar se ele está respondendo conforme o esperado.

***

### Passo 25 — Agente criado com sucesso!

Seu Agente IA está criado e pronto para uso. Não esqueça de conferir os outros tutoriais disponíveis para explorar funcionalidades avançadas como habilidades, integrações e muito mais.
