A2A (Agent2Agent) é um protocolo aberto para comunicação entre Agentes. Por meio do A2A, diferentes Agentes podem descobrir as capacidades uns dos outros, enviar mensagens e retornar resultados de execução.A2A Debugger é uma ferramenta visual para depurar Agentes A2A. Você pode se conectar a um Agente A2A, enviar mensagens de teste, visualizar o conteúdo retornado pelo Agente, o status de execução e os logs de depuração, ajudando desenvolvedores a solucionar rapidamente problemas de integração do Agente, entrega de mensagens e resultados retornados.O A2A Debugger é adequado para os seguintes cenários:Verificar se um Agente A2A consegue se conectar normalmente
Visualizar o nome, a descrição, as capacidades e as Skills do Agente
Enviar texto ou anexos ao Agente para verificar sua resposta
Solucionar problemas de conexão ou requisição, como autenticação, cabeçalho, tipos de arquivo etc.
Visualizar detalhes da requisição e da resposta para identificar a causa de conteúdo retornado anormal
Recomendamos usar o cliente Apidog mais recente para experimentar todos os recursos do AI Agent Debugger.
Conectando-se a um Agente A2A#
Insira a URL do Agent Card na parte superior da página e clique em Connect.Após uma conexão bem-sucedida, o status na parte superior será exibido como Connected. Nesse momento, você poderá visualizar as informações do Agente e começar a enviar mensagens.Se precisar alternar para outro Agente, você poderá clicar em Disconnect e inserir novamente a URL do Agent Card.Escrevendo mensagens de teste#
Escreva a entrada de teste a ser enviada ao Agente na guia Messages.A área de edição de mensagens é dividida em seções esquerda e direita:Lado esquerdo: insira o texto da mensagem, carregue anexos e configure Metadata
Lado direito: visualize o conteúdo bruto correspondente da requisição
Enviando mensagens#
Após concluir a configuração da mensagem, clique em Send.Se nenhum Agente estiver conectado no momento, o A2A Debugger tentará se conectar primeiro; ele enviará a mensagem depois que a conexão for bem-sucedida.Após o envio, você poderá ver a mensagem do usuário e o conteúdo retornado pelo Agente na área de mensagens.Visualizando mensagens de resposta#
A área de mensagens exibe mensagens do usuário e respostas do Agente na sessão atual.O conteúdo retornado pelo Agente pode ser texto simples ou pode incluir status da tarefa, resultados de execução ou artefatos gerados. Você pode determinar rapidamente se o Agente entendeu e processou corretamente a requisição por meio da área de exibição de mensagens.Clique em qualquer mensagem de depuração para visualizar os detalhes à direita. O painel de detalhes oferece suporte a três visualizações:Preview: exibe o conteúdo principal de forma mais legível
Content: visualiza texto ou dados principais na mensagem
Raw Data: visualiza o JSON bruto completo
What is the distance between the Earth and the Moon?
Visualizando o Agent Card#
A guia Agent Card no painel de depuração é usada para visualizar a descrição das capacidades do Agente atualmente conectado.Nome e descrição do Agente
Endereço do Agente, versão do protocolo, número da versão
Capacidades compatíveis com o Agente, como se ele oferece suporte a respostas em streaming, notificações push, histórico de status etc.
Tipos de entrada e tipos de saída padrão
Skills declaradas pelo Agente
Erros de validação do Agent Card
Conteúdo bruto do Agent Card
Adicionando anexos#
Se o Agente atual oferecer suporte a entrada de arquivo, você poderá clicar no botão de anexo abaixo da área de entrada da mensagem para carregar arquivos.O A2A Debugger determina se o carregamento de anexos é permitido com base nos tipos de entrada declarados pelo Agente:Se o Agente oferecer suporte apenas a entrada de texto, o botão de anexo ficará indisponível
Se o Agente oferecer suporte apenas a tipos de arquivo específicos, você só poderá carregar arquivos de tipos correspondentes
Se o Agente oferecer suporte a qualquer tipo de arquivo, você poderá carregar qualquer arquivo
Configurando autenticação#
Se o Agente A2A exigir autenticação, você poderá configurar o método de autenticação na guia Authentication.Os seguintes tipos de autenticação são compatíveis:| Método de autenticação | Descrição |
|---|
| None | Nenhuma informação de autenticação adicionada |
| Bearer Token | Autenticar usando um token |
| Basic Auth | Autenticar usando nome de usuário e senha |
| API Key | Passar a API Key por meio de um cabeçalho especificado |
Se um erro de não autorizado for retornado ao enviar uma mensagem, verifique se o método de autenticação, token, nome de usuário/senha ou API Key está correto.Configurando cabeçalhos#
Na guia Header, você pode adicionar cabeçalhos de requisição personalizados.Cabeçalhos personalizados são comumente usados nos seguintes cenários:Passagem de parâmetros de negócios, como ID do locatário, identificador de ambiente etc.
Autenticação por meio de gateways, proxies ou serviços internos
Depuração de serviços de Agente que exigem cabeçalhos de requisição especiais
Perguntas frequentes#
O que devo fazer se a conexão falhar?#
1.
Se a URL do Agent Card está correta e acessível a partir do ambiente atual.
2.
Se o serviço do Agente está em execução.
3.
Se autenticação for necessária, se as informações de autenticação corretas foram configuradas na guia Authentication.
4.
Se cabeçalhos adicionais são necessários, como ID do locatário, identificador de ambiente ou informações de autenticação de gateway.
5.
Se o conteúdo retornado pelo Agent Card é um JSON válido.
Não consegue carregar anexos após uma conexão bem-sucedida?#
Isso geralmente ocorre porque o Agente atual não declarou suporte a entrada de arquivo ou permite carregar apenas tipos de arquivo específicos.Visualize os tipos de entrada compatíveis com o Agente na guia Agent Card e confirme se o tipo de arquivo carregado corresponde.Como visualizar a requisição e a resposta completas?#
Clique no log de requisição ou resposta correspondente na guia Messages do painel de depuração e, em seguida, alterne para a visualização Raw Data para visualizar o JSON completo.Você pode solucionar o problema na seguinte ordem:1.
Verifique o conteúdo de pré-visualização na mensagem de depuração para confirmar se o Agente retornou um resultado.
2.
Alterne para a visualização Raw Data para visualizar a resposta completa.
3.
Verifique se os tipos de entrada, tipos de saída e Skills declaradas no Agent Card atendem às expectativas.
4.
Verifique se há avisos de erro de validação na mensagem ou nos detalhes de depuração.
