> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatmode.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Agentes

Agentes são os assistentes de IA principais que você cria e configura no Chatmode. Eles lidam com conversas com seus usuários, fornecem informações e realizam ações com base em sua configuração.

## Criando um Agente

Para criar um novo agente:

1. Navegue até a seção **Agentes** na barra lateral
2. Clique no botão **Criar Agente** no canto superior direito
3. Preencha as informações necessárias:
   * **Nome**: Um nome descritivo para o seu agente
   * **Prompt do Sistema**: Defina a personalidade, conhecimento e comportamento do agente (veja Engenharia de Prompt abaixo)
   * **Recursos**: Selecione recursos opcionais para aprimorar as capacidades do agente (veja Recursos abaixo)
   * **Dados de Treinamento**: Selecione [Dados de Treinamento](/pt-br/features/trainings) pré-existentes para fundamentar o conhecimento do agente
4. Expanda **Configurações Avançadas** e configure:
   * **Chave de API**: Escolha a chave de API (por exemplo, OpenAI) que fornece o modelo e será usada para as requisições
   * **Modelo**: Selecione o modelo de IA específico (por exemplo, GPT-4o) para alimentar seu agente. Os modelos disponíveis dependem da Chave de API selecionada
   * **Temperatura**: Controle o nível de criatividade/aleatoriedade (0.0-1.0)
   * **Tokens Máximos**: Defina o comprimento máximo de uma única resposta do agente
5. Clique em **Criar**

<Note>
  O **Prompt do Sistema** é crucial para o desempenho do seu agente. Dedique
  tempo para elaborar um prompt que defina claramente o papel, tom e restrições
  do agente.
</Note>

## Opções de Configuração do Agente

### Engenharia de Prompt

O **Prompt do Sistema** é a base do comportamento do seu agente. Ele deve incluir:

* **Definição do Papel**: O que o agente deve ser (por exemplo, especialista em suporte ao cliente)
* **Personalidade**: Como o agente deve se comunicar (por exemplo, profissional, amigável)
* **Escopo do Conhecimento**: Que informações o agente deve fornecer ou evitar
* **Instruções de Fluxo de Trabalho**: Como o agente deve lidar com diferentes cenários

Exemplo de estrutura de prompt:

```
Você é um agente de suporte ao cliente para TechGadgets, uma loja de eletrônicos.

Sua personalidade é:
- Profissional, mas amigável
- Prestativo e paciente
- Conhecedor de produtos tecnológicos

Seu objetivo é ajudar os clientes com:
- Informações e recomendações de produtos
- Consultas sobre status de pedidos
- Suporte técnico para produtos
- Políticas de devolução e troca

Sempre se apresente como "Suporte TechGadgets" no início das conversas.
```

### Seleção de Modelo

O Chatmode suporta múltiplos modelos de IA com diferentes capacidades (a disponibilidade depende da Chave de API):

| Modelo  | Melhor Para                               | Considerações                              |
| :------ | :---------------------------------------- | :----------------------------------------- |
| GPT-4o  | Raciocínio complexo, respostas detalhadas | Custo mais alto, ligeiramente mais lento   |
| GPT-4.1 | Uso geral, respostas mais rápidas         | Custo-benefício, raciocínio menos complexo |

### Seleção de Chave de API

Certifique-se de ter adicionado as [Chaves de API](/pt-br/features/api-keys) necessárias para os provedores de IA (como OpenAI) que pretende usar. A chave de API selecionada determina quais modelos estão disponíveis.

### Configuração de Temperatura

O parâmetro de temperatura controla a aleatoriedade da resposta:

* **0.0-0.3**: Altamente determinístico, respostas consistentes (bom para informações factuais)
* **0.4-0.7**: Criatividade e consistência equilibradas (recomendado para a maioria dos usos)
* **0.8-1.0**: Criatividade e variabilidade máximas (bom para conteúdo criativo)

### Tokens Máximos

Esta configuração limita o número de tokens (aproximadamente palavras ou partes de palavras) que o agente pode usar em uma única resposta. Ajuste isso com base no comprimento e complexidade desejados das respostas.

### Recursos (Features)

Ative recursos específicos para estender as capacidades do seu agente:

| Recurso               | Descrição                                                                          |
| --------------------- | ---------------------------------------------------------------------------------- |
| Captura de Leads      | Coleta automaticamente informações do usuário (como nome, email) durante o chat.   |
| Atribuição Automática | Atribui automaticamente conversas aos membros da equipe disponíveis.               |
| Resolução Automática  | Marca automaticamente as conversas como resolvidas após um período de inatividade. |

*Nota: Os recursos disponíveis podem mudar.*

### Seleção de Dados de Treinamento

Você pode vincular uma ou mais fontes de [Dados de Treinamento](/pt-br/features/trainings) concluídas ao seu agente. Isso fornece ao agente conhecimento específico de seus documentos ou sites, melhorando sua precisão e relevância para seu domínio específico.

## Gerenciando Agentes

### Visão da Lista de Agentes

A página principal de Agentes exibe todos os seus agentes com informações chave:

* Nome e status do agente (ativo/inativo)
* Ambientes associados
* Data de criação
* Estatísticas de uso (se aplicável)

### Editando Agentes

Para modificar um agente existente:

1. Selecione o agente na lista
2. Clique em **Editar** na página de detalhes do agente
3. Faça suas alterações em qualquer opção de configuração
4. Salve suas alterações

<Note>
  Agentes atualmente vinculados a [Ambientes](/pt-br/features/environments)
  ativos não podem ser excluídos diretamente. Você deve primeiro remover o
  agente de todos os ambientes.
</Note>

### Análise do Agente

Monitore o desempenho do seu agente revisando as conversas e métricas básicas:

* Volume de conversas ao longo do tempo
* Tempo médio de resposta (se aplicável)
* Métricas de feedback do usuário (se aplicável)
* Tópicos e perguntas comuns (através da revisão manual)

## Boas Práticas

1. **Comece Simples**: Comece com um caso de uso focado e expanda conforme aprende
2. **Teste Exaustivamente**: Tente diferentes cenários para garantir que seu agente os lide corretamente
3. **Itere com Base no Feedback**: Revise regularmente as conversas e refine seu agente
4. **Use Dados de Treinamento**: Melhore seu agente com conhecimento específico do domínio
5. **Monitore e Mantenha**: Verifique regularmente o desempenho do agente e atualize conforme necessário

## Próximos Passos

Após criar seu agente, você precisará:

1. [Configurar um ambiente](/pt-br/features/environments) para implantar seu agente
2. [Adicionar dados de treinamento](/pt-br/features/trainings) para melhorar o conhecimento do agente
3. [Monitorar conversas](/pt-br/features/conversations) para garantir a qualidade