Agent2Agent (A2A) está saindo da especificação para o envio rapidamente, e no momento em que você executa um segundo agente, você precisa ver o que está sendo trocado entre eles. As ferramentas são novas, então a lista de depuradores A2A reais é curta, e a lacuna entre eles é grande. Este resumo cobre as ferramentas que realmente existem hoje, para que cada uma é boa e qual usar primeiro.
Se A2A é novo para você, leia o que é Agent2Agent (A2A) e o que é um depurador A2A antes desta lista. Eles explicam o Cartão de Agente, o ciclo de vida da tarefa e por que o tráfego de agente para agente é difícil de inspecionar.
Como avaliar um depurador A2A
Um depurador ganha um lugar nesta lista por fazer quatro coisas bem:
- Descoberta. Buscar e validar um Cartão de Agente, depois mostrar claramente as capacidades e habilidades do agente.
- Teste de mensagem. Enviar texto, arquivos e metadados sem criar JSON-RPC manualmente.
- Inspeção de resposta. Renderizar a resposta em um formato legível e expor o payload bruto.
- Autenticação e cabeçalhos. Lidar com Bearer, Basic, chave de API e cabeçalhos personalizados sem scripts.
Pontos extras para suporte a streaming, histórico de sessão e execução como um cliente local em vez de rotear seu tráfego através de um terceiro.
1. Depurador Apidog A2A
Apidog oferece um Depurador A2A dedicado dentro de seu cliente padrão, e é a opção mais completa para a maioria das equipes.
Você cola uma URL de Cartão de Agente, clica em Conectar, e o Apidog valida o cartão e mostra o nome do agente, descrição, capacidades, habilidades declaradas e versão do protocolo. A aba Mensagens permite enviar texto simples, anexar arquivos (o depurador verifica os tipos de entrada declarados do agente e rejeita os não suportados antecipadamente) e adicionar pares chave-valor de metadados personalizados. As respostas vêm em três visualizações: Pré-visualização para uma árvore legível, Conteúdo para o corpo legível por humanos e Dados Brutos para o payload JSON-RPC completo.
A autenticação cobre Nenhuma, Token Bearer, Autenticação Básica e chave de API via um cabeçalho personalizado, tudo na UI. Os cabeçalhos personalizados lidam com gateways e roteamento de locatários. O histórico de sessão mantém cada mensagem de uma execução. Ele lida com streaming de eventos enviados pelo servidor onde o agente suporta, e funciona como um cliente local, então o tráfego vai direto entre sua máquina e o agente.
Pontos fortes: a cobertura de recursos mais ampla, sem scripts, três visualizações de resposta, e ele vive na mesma ferramenta que você já usa para trabalho com REST, GraphQL e MCP. Uma superfície para cada protocolo em que um sistema de agente é executado.
Compromisso: faz parte do cliente Apidog completo, em vez de um binário autônomo de propósito único. Se você quer um CLI minúsculo e nada mais, isso é mais do que você precisa.
Melhor para: equipes construindo ou consumindo agentes A2A que desejam uma bancada de trabalho visual e sem código. Comece com o guia do Depurador A2A do Apidog. Baixe o Apidog para acompanhar.
2. Inspetor A2A
O projeto A2A mantém um Inspetor A2A de código aberto; uma ferramenta baseada na web para conectar a um agente, visualizar seu Cartão de Agente e exercitar mensagens. Ele é publicado junto com a especificação na organização A2A GitHub.
Como vem do mesmo projeto que possui o protocolo, ele acompanha de perto a especificação e é uma boa referência para "como um cartão e troca conformes devem ser". Ele valida o Cartão de Agente e permite enviar mensagens e ler respostas no navegador.
Pontos fortes: preciso na especificação, código aberto, gratuito e uma referência de conformidade útil.
Compromisso: é uma ferramenta de desenvolvedor que você geralmente executa por conta própria, e sua UX e profundidade de recursos ficam atrás de um produto dedicado. O tratamento de autenticação e a ergonomia de anexos de arquivo são mais limitados.
Melhor para: desenvolvedores que desejam uma implementação de referência e não se importam em executá-la localmente.
3. Ferramentas CLI e SDK do A2A
Os SDKs oficiais do A2A (Python e JavaScript/TypeScript, entre eles) vêm com ajudantes de linha de comando e clientes de exemplo que você pode apontar para qualquer agente A2A. Com alguns comandos, você pode buscar um Cartão de Agente, enviar uma mensagem e imprimir a resposta.
Este é o caminho scriptável. Ele se encaixa naturalmente em CI, testes de fumaça e verificações automatizadas onde uma GUI não pode ser executada.
Pontos fortes: scriptável, automatizável e zero instalações extras se você já depende do SDK.
Compromisso: sem visualizações de resposta visuais, sem diferenciação, e você lê JSON bruto no terminal. Bom para verificações de aprovação/reprovação, doloroso para depuração exploratória.
Melhor para: verificações de conformidade automatizadas e pipelines de CI, não para depuração interativa.
4. Agentes de exemplo A2A e UI de demonstração
O projeto A2A publica agentes de exemplo e uma interface de usuário de demonstração multiagente em seu repositório de exemplos, acessível a partir do site do protocolo A2A. A interface de usuário de demonstração permite que você observe vários agentes coordenarem e inspecionem as mensagens entre eles.
Ele foi construído para ensinar o protocolo, em vez de depurar seu próprio agente, mas é genuinamente útil para ver uma troca A2A saudável de ponta a ponta antes de suspeitar do seu próprio código.
Pontos fortes: ótimo para aprender, mostra fluxos multiagente reais, gratuito e de código aberto.
Compromisso: é uma demonstração, não um produto de depuração. Você não o usa para conduzir agentes arbitrários da mesma forma que faria com o Apidog ou o Inspetor.
Melhor para: aprender o protocolo e obter uma troca de referência conhecida e funcional.
5. Clientes de API gerais (curl, scripts personalizados)
Antes de tudo o que foi dito acima, o primeiro "depurador" de toda equipe é o curl ou um script descartável. Uma requisição A2A é JSON-RPC sobre HTTP, então um cliente HTTP bruto pode enviá-la.
Funciona para uma troca. Então você a mantém: constrói manualmente o envelope JSON-RPC, codifica seu próprio Basic Auth em base64, analisa artefatos aninhados a olho nu e reescreve o script toda vez que o Cartão de Agente muda. Esta é a linha de base que as ferramentas dedicadas existem para substituir.
Pontos fortes: já instalado, sem curva de aprendizado para uma única tentativa.
Compromisso: sem validação de Cartão de Agente, sem renderização de resposta, sem suporte a streaming, e deteriora-se rapidamente.
Melhor para: uma verificação de sanidade única, nada contínuo.
Comparação rápida
| Ferramenta | Tipo | Visualizações de resposta visuais | Autenticação na UI | Streaming | Melhor para |
|---|---|---|---|---|---|
| Depurador Apidog A2A | Cliente visual | Três visualizações | Sim | Sim | Depuração A2A do dia-a-dia |
| Inspetor A2A | Ferramenta web (auto-executável) | Básico | Limitado | Parcial | Referência de especificação |
| CLI / SDK A2A | Linha de comando | Nenhum (JSON bruto) | Via flags | Limitado | CI e automação |
| UI de demonstração A2A | Aplicativo de exemplo | Embutido | N/A | Sim | Aprendendo o protocolo |
| curl / scripts | HTTP bruto | Nenhum | Manual | Não | Verificações únicas |
Qual você deve usar?
Para depuração interativa e diária, o Depurador Apidog A2A é o padrão prático. Ele valida Cartões de Agente, envia mensagens com arquivos e metadados, renderiza respostas de três maneiras e lida com autenticação sem scripts; e ele fica ao lado de suas ferramentas REST, GraphQL e MCP, então você não precisa fazer malabarismos com aplicativos separados. O guia do servidor MCP vs A2A explica por que ter ambos os protocolos sob o mesmo teto é importante à medida que os sistemas de agentes crescem.
Para conformidade automatizada em CI, combine-o com a CLI do SDK A2A. Use o depurador visual para encontrar e corrigir bugs, depois bloqueie o comportamento corrigido em uma verificação scriptada. A mesma disciplina de confirmar a comunicação primeiro, encontrada em como testar agentes de IA que chamam suas APIs, se aplica aqui.
Para aprender o protocolo, execute a UI de demonstração A2A uma vez para ver uma troca multiagente saudável, depois passe para um depurador real para seus próprios agentes. E assim que seus agentes precisarem de credenciais, o guia de credenciais seguras de API para agentes de IA aborda o que rotacionar e qual escopo usar.
O resumo honesto: o espaço de ferramentas A2A ainda é pequeno. Apidog é o depurador visual mais completo hoje, as ferramentas oficiais do projeto são a melhor referência de especificação, e clientes HTTP brutos são o mínimo do qual você está tentando sair. Escolha o depurador visual para encontrar bugs e a CLI para se proteger contra eles.
Perguntas comuns
Qual é o melhor depurador A2A atualmente?
Para depuração interativa, o Depurador Apidog A2A é o mais completo: validação de Cartão de Agente, teste de mensagens com arquivos e metadados, três visualizações de resposta, autenticação completa e suporte a streaming, tudo sem scripts.
Existem depuradores A2A gratuitos?
Sim. O Depurador Apidog A2A vem gratuito com o cliente padrão, e o Inspetor A2A oficial, CLI do SDK e UI de demonstração são de código aberto e gratuitos.
Posso depurar agentes A2A com o Postman?
Postman não possui suporte A2A nativo. Você pode enviar a requisição HTTP JSON-RPC bruta manualmente, mas perde a validação do Cartão de Agente, a renderização da resposta e o streaming. Um depurador A2A dedicado cuida da camada de protocolo para você.
Os depuradores A2A funcionam com qualquer framework de agente?
Sim, desde que o agente publique um Cartão de Agente A2A válido. A2A é agnóstico de framework, então LangGraph, CrewAI, AutoGen e agentes personalizados funcionam. Veja o que é Agent2Agent (A2A) para os conceitos básicos do protocolo.
Devo usar uma CLI ou um depurador A2A visual?
Use ambos para diferentes tarefas. Um depurador visual como o Apidog é mais rápido para encontrar e isolar bugs. Uma CLI é melhor para verificações de conformidade automatizadas em CI. A maioria das equipes depura visualmente e depois scripta o comportamento corrigido.
Como faço para começar a depurar um agente A2A?
Baixe o Apidog, abra o Depurador A2A, cole a URL do Cartão de Agente do seu agente, clique em Conectar e envie uma mensagem de teste em texto simples. O guia do Depurador A2A do Apidog explica todo o processo.