O Depurador de Agente de IA do Apidog está disponível na versão mais recente do cliente Apidog em todos os planos, incluindo o Gratuito. O depurador permite que você execute agentes de IA contra modelos OpenAI e Anthropic, conecte servidores MCP, inspecione cada chamada de modelo e invocação de ferramenta em um painel de Rastros, e acompanhe o custo por execução.
Este artigo aborda quem pode usar o Depurador de Agente de IA, o que ele suporta, o que ele não suporta, como habilitá-lo e o que permanece igual em seus projetos Apidog existentes.
O que está disponível
O Depurador de Agente de IA é fornecido no cliente Apidog padrão. Não há licença separada, plano adicional ou taxa por usuário.
- Os planos Gratuito, Básico, Profissional e Empresarial incluem o Depurador de Agente de IA.
- O recurso é habilitado por padrão; não há necessidade de alternar nada.
- Você deve estar na versão mais recente do cliente Apidog. Clientes mais antigos não possuem a aba do Depurador de Agente de IA.
Provedores de modelo suportados
| Provedor | Status | Modelos |
|---|---|---|
| OpenAI | Suportado | GPT-5.5, GPT-5.5 Instant, série o, e qualquer modelo na conta OpenAI |
| Anthropic | Suportado | Claude 4.7 Sonnet, Claude 4.7 Opus, Claude 4.7 Haiku |
| Endpoints personalizados compatíveis com OpenAI | Suportado via substituição de URL Base | Qualquer provedor que exponha uma API compatível com OpenAI |
| Outros provedores (Google, Mistral, xAI) | No roteiro | Atualmente não são de primeira classe |
Métodos de conexão com servidor MCP
O depurador se comunica nativamente com o Protocolo de Contexto de Modelo. Três transportes são suportados:
- STDIO. Subprocesso local. Melhor para servidores MCP em desenvolvimento ativo.
- HTTP Streamable. Servidores MCP hospedados acessíveis via HTTP.
- SSE. Eventos Enviados pelo Servidor legados. Ainda comum; suportado para compatibilidade retroativa.
A autenticação para servidores MCP abrange dois padrões: cabeçalhos padrão (chave de API) e OAuth 2.0 (troca completa de token).
O que o depurador cobre
O depurador captura a cadeia de execução completa de uma execução de agente:
- Chamadas de modelo com cargas de solicitação e resposta completas.
- Rastros de pensamento do modelo, quando o modelo os expõe (série o da OpenAI, pensamento estendido da Anthropic).
- Invocações de ferramentas com valores de parâmetros e dados de retorno.
- Tráfego do servidor MCP, listado no painel de Rastros como qualquer outra chamada de ferramenta.
- Ferramentas integradas:
bash,web_fetch,read,edit,write,grep,glob,kill_shell. - Métricas de desempenho por execução: tempo de resposta, tokens de entrada, tokens de saída, custo estimado.
- Habilidades: pacotes salvos de prompt do sistema + lista de ferramentas + parâmetros para reexecutar um cenário.
O que o depurador não cobre
- Observabilidade em produção. Use uma ferramenta de observabilidade dedicada para registro de tráfego de longo prazo.
- Teste de regressão automatizado. Para grades de prompts contra fixtures, use uma estrutura como Promptfoo.
- Tráfego de protocolo Agente-para-Agente (A2A). Para A2A, use o Depurador A2A separado do Apidog.
- Validação de servidor MCP isoladamente. Para testar as ferramentas e recursos de um único servidor MCP sem um loop de agente, use o fluxo de teste de servidor MCP do Apidog.
Como habilitá-lo
- Atualize o Apidog para a versão mais recente.
- Abra o Apidog e clique em Depurador de Agente de IA na barra de abas superior.
- Selecione um provedor de modelo e um modelo.
- Confirme a URL Base (preenchida automaticamente pelo provedor) ou a substitua por um endpoint personalizado.
- Cole sua chave de API.
- Clique em Executar em um thread vazio para confirmar a conexão.
Nenhuma configuração em nível de projeto é necessária. O depurador é executado em seu próprio espaço de trabalho.
O que permanece igual
- Projetos Apidog existentes, definições de API e suítes de teste não são afetados.
- O fluxo de teste de servidor MCP e o Depurador A2A continuam a funcionar em paralelo.
- A depuração de endpoints de API, servidores mock e edição OpenAPI permanecem inalterados.
- O faturamento e os níveis de plano permanecem inalterados; o Depurador de Agente de IA não consome nenhum novo crédito.
Você paga pelas chamadas de API do modelo subjacente de acordo com o faturamento da sua conta OpenAI ou Anthropic. O Apidog não cobra sobretaxa pelo uso.
Para administradores de Equipes e Empresas
- O Depurador de Agente de IA é habilitado por usuário. Cada membro usa sua própria chave de API do provedor.
- As chaves de API inseridas no depurador são armazenadas localmente no cliente de cada usuário. Elas não são transmitidas para os servidores Apidog.
- Os proprietários de espaços de trabalho podem gerenciar centralmente endpoints de servidor MCP compartilhados através de variáveis de ambiente padrão do Apidog.
- Controles de auditoria e acesso para servidores MCP seguem o próprio modelo de autenticação do servidor MCP (cabeçalhos ou OAuth 2.0).
Limitações conhecidas
- A expansão de provedores além de OpenAI e Anthropic está no roteiro; use a substituição de URL Base para provedores compatíveis com OpenAI enquanto isso.
- O compartilhamento de rastros é apenas local. Para compartilhar um rastro, copie o JSON da visualização Raw ou tire uma captura de tela do painel.
- A estimativa de custo é uma aproximação local baseada nos preços publicados do modelo; consulte o painel de uso do seu provedor para faturamento.