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

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

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

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

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

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

Para detalhes completos sobre o protocolo A2A, visite a documentação específica.

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

Mantenha suas API Keys seguras. Elas concedem acesso direto aos seus agentes.

Solução de Problemas

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

---

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