Apidog Docs
🇵🇹 Português (Portugal)
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇵🇹 Português (Portugal)
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇵🇹 Português (Portugal)
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
  1. Depuração de APIs
  • Centro de Aprendizagem da Apidog
  • Primeiros passos
    • Introdução ao Apidog
    • Conceitos Básicos no Apidog
    • Navegar no Apidog
    • Início rápido
      • Visão geral
      • Criar um Endpoint
      • Fazer um Pedido
      • Adicionar uma asserção
      • Criar Cenários de Teste
      • Partilhar Documentação da API
      • Explore Mais
    • Migração para o Apidog
      • Visão geral
      • Importação Manual
      • Importação Agendada (Vincular Fontes de Dados)
      • Opções de Importação
      • Exportar Dados
      • Importar de
        • Importar do Postman
        • Importar especificação OpenAPI
        • Importar cURL
        • Importar Markdowns
        • Importar a partir do Insomnia
        • Importar a partir de apiDoc
        • Importar Ficheiro .har
        • Importar WSDL
  • Apidog Europe
    • Apidog Europe
  • Dados de API mock
    • Visão geral
    • Smart Mock
    • Mock personalizado
    • Sequência de Prioridade do Mock
    • Scripts de Mock
    • Mock na Cloud
    • Mock do Runner Autoalojado
    • Idioma de Mock (Localidades)
  • Conta e preferências
    • Definições da Conta
    • Gerar um Token de Acesso OpenAPI
    • Notificações
    • Definições de Idioma
    • Teclas de Atalho
    • Configuração de Proxy de Rede
    • Cópia de Segurança dos Dados
    • Atualizar o Apidog
    • Eliminar Conta
    • Funcionalidades Experimentais
  • Enviar requisições
    • Visão geral
    • Depuração de SSE
    • Cliente MCP
    • Socket.IO
    • WebSocket
    • Webhook
    • SOAP ou WebService
    • GraphQL
    • gRPC
    • Utilizar Agentes de Proxy de Pedido para Depuração
    • Criar requisições
      • Histórico de Pedidos
      • Noções Básicas de Pedidos
      • Parâmetros e Corpo
      • Cabeçalhos do Pedido
      • Definições do Pedido
      • Depurar Pedidos
      • Guardar Pedidos como Endpoints
      • HTTP/2
    • Autenticação e autorização
      • Visão geral
      • Certificados CA e de Cliente
      • Tipos de autorização
      • Autenticação Digest
      • OAuth 1.0
      • OAuth 2.0
      • Autenticação Hawk
      • Kerberos
      • NTLM
      • Akamai EdgeGrid
    • Resposta e cookies
      • Visualizar Respostas de API
      • Gerir Cookies
      • Visão geral
  • Desenvolver e depurar APIs
    • Visão geral
    • Gerar Pedidos
    • Enviar Pedidos
    • Casos de Depuração
    • Casos de Teste
    • Valores Dinâmicos
    • Validação de Respostas
    • Design-First vs Request-First
    • Geração de Código
    • Ambientes e variáveis
      • Visão geral
      • Utilizar Variáveis
      • Gestão de Ambientes
    • Segredos do cofre
      • Visão geral
      • HashiCorp Vault
      • Azure Key Vault
      • AWS Secrets Manager
    • Módulos de valores dinâmicos
      • Airline
      • Animal
      • Cor
      • Comércio
      • Empresa
      • Base de Dados
      • Tipo de dados
      • Data
      • Finanças
      • Alimentação
      • Git
      • Hacker
      • Helpers
      • Imagem
      • Internet
      • Localização
      • Lorem
      • Música
      • Número
      • Pessoa
      • Telefone
      • Ciência
      • String
      • Sistema
      • Veículo
      • Word
    • Pré e pós-processadores
      • Visão geral
      • Asserção
      • Extrair variável
      • Espera
      • Segurança
      • Operações de banco de dados
        • Visão geral
        • MySQL
        • MongoDB
        • Redis
        • Cliente Oracle
      • Uso de scripts
        • Visão geral
        • Scripts de Pré-processamento
        • Scripts de pós-processamento
        • Scripts Públicos
        • Referência de Scripts do Postman
        • Chamar Outras Linguagens de Programação
        • Utilizar Bibliotecas JS
        • Visualizar Respostas
        • Exemplos de scripts
          • Scripts de Asserção
          • Utilização de Variáveis
          • Modificar Pedidos
          • Outros exemplos
    • Depuração de APIs
      • Depurador de Agentes de IA
      • Depurador A2A
  • Projetar APIs
    • Visão geral
    • Criar um Novo Projeto de API
    • Noções Básicas de Endpoints
    • Diretrizes de Design de API
    • Módulo
    • Configurar vários exemplos de corpo do pedido
    • Componentes
    • Campos Comuns
    • Parâmetros Globais
    • Histórico de Alterações do Endpoint
    • Comentários
    • Gestão de Endpoints em Lote
    • API de Protocolo Personalizado
    • Modo Spec-first (Beta)
    • Esquemas de segurança
      • Visão geral
      • Criar um Esquema de Segurança
      • Utilizar o Esquema de Segurança
      • Esquema de Segurança na Documentação Online
    • Recursos avançados
      • Campos de Endpoint Personalizados
      • Cenários de Teste Associados
      • Estado do endpoint
      • Aparência das listas de parâmetros
      • Identificação Única de Endpoint
    • Schemas
      • Visão geral
      • Criar um Novo Schema
      • Criar um Schema
      • Gerar esquemas a partir de JSON, etc.
      • oneOf, allOf, anyOf
      • Utilizar Discriminator
  • Testes de API
    • Visão geral
    • Cenários de teste
      • Criar um Cenário de Teste
      • Passar Dados Entre Pedidos
      • Condições de Controlo de Fluxo
      • Sincronizar Dados de Endpoints e Casos de Endpoint
      • Importar Endpoints e Casos de Endpoint de Outros Projetos
      • Exportar Cenários de Teste
    • Relatórios de teste
      • Relatórios de Teste
    • Executar cenários de teste
      • Executar um cenário de teste
      • Executar cenários de teste em lote
      • Testes Orientados por Dados
      • Dados de Teste Partilhados
      • Tarefas agendadas
      • Gerir o ambiente de runtime de APIs de outros projetos
    • Suíte de testes
      • Visão geral
      • Criar Uma Suite de Testes
      • Orquestrar Conjunto de Testes
      • Executar Conjuntos de Testes Localmente
      • Executar conjuntos de testes via CLI
      • Tarefas agendadas
    • Testar APIs
      • Testes de Integração
      • Testes de desempenho
      • Testes de Ponta a Ponta
      • Teste de regressão
      • Testes de Contrato
    • Apidog CLI
      • Visão geral
      • Instalar e Executar o Apidog CLI
      • Opções da CLI do Apidog
    • CI/CD
      • Visão geral
      • Integrar com o Github Actions
      • Integrar com o Gitlab
      • Integrar com Jenkins
      • Acionar Teste por Commit Git
  • Publicar documentação de API
    • Visão geral
    • Tecnologias de API Suportadas
    • Partilha Rápida
    • Visualizar a Documentação da API
    • Documentação Markdown
    • Publicar Sites de Documentação
    • Página de Início de Sessão Personalizada
    • Layouts personalizados
    • CSS, JavaScript, HTML personalizados
    • Domínio Personalizado
    • Funcionalidades de IA
    • Definições de SEO
    • Configurações avançadas
      • Pesquisa na Documentação
      • Proxy CORS
      • Integrar o Google Analytics
      • Definições da Árvore de Pastas
      • Definições de Visibilidade
      • Incorporar Valores em URLs de Documentação
    • Versões da API
      • Visão geral
      • Criar Versões de API
      • Publicar versões de API
      • Partilhar Endpoints com Versões da API
  • Branches
    • Visão geral
    • Criar uma Branch de Sprint
    • Testar APIs numa Branch
    • Conceber APIs numa Ramificação
    • Mesclar Branches de Sprint
    • Gerir Branches de Sprint
    • AI Branch (Beta)
  • Recursos de IA
    • Visão geral
    • Ativar Funcionalidades de IA
    • Gerar Casos de Teste
    • Modificar esquemas com IA
    • Verificação de Conformidade do Endpoint
    • Verificação da Completude da Documentação da API
    • Nomeação de Campos com IA
    • Perguntas frequentes
  • Servidor MCP do Apidog
    • Visão geral
    • Ligar o Projeto Apidog à IA
    • Ligar Documentação Publicada à IA
    • Ligar Ficheiros OpenAPI à IA
  • Boas práticas
    • Tratamento de Assinaturas de API
    • Aceder a APIs Protegidas por OAuth 2.0
    • Fluxo de trabalho de colaboração
    • Gestão do Estado de Autenticação
  • Espaço offline
    • Visão geral
  • Administração
    • Gerenciamento de projetos
      • Gerir Projetos
      • Definições de Notificação
      • Gerir Membros do Projeto
      • Recursos do projeto
        • Ligação à Base de Dados
        • Ligação Git
    • Gerenciamento de equipes
      • Gerir Equipas
      • Gerir Membros da Equipa
      • Atividades da Equipa
      • Funções e permissões da equipa
      • Recursos da equipe
        • General Runner
        • Variáveis de Equipa
        • Agente Proxy de Pedidos
      • Colaborações em tempo real
        • Colaboração em Equipa
    • Checklist de integração
      • Conceitos Básicos
      • Guia de Integração Inicial
    • Gerenciamento da organização
      • Gerir a Organização
      • Funções e Permissões da Organização
      • Gerenciamento de planos
        • Gestores de Faturação em Organizações
      • Single Sign-On (SSO)
        • Visão Geral do SSO
        • Configurar o Microsoft Entra ID
        • Configurar o Okta
        • Configurar SSO para uma organização
        • Gerir Contas de Utilizador
        • Mapear Grupos para Equipas
      • Provisionamento SCIM
        • Introdução ao Provisionamento SCIM
        • Microsoft Entra ID
        • Okta
      • Recursos da organização
        • Self-Hosted Runner
  • Cobrança
    • Visão geral
    • Créditos
    • Atualizar o seu plano
    • Métodos de Pagamento Alternativos
    • Gestão de Subscrições
    • Mover Equipas Pagas para Organizações
  • Complementos
    • API Hub
    • Plugin Apidog Intellij IDEA
    • Extensão do navegador
      • Chrome
      • Microsoft Edge
    • Proxy de requisições
      • Proxy de pedidos na Web
      • Proxy de Pedidos em Documentação Partilhada
      • Proxy de Pedido no Cliente
  • Dados e segurança
    • Armazenamento e Segurança de Dados
    • Privacidade e Segurança dos Dados do Utilizador
    • Encaminhamento de Pedidos e Segurança dos Dados
  • Referências
    • Abordagem API Design-First
    • Extensões da Especificação OpenAPI do Apidog
    • JSONPath
    • XPath
    • Expressões Regulares
    • JSON Schema
    • Formato de ficheiro CSV
    • Instalar o Ambiente Java
    • Ambiente de Implementação do Runner
    • Sintaxe Markdown do Apidog
    • Extensões Swagger do Apidog
      • Visão geral
      • x-apidog-folder
      • x-apidog-status
      • x-apidog-name
      • x-apidog-maintainer
    • Extensões JSON Schema do Apidog
      • Visão geral
      • x-apidog-mock
      • x-apidog-orders
      • x-apidog-enum
  • Central de suporte
  1. Depuração de APIs

Depurador A2A

A2A (Agent2Agent) é um protocolo aberto para comunicação entre Agentes. Através do A2A, diferentes Agentes podem descobrir as capacidades uns dos outros, enviar mensagens e devolver resultados de execução.
Depurador A2A é uma ferramenta visual para depurar Agentes A2A. Pode ligar-se a um Agente A2A, enviar mensagens de teste, ver o conteúdo devolvido pelo Agente, o estado de execução e os registos de depuração, ajudando os programadores a resolver rapidamente problemas de integração de Agentes, entrega de mensagens e resultados devolvidos.
O Depurador A2A é adequado para os seguintes cenários:
Verificar se um Agente A2A consegue ligar-se normalmente
Ver o nome, a descrição, as capacidades e as Competências do Agente
Enviar texto ou anexos ao Agente para verificar a sua resposta
Resolver problemas de ligação ou de pedido, tais como autenticação, Cabeçalho, tipos de ficheiro, etc.
Ver detalhes do pedido e da resposta para identificar a causa de conteúdo devolvido anómalo
Se estiver a desenvolver ou integrar um Agente A2A, pode utilizar o Depurador A2A para verificar primeiro se o Agente consegue ligar-se e responder normalmente antes de o integrar em fluxos de trabalho empresariais formais.
Recomendamos a utilização do cliente Apidog mais recente para experimentar todas as funcionalidades do Depurador de Agentes de IA.

Ligar-se a um Agente A2A#

Introduza o URL do Cartão do Agente na parte superior da página e, em seguida, clique em Ligar.
Após uma ligação bem-sucedida, o estado na parte superior será apresentado como Ligado. Neste momento, pode ver as informações do Agente e começar a enviar mensagens.
Se precisar de mudar para outro Agente, pode clicar em Desligar e, em seguida, voltar a introduzir o URL do Cartão do Agente.

Escrever Mensagens de Teste#

Escreva a entrada de teste a enviar ao Agente no separador Mensagens.
A área de edição de mensagens está dividida em secções esquerda e direita:
Lado esquerdo: introduzir texto da mensagem, carregar anexos, configurar Metadados
Lado direito: ver o conteúdo bruto do pedido correspondente
Normalmente, apenas precisa de introduzir texto no lado esquerdo e clicar em Enviar. O conteúdo bruto do pedido no lado direito é utilizado principalmente para cenários de depuração avançada, por exemplo, quando precisa de confirmar a estrutura de dados real que está a ser enviada ou ajustar manualmente o conteúdo do pedido.

Enviar Mensagens#

Depois de concluir a configuração da mensagem, clique em Enviar.
Se não houver atualmente nenhum Agente ligado, o Depurador A2A tentará primeiro estabelecer ligação; enviará a mensagem após a ligação ser bem-sucedida.
Após o envio, pode ver a mensagem do utilizador e o conteúdo devolvido pelo Agente na área de mensagens.

Ver Mensagens de Resposta#

A área de mensagens apresenta mensagens do utilizador e respostas do Agente na sessão atual.
O conteúdo devolvido pelo Agente pode ser texto simples, ou pode incluir estado da tarefa, resultados de execução ou artefactos gerados. Pode determinar rapidamente se o Agente compreendeu e processou corretamente o pedido através da área de apresentação de mensagens.
Clique em qualquer mensagem de depuração para ver os detalhes à direita. O painel de detalhes suporta três vistas:
Pré-visualização: apresentar o conteúdo principal de forma mais legível
Conteúdo: ver texto ou dados principais na mensagem
Dados Brutos: ver o JSON bruto completo
A captura de ecrã abaixo mostra uma resposta para a pergunta:
What is the distance between the Earth and the Moon?
Pode clicar em Limpar para eliminar os registos de depuração atuais.

Ver o Cartão do Agente#

O separador Cartão do Agente no painel de depuração é utilizado para ver a descrição das capacidades do Agente atualmente ligado.
Este painel apresenta:
Nome e descrição do Agente
Endereço do Agente, versão do protocolo, número da versão
Capacidades suportadas pelo Agente, como, por exemplo, se suporta respostas em streaming, notificações push, histórico de estados, etc.
Tipos de entrada e tipos de saída predefinidos
Competências declaradas pelo Agente
Erros de validação do Cartão do Agente
Conteúdo bruto do Cartão do Agente
Se o Cartão do Agente tiver campos em falta ou problemas de formatação, pode ver os erros de validação neste painel e resolver o problema comparando com o conteúdo bruto.

Adicionar Anexos#

Se o Agente atual suportar entrada de ficheiros, pode clicar no botão de anexo por baixo da área de entrada de mensagens para carregar ficheiros.
O Depurador A2A determina se o carregamento de anexos é permitido com base nos tipos de entrada declarados pelo Agente:
Se o Agente suportar apenas entrada de texto, o botão de anexo fica indisponível
Se o Agente suportar apenas tipos de ficheiro específicos, só pode carregar ficheiros de tipos correspondentes
Se o Agente suportar qualquer tipo de ficheiro, pode carregar qualquer ficheiro
Após um carregamento bem-sucedido, o anexo será enviado ao Agente juntamente com a mensagem.

Configurar Autenticação#

Se o Agente A2A exigir autenticação, pode configurar o método de autenticação no separador Autenticação.
São suportados os seguintes tipos de autenticação:
Método de AutenticaçãoDescrição
NenhumNão é adicionada informação de autenticação
Bearer TokenAutenticar utilizando um token
Basic AuthAutenticar utilizando nome de utilizador e palavra-passe
API KeyPassar a API Key através de um Cabeçalho especificado
Se for devolvido um erro de não autorizado ao enviar uma mensagem, verifique se o método de autenticação, o token, o nome de utilizador/palavra-passe ou a API Key estão corretos.

Configurar Cabeçalhos#

No separador Cabeçalho, pode adicionar Cabeçalhos de pedido personalizados.
Cabeçalhos personalizados são frequentemente utilizados nos seguintes cenários:
Passagem de parâmetros empresariais, tais como ID do inquilino, identificador de ambiente, etc.
Autenticação através de gateways, proxies ou serviços internos
Depuração de serviços de Agente que exigem cabeçalhos de pedido especiais
O número no separador Cabeçalho indica o número de Cabeçalhos válidos atualmente configurados.

Adicionar Metadados#

Expanda Metadados por baixo da área de edição de mensagens para adicionar pares chave-valor personalizados a esta mensagem.
Os metadados são adequados para transmitir identificadores de contexto, parâmetros empresariais ou marcadores de depuração. Por exemplo, pode adicionar informações como nome do ambiente, ID de utilizador ou origem do pedido.

Perguntas Frequentes#

O que devo fazer se a ligação falhar?#

Verifique o seguinte:
1.
Se o URL do Cartão do Agente está correto e acessível a partir do ambiente atual.
2.
Se o serviço do Agente está em execução.
3.
Se for necessária autenticação, se as informações de autenticação corretas foram configuradas no separador Autenticação.
4.
Se são necessários Cabeçalhos adicionais, tais como ID do inquilino, identificador de ambiente ou informações de autenticação de gateway.
5.
Se o conteúdo devolvido pelo Cartão do Agente é JSON válido.

Não consegue carregar anexos após uma ligação bem-sucedida?#

Isto acontece normalmente porque o Agente atual não declarou suporte para entrada de ficheiros, ou permite apenas o carregamento de tipos de ficheiro específicos.
Veja os tipos de entrada suportados pelo Agente no separador Cartão do Agente e confirme se o tipo de ficheiro carregado corresponde.

Como posso ver o pedido e a resposta completos?#

Clique no registo de pedido ou resposta correspondente no separador Mensagens do painel de depuração e, em seguida, mude para a vista Dados Brutos para ver o JSON completo.

O que devo fazer se o conteúdo devolvido pelo Agente for apresentado de forma anómala?#

Pode resolver o problema pela seguinte ordem:
1.
Verifique o conteúdo de pré-visualização na mensagem de depuração para confirmar se o Agente devolveu um resultado.
2.
Mude para a vista Dados Brutos para ver a resposta completa.
3.
Verifique se os tipos de entrada, os tipos de saída e as Competências declaradas no Cartão do Agente correspondem ao esperado.
4.
Verifique se existem avisos de erro de validação na mensagem ou nos detalhes de depuração.
Modified at 2026-06-09 08:54:45
Previous
Depurador de Agentes de IA
Next
Visão geral
Built with