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

# Introduction

> Configure e personalize seus agentes com ferramentas, integrações e funcionalidades avançadas

## Visão Geral

As **Agent Configurations** permitem que você personalize e estenda as capacidades dos seus agentes através de diversas integrações e ferramentas. Cada configuração oferece funcionalidades específicas para diferentes necessidades:

<img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/configurations.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=af5839ca00c2b9dc3fc8153bd65856b0" alt="Tela de Configurações do Agente" width="1247" height="1380" data-path="images/prints/configurations.png" />

<Note>
  **Acesso às Configurações**: Para acessar as configurações de qualquer agente, clique no ícone de configurações (⚙️) no card do agente e depois clique em **"Editar"**.
</Note>

## Configurações Disponíveis

### Compartilhamento e Acesso

<CardGroup cols={2}>
  <Card title="Share Agent" icon="share" href="/configurations/share-agent">
    **Compartilhe agentes publicamente**

    Gere URLs públicas para que outros usuários possam conversar com seus agentes sem necessidade de autenticação. Ideal para demonstrações e colaboração em equipe.

    * ✅ URLs públicas instantâneas
    * ✅ Acesso sem login
    * ✅ Controle de visibilidade
  </Card>

  <Card title="Credentials" icon="key" href="/configurations/credentials">
    **Credenciais para integração A2A**

    Acesse as credenciais automáticas geradas para cada agente, permitindo integração via protocolo Agent 2 Agent (A2A) com sistemas externos.

    * ✅ API Keys automáticas
    * ✅ URLs de integração
    * ✅ Protocolo A2A
  </Card>
</CardGroup>

### Servidores e Integrações MCP

<CardGroup cols={2}>
  <Card title="MCP Server" icon="server" href="/configurations/mcp_server">
    **Biblioteca de servidores MCP**

    Conecte seu agente com servidores MCP da biblioteca curada do Evo AI. Inclui integrações prontas com diversos serviços populares.

    * ✅ Biblioteca curada
    * ✅ Configuração simples
    * ✅ Serviços populares
  </Card>

  <Card title="Custom MCP" icon="globe" href="/configurations/custom_mcp">
    **Servidores MCP externos**

    Configure servidores MCP personalizados hospedados externamente com suporte a SSE e autenticação customizada via headers.

    * ✅ Servidores externos
    * ✅ SSE (Server-Sent Events)
    * ✅ Headers customizados
  </Card>
</CardGroup>

### Ferramentas e Agentes

<CardGroup cols={2}>
  <Card title="Agent Tools" icon="users" href="/configurations/agent_tools">
    **Agentes como ferramentas**

    Use outros agentes criados como ferramentas especializadas, criando arquiteturas hierárquicas de agentes orquestradores e especialistas.

    * ✅ Reutilização de agentes
    * ✅ Especialização funcional
    * ✅ Orquestração inteligente
  </Card>

  <Card title="Custom Tools" icon="wrench" href="/configurations/custom_tools">
    **Ferramentas HTTP personalizadas**

    Crie ferramentas HTTP customizadas para integrar qualquer API REST externa com configuração completa de parâmetros e autenticação.

    * ✅ APIs REST externas
    * ✅ Configuração completa
    * ✅ Autenticação flexível
  </Card>
</CardGroup>

## Como Configurar

### Passo a Passo Geral

<AccordionGroup>
  <Accordion icon="gear" title="1. Acessar configurações">
    1. Vá para a **tela de agentes** no dashboard principal
    2. Localize o agente que deseja configurar
    3. Clique no ícone de **"Configurações"** (⚙️) no card do agente e em seguida em **"Editar"**
    4. Clique em **"Editar"** no menu que aparece
    5. Você será direcionado para a tela de configurações
  </Accordion>

  <Accordion icon="list" title="2. Escolher configuração">
    Na tela de configurações, você verá todas as opções disponíveis:

    * **Share Agent** - Para compartilhamento público
    * **Credentials** - Para visualizar credenciais A2A
    * **MCP Server** - Para adicionar servidores da biblioteca
    * **Custom MCP** - Para servidores externos
    * **Agent Tools** - Para usar outros agentes
    * **Custom Tools** - Para criar ferramentas HTTP
  </Accordion>

  <Accordion icon="plus" title="3. Adicionar configuração">
    1. Clique em **"Add"** na seção desejada
    2. Preencha as informações necessárias
    3. Configure parâmetros específicos
    4. Salve as configurações
    5. Teste a funcionalidade
  </Accordion>
</AccordionGroup>

## Casos de Uso Comuns

### Agente de Atendimento Completo

<AccordionGroup>
  <Accordion icon="headset" title="Configuração para atendimento">
    **Configurações recomendadas:**

    * **Share Agent** - Para acesso público dos clientes
    * **Agent Tools** - Especialistas em vendas, suporte, financeiro
    * **Custom Tools** - Integração com CRM e sistema de tickets
    * **MCP Server** - Ferramentas de email e notificações

    **Resultado:** Agente completo para atendimento ao cliente com especialistas e integrações.
  </Accordion>
</AccordionGroup>

### Agente de Desenvolvimento

<AccordionGroup>
  <Accordion icon="code" title="Configuração para desenvolvimento">
    **Configurações recomendadas:**

    * **Agent Tools** - Especialistas em frontend, backend, DevOps
    * **Custom MCP** - Servidores de CI/CD e monitoramento
    * **Custom Tools** - APIs do GitHub, Jira, Slack
    * **Credentials** - Para integração com IDEs

    **Resultado:** Agente arquiteto com acesso a ferramentas de desenvolvimento completas.
  </Accordion>
</AccordionGroup>

### Agente de Pesquisa

<AccordionGroup>
  <Accordion icon="magnifying-glass" title="Configuração para pesquisa">
    **Configurações recomendadas:**

    * **MCP Server** - Ferramentas de busca e análise
    * **Custom Tools** - APIs acadêmicas e bases de dados
    * **Agent Tools** - Especialistas em análise e redação
    * **Share Agent** - Para compartilhar com equipe de pesquisa

    **Resultado:** Agente pesquisador com acesso a múltiplas fontes e especialistas.
  </Accordion>
</AccordionGroup>

## Boas Práticas

### Organização de Configurações

<AccordionGroup>
  <Accordion icon="sitemap" title="Estrutura recomendada">
    **Princípios de organização:**

    1. **Comece simples** - Configure uma funcionalidade por vez
    2. **Teste isoladamente** - Valide cada configuração antes de adicionar outras
    3. **Documente configurações** - Mantenha registro das integrações
    4. **Monitore performance** - Acompanhe impacto de cada configuração
    5. **Otimize gradualmente** - Ajuste conforme necessidade

    <Tip>
      Comece com Share Agent e MCP Server para funcionalidades básicas, depois adicione configurações mais complexas.
    </Tip>
  </Accordion>
</AccordionGroup>

### Segurança e Performance

<AccordionGroup>
  <Accordion icon="shield" title="Considerações importantes">
    **Segurança:**

    * 🔐 **Proteja API Keys** - Use headers seguros
    * 🔄 **Renove credenciais** regularmente
    * 📊 **Monitore acessos** - Acompanhe uso das integrações
    * 🛡️ **Valide permissões** - Confirme acessos necessários

    **Performance:**

    * ⚡ **Limite integrações** - Não sobrecarregue o agente
    * 📈 **Monitore latência** - Acompanhe tempo de resposta
    * 💰 **Considere custos** - Múltiplas integrações aumentam custos
    * 🎯 **Otimize uso** - Use apenas configurações necessárias
  </Accordion>
</AccordionGroup>

## Solução de Problemas

<AccordionGroup>
  <Accordion icon="triangle-exclamation" title="Problemas comuns">
    **Configuração não aparece:**

    * Verifique se o agente está ativo
    * Confirme se você tem permissões adequadas
    * Recarregue a página de configurações
    * Verifique logs de erro no console

    **Integração não funciona:**

    * Teste cada configuração isoladamente
    * Verifique credenciais e API keys
    * Confirme conectividade de rede
    * Consulte documentação específica da configuração

    **Performance lenta:**

    * Reduza número de configurações ativas
    * Otimize timeouts e parâmetros
    * Monitore uso de recursos
    * Considere usar agentes especializados

    **Erros de autenticação:**

    * Verifique validade das credenciais
    * Confirme formato dos headers
    * Teste autenticação externamente
    * Renove tokens se necessário
  </Accordion>
</AccordionGroup>

***

⚙️ **Configurações prontas!** Explore cada tipo de configuração para criar agentes poderosos e personalizados para suas necessidades específicas!