​
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
Geração Automática: As credenciais são criadas automaticamente no momento do cadastro do agente. Não é necessário configuração manual.
Protocolo A2A: Para entender melhor como funciona a comunicação entre agentes, consulte nossa documentação completa sobre o Protocolo A2A.

​
Como Acessar as Credenciais

​
Localizar Credenciais 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
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
Tela de Credenciais do Agente
Essas credenciais são únicas para cada agente e permanecem válidas enquanto o agente existir.

​
Protocolo A2A (Agent 2 Agent)

​
Integração Básica

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
Para detalhes completos sobre o protocolo A2A, visite a documentação específica.
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
Mantenha suas API Keys seguras. Elas concedem acesso direto aos seus agentes.

​
Solução de Problemas

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
🔐 Credenciais configuradas! Agora você pode integrar seus agentes com sistemas externos usando o protocolo A2A de forma segura e eficiente.