APIDOG Abril: Novidades, Debugger IA, Debugger A2A e Migração Postman Fácil

O lançamento de abril foca em um problema comum no desenvolvimento de Agentes de IA: inspecionar o que aconteceu antes da resposta final.

Experimente o Apidog hoje

Quando você está construindo agentes, a dificuldade raramente está apenas na resposta retornada. O desafio é entender o caminho até ela:

• O agente interpretou corretamente a intenção do usuário?
• Qual modelo foi chamado?
• Qual ferramenta foi executada?
• O retorno da ferramenta estava correto?
• O erro veio do prompt, da configuração do modelo ou da lógica de negócio?

Neste mês, o Apidog adiciona recursos para tornar esse fluxo mais fácil de depurar:

• AI Agent Debugger
• A2A Debugger
• Importação do Postman via API
• Pergunte à IA em documentos publicados na barra lateral
• Provedores personalizados de modelo de IA

⭐ Novas Atualizações

🔥 AI Agent Debugger: inspecione a execução completa do agente

O Apidog já suportava depuração visual para endpoints SSE, útil para:

• respostas de modelo em streaming;
• atualizações de progresso;
• notificações em tempo real;
• APIs orientadas a eventos.

Mas depurar agentes exige mais do que visualizar um stream.

Uma resposta final mostra onde o agente chegou. Para corrigir problemas reais, você precisa ver como ele chegou lá.

Com o novo AI Agent Debugger, você pode acompanhar a execução completa do agente dentro do Apidog, incluindo:

• rodadas de conversa;
• chamadas de modelo;
• chamadas de ferramenta MCP;
• execução de Skills personalizadas;
• resultados das ferramentas;
• saída final.

Na prática, isso ajuda a responder perguntas como:

• O prompt forneceu contexto suficiente?
• O agente escolheu a ferramenta correta?
• A ferramenta MCP retornou o resultado esperado?
• O problema está no modelo, nos parâmetros da ferramenta ou na regra de negócio?

Esse tipo de inspeção é especialmente útil quando o fluxo do agente deixa de ser uma demo simples e passa a envolver múltiplas etapas, ferramentas e decisões intermediárias.

🤝 A2A Debugger: teste comunicação agente-para-agente

Sistemas multiagentes estão se tornando mais comuns. Quando agentes começam a trabalhar juntos, você precisa validar se eles conseguem:

• delegar tarefas;
• trocar mensagens;
• retornar resultados;
• lidar corretamente com parâmetros e respostas.

O Apidog agora suporta depuração para o protocolo A2A, ou Agente-para-Agente, do Google.

Com o A2A Debugger, você pode:

1. enviar requisições A2A diretamente;
2. inspecionar os parâmetros da requisição;
3. verificar a resposta;
4. validar o resultado da interação entre agentes.

A diferença entre os dois novos recursos é direta:

• AI Agent Debugger: depura o que acontece dentro de um único agente durante a execução.
• A2A Debugger: depura a comunicação entre um agente e outro.

Se você está criando sistemas com múltiplos agentes, provavelmente vai precisar dos dois.

📦 Importe dados do Postman através da API do Postman

A migração do Postman agora tem uma opção melhor para equipes maiores.

O Apidog já suportava importação de arquivos locais do Postman. Agora, também é possível importar:

• Workspaces;
• Coleções;
• Ambientes.

Tudo isso através da API do Postman.

Esse fluxo é mais adequado para migrações em massa ao criar novos projetos.

Em vez de exportar arquivos manualmente, fazer upload e depois ajustar tudo, você pode importar dados diretamente. Se sua conta do Postman tiver vários Workspaces, o Apidog criará projetos correspondentes após a importação.

Use assim:

• Para importações pequenas: arquivos locais ainda funcionam.
• Para migrações maiores: use a importação via API do Postman.

📄 Pergunte à IA em documentos publicados agora abre na barra lateral

O recurso Pergunte à IA em documentação publicada agora funciona em uma barra lateral.

Isso permite que o leitor mantenha a documentação aberta enquanto faz perguntas sobre ela.

Na prática, o fluxo fica mais simples:

1. leia a documentação da API;
2. abra a barra lateral do Pergunte à IA;
3. faça uma pergunta sobre o conteúdo;
4. continue na mesma página, sem perder o contexto.

Essa mudança é útil principalmente em documentações longas, onde a resposta pode estar na página, mas não é fácil de localizar rapidamente.

🧠 Provedores de modelo de IA personalizados

Equipes agora podem conectar provedores personalizados usando uma URL Base personalizada.

Isso é útil se sua empresa já usa:

• um serviço de modelo auto-hospedado;
• um gateway interno de modelos;
• uma configuração própria para fluxos de IA.

Assim, você pode usar essa configuração no Apidog ao depurar fluxos relacionados à IA, sem alternar entre várias ferramentas.

🐞 Correções de bugs e melhorias menores

Também foram lançadas correções e melhorias neste mês:

• Corrigido um problema onde a mesclagem inteligente OpenAPI não mantinha exemplos de resposta de endpoint.
• Corrigido um problema onde a mesclagem de uma branch filha para uma branch principal protegida poderia incluir endpoints que não foram selecionados.
• Corrigida a exibição incorreta do menu suspenso ao criar versões de endpoint a partir de branches.
• Corrigido um problema onde TestData e TestCases não funcionavam ao executar testes via CLI.
• Corrigido um problema onde a exportação OpenAPI incluía componentes de resposta de módulos não relacionados.
• Corrigida a formatação da exportação Markdown para JSON com comentários.
• Corrigido um erro de exportação Word causado por crypto is not defined.
• Corrigido um problema onde a importação do Knife4j com Basic Auth habilitado não mostrava os campos de usuário e senha.
• Corrigido um erro de filtragem de endpoint quando as tags eram números.
• Corrigido um problema onde apidog endpoint list --branch não retornava dados para a branch especificada.
• Corrigidos vários problemas de parâmetros, filtragem e mensagens de erro da ferramenta MCP.
• Corrigido um problema onde o código gerado estava faltando a opção de configuração typescriptThreePlus.

🌟 O que isso significa

Este lançamento é voltado para equipes que estão levando Agentes de IA para projetos reais.

Resumo prático:

• Use o AI Agent Debugger para entender a execução interna de um agente.
• Use o A2A Debugger para validar comunicação entre agentes.
• Use a importação via API do Postman para migrações maiores.
• Use o Pergunte à IA na barra lateral para melhorar a experiência em documentação publicada.
• Use provedores personalizados de modelo para trabalhar com sua própria infraestrutura de IA.

O objetivo não é adicionar recursos chamativos. É reduzir o tempo gasto tentando descobrir onde um fluxo de agente falhou.

💬 Participe da conversa

Conecte-se com outros engenheiros de API e com a equipe Apidog:

• Junte-se à nossa comunidade do Discord para discussões e suporte em tempo real.
• Participe da nossa comunidade do Slack para conversas técnicas.
• Siga-nos no X (Twitter) para as últimas atualizações.

P.S. Para todos os detalhes sobre as atualizações, confira o Apidog Changelog!

Atenciosamente,

A Equipe Apidog