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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://zaiadocs.gitbook.io/recursos/agentes/como-criar-um-agente.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
