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

# Criando um Agente

Este guia descreve o processo completo para criar um novo agente de IA utilizando o assistente de criação (wizard). O fluxo é dividido em etapas sequenciais, permitindo configurar o nome, tipo, função, comportamento e modelo de IA que será utilizado pelo agente.

***

## Criando um Novo Agente

Você pode criar um novo agente usando um dos botões **Novo Agente** disponíveis.

<img src="https://mintcdn.com/evoai-683d737d/kMlWJMPGu3qiQ2A1/user-guides/agents/images/new-agent-button.png?fit=max&auto=format&n=kMlWJMPGu3qiQ2A1&q=85&s=4e703d40676d598f1eab95034558d37b" alt="Botão Novo Agente" width="970" height="693" data-path="user-guides/agents/images/new-agent-button.png" />

O botão **Novo Agente** está disponível em dois locais:

* No canto superior direito da tela
* No centro do estado vazio quando nenhum agente existe

Clicar neste botão inicia o assistente de criação de agente.

***

## Iniciando a Criação de um Novo Agente

Para iniciar a criação de um agente, acesse a seção **Agentes** e clique em **Novo Agente**. Isso abrirá o assistente de criação, que guia o processo em etapas.

<img src="https://mintcdn.com/evoai-683d737d/DkX8d0bkLWpeXhxu/user-guides/agents/images/creating-agent-start.png?fit=max&auto=format&n=DkX8d0bkLWpeXhxu&q=85&s=6c506a3ac2d29b2b4944d29a166b1b55" alt="Início do assistente de criação de agente" width="1076" height="905" data-path="user-guides/agents/images/creating-agent-start.png" />

Nesta primeira etapa, você deve definir o nome do agente.

### Nome do agente

O campo **What is your agent's name?** define o nome que será utilizado para identificar o agente dentro do workspace.

* O nome é obrigatório
* Ele será exibido na lista de agentes
* Pode ser alterado posteriormente nas configurações avançadas

Após preencher o nome, clique em **Continue** para avançar.

***

## Selecionando o Tipo de Agente

Na etapa seguinte, você deve escolher o tipo de agente que melhor se adapta ao seu caso de uso.

<img src="https://mintcdn.com/evoai-683d737d/kMlWJMPGu3qiQ2A1/user-guides/agents/images/select-agent-type.png?fit=max&auto=format&n=kMlWJMPGu3qiQ2A1&q=85&s=91a70351d2ea302661568ac827501a7d" alt="Seleção do tipo de agente" width="996" height="908" data-path="user-guides/agents/images/select-agent-type.png" />

Os tipos disponíveis determinam como o agente irá operar:

* **LLM (Language Model)**: Agente conversacional baseado em modelos de linguagem (mais comum)
* **Task**: Agente focado em automação de tarefas específicas
* **Sequential**: Executa agentes em sequência
* **Parallel**: Executa agentes em paralelo
* **Loop**: Executa agentes em loop contínuo

***

## Tipo de Agente LLM

Para agentes conversacionais, selecione a opção **LLM (Modelo de Linguagem)**.

<img src="https://mintcdn.com/evoai-683d737d/DkX8d0bkLWpeXhxu/user-guides/agents/images/llm-agent-type-selected.png?fit=max&auto=format&n=DkX8d0bkLWpeXhxu&q=85&s=cba1f3de913cc1dd67283966a98a4880" alt="Tipo de agente LLM selecionado" width="1111" height="911" data-path="user-guides/agents/images/llm-agent-type-selected.png" />

Esse tipo é o mais utilizado e indicado para assistentes virtuais, atendimento ao cliente, suporte técnico e agentes de vendas.

Após selecionar o tipo, clique em **Continuar**.

***

## Definindo Função e Objetivo do Agente

Nesta etapa, você define o papel do agente e seu principal objetivo.

<img src="https://mintcdn.com/evoai-683d737d/DkX8d0bkLWpeXhxu/user-guides/agents/images/agent-role-goal.png?fit=max&auto=format&n=DkX8d0bkLWpeXhxu&q=85&s=1487262da64edb169a864db699095724" alt="Definição de função e objetivo do agente" width="997" height="901" data-path="user-guides/agents/images/agent-role-goal.png" />

### Agent Role

O campo **Agent Role** descreve a função do agente, ou seja, qual papel ele exerce (por exemplo: assistente de suporte, vendedor, analista).

### Main Goal

O campo **Main Goal** define o objetivo principal do agente, descrevendo o que ele deve alcançar durante as interações.

Esses campos ajudam a orientar o comportamento do agente, mas podem ser ajustados posteriormente. Esta etapa é opcional e pode ser ignorada clicando em **Skip**.

***

## Definindo Instruções do Agente

A etapa de instruções define como o agente deve se comportar e responder.

<img src="https://mintcdn.com/evoai-683d737d/DkX8d0bkLWpeXhxu/user-guides/agents/images/agent-instructions.png?fit=max&auto=format&n=DkX8d0bkLWpeXhxu&q=85&s=d5279f1de60905cbb0d53c84bf426d2c" alt="Instruções de comportamento do agente" width="1020" height="906" data-path="user-guides/agents/images/agent-instructions.png" />

No campo **What does your agent do?**, descreva:

* O comportamento esperado do agente
* O tom de resposta (formal, amigável, técnico, etc.)
* Limites e responsabilidades
* Boas práticas de atendimento ou execução

Quanto mais detalhadas forem as instruções, mais consistente será o comportamento do agente.\
Você pode usar os botões **Review Prompt** ou **Generate with AI** para revisar ou gerar sugestões automaticamente.

***

## Selecionando o Modelo de IA

Nesta etapa, você define qual modelo de IA será utilizado pelo agente.

<img src="https://mintcdn.com/evoai-683d737d/DkX8d0bkLWpeXhxu/user-guides/agents/images/ai-model-manage-keys.png?fit=max&auto=format&n=DkX8d0bkLWpeXhxu&q=85&s=e934df7904633086f642c3031309b999" alt="Seleção de modelo de IA e gerenciamento de API Keys" width="935" height="748" data-path="user-guides/agents/images/ai-model-manage-keys.png" />

Antes de selecionar um modelo, é necessário configurar uma **API Key**.

### Gerenciando Chaves de API

Clique em **Manage** para abrir o gerenciador de chaves de API.

<img src="https://mintcdn.com/evoai-683d737d/DkX8d0bkLWpeXhxu/user-guides/agents/images/manage-api-keys-modal.png?fit=max&auto=format&n=DkX8d0bkLWpeXhxu&q=85&s=a69ce7a042e7e4a5c27e5cbd68bf0383" alt="Gerenciar chaves de API" width="595" height="542" data-path="user-guides/agents/images/manage-api-keys-modal.png" />

Caso não exista nenhuma chave configurada, você pode clicar em **Add First Key** ou **New Key**.

<img src="https://mintcdn.com/evoai-683d737d/DkX8d0bkLWpeXhxu/user-guides/agents/images/add-new-api-key.png?fit=max&auto=format&n=DkX8d0bkLWpeXhxu&q=85&s=ede8ea7ef02731c0565193160fbdb067" alt="Adicionar nova chave de API" width="596" height="905" data-path="user-guides/agents/images/add-new-api-key.png" />

Preencha os campos:

* **Name**: Nome identificador da chave
* **Provider**: Provedor do modelo (ex: OpenAI)
* **Key**: Chave de API fornecida pelo provedor

Clique em **Add** para salvar a chave.

***

## Escolhendo o Modelo de IA

Após configurar a API Key, você poderá selecionar o modelo de IA.

<img src="https://mintcdn.com/evoai-683d737d/kMlWJMPGu3qiQ2A1/user-guides/agents/images/select-ai-model.png?fit=max&auto=format&n=kMlWJMPGu3qiQ2A1&q=85&s=9cfce53a94a68337efb9c09b7086aee7" alt="Seleção do modelo de IA" width="444" height="821" data-path="user-guides/agents/images/select-ai-model.png" />

No campo **Search or select a model**, escolha o modelo desejado (por exemplo: GPT-4.1, GPT-4.5 Preview, GPT-4o, entre outros).

A lista exibida depende do provedor e da chave de API configurada.

Clique em **Continue** para finalizar a criação.

***

## Agente Criado com Sucesso

Após concluir todas as etapas, o agente será criado e estará pronto para uso.

<img src="https://mintcdn.com/evoai-683d737d/DkX8d0bkLWpeXhxu/user-guides/agents/images/agent-created-success.png?fit=max&auto=format&n=DkX8d0bkLWpeXhxu&q=85&s=4d416abb99d7492ab2075006913fc602" alt="Agente criado com sucesso" width="1215" height="910" data-path="user-guides/agents/images/agent-created-success.png" />

Nesta tela, você pode:

* Ajustar configurações avançadas
* Testar o agente em um chat
* Adicionar ferramentas (Tools)
* Retornar à lista de agentes

A partir daqui, você pode avançar para configurações mais avançadas, como servidores MCP, ferramentas customizadas e bases de conhecimento.

***

## Considerações Finais

O processo de criação de agentes foi projetado para ser rápido e intuitivo. Após a criação inicial, você pode refinar as configurações, adicionar ferramentas e bases de conhecimento para expandir as capacidades do agente.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.