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

# Credentials

> Gerencie credenciais e chaves de acesso dos seus agentes para integração A2A

## Visão Geral

As **Credentials** são credenciais de acesso geradas automaticamente para cada agente, permitindo integração segura através do **protocolo A2A (Agent 2 Agent)**. Essas credenciais são essenciais para:

* **Comunicação entre agentes** de diferentes sistemas
* **Integração via API** com aplicações externas
* **Autenticação segura** em chamadas programáticas
* **Controle de acesso** granular por agente

<Note>
  **Geração Automática**: As credenciais são criadas automaticamente no momento do cadastro do agente.
  Não é necessário configuração manual.
</Note>

<Info>
  **Protocolo A2A**: Para entender melhor como funciona a comunicação entre agentes, consulte nossa documentação completa sobre o [Protocolo A2A](/a2a-protocol).
</Info>

## Como Acessar as Credenciais

### Localizar Credenciais do Agente

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

  <Accordion icon="key" title="Visualizar credenciais">
    Na tela de configurações do agente, você encontrará:

    **API Key:**

    * Chave única gerada automaticamente
    * Usada para autenticação nas chamadas A2A
    * Formato: `evo_agent_xxxxxxxxxxxxxxxx`

    **URL do Agente:**

    * Endpoint específico para comunicação A2A
    * Formato: `https://app.evo-ai.co/api/a2a/agent/{agent_id}`
    * Usado para chamadas diretas ao agente

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/credentials.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=2af9aeaaf702817c29787227fe9bef8c" alt="Tela de Credenciais do Agente" width="1138" height="512" data-path="images/prints/credentials.png" />

    <Info>
      Essas credenciais são únicas para cada agente e permanecem válidas enquanto o agente existir.
    </Info>
  </Accordion>
</AccordionGroup>

## Protocolo A2A (Agent 2 Agent)

### Integração Básica

<AccordionGroup>
  <Accordion icon="network-wired" title="Como usar as credenciais">
    As credenciais geradas permitem que sistemas externos se comuniquem diretamente com seus agentes através do protocolo A2A.

    **Componentes necessários:**

    * **API Key**: Para autenticação
    * **URL do Agente**: Endpoint para comunicação
    * **Formato de requisição**: JSON com mensagem e contexto

    <Info>
      Para detalhes completos sobre o protocolo A2A, visite a [documentação específica](/a2a-protocol).
    </Info>
  </Accordion>

  <Accordion icon="shield" title="Segurança das credenciais">
    **Características de segurança:**

    * 🔐 **API Keys únicas** por agente
    * 🔄 **Tokens com expiração** configurável
    * 📊 **Logs de acesso** detalhados
    * ⚠️ **Rate limiting** automático
    * 🛡️ **Validação de origem** das requisições

    <Warning>
      Mantenha suas API Keys seguras. Elas concedem acesso direto aos seus agentes.
    </Warning>
  </Accordion>
</AccordionGroup>

## Solução de Problemas

<AccordionGroup>
  <Accordion icon="triangle-exclamation" title="Problemas comuns">
    **API Key não funciona:**

    * Verifique se a API Key está correta e completa
    * Confirme se o agente está ativo
    * Teste com uma requisição simples primeiro
    * Verifique se não há caracteres extras ou espaços

    **Erro 401 - Não autorizado:**

    * API Key pode estar expirada ou inválida
    * Verifique o formato do header Authorization
    * Confirme se está usando "Bearer" antes da chave

    **Erro 429 - Rate limit:**

    * Muitas requisições em pouco tempo
    * Implemente delay entre chamadas
    * Considere otimizar a frequência de uso

    **Agente não responde:**

    * Verifique se o agente tem créditos de API
    * Confirme se o modelo está disponível
    * Teste o agente diretamente na plataforma
    * Verifique logs de erro no dashboard
  </Accordion>
</AccordionGroup>

***

🔐 **Credenciais configuradas!** Agora você pode integrar seus agentes com sistemas externos usando o protocolo A2A de forma segura e eficiente.