O lançamento de abril é principalmente sobre uma coisa: tornar o desenvolvimento de Agentes de IA mais fácil de inspecionar.
Se você está construindo agentes, já sabe que a parte difícil nem sempre é a resposta final. É tudo o que aconteceu antes da resposta aparecer. O que o agente pensou que o usuário queria? Qual ferramenta ele chamou? O que voltou dessa ferramenta? O prompt falhou ou a lógica de negócios falhou?
Este mês, o Apidog adiciona novas ferramentas para esse tipo de trabalho: AI Agent Debugger, A2A Debugger, importação de API do Postman para migrações maiores, uma experiência melhor do Ask AI em documentos publicados e provedores de modelo personalizados.
Aqui está o que mudou👇
⭐ Novas Atualizações
🔥 AI Agent Debugger: Inspecione a Execução Completa do Agente
O Apidog tem suportado depuração visual para endpoints SSE há algum tempo. Isso tem sido útil para respostas de modelo em streaming, atualizações de progresso, notificações em tempo real e outras APIs orientadas a eventos.
Mas a depuração de agentes precisa de mais do que um visualizador de stream.
Uma resposta do modelo apenas informa onde o agente chegou. Não informa como ele chegou lá. Em projetos reais, você frequentemente precisa ver os passos intermediários: as voltas da conversa, chamadas de modelo, chamadas de ferramenta MCP, execução de Skill personalizada, resultados de ferramentas e saída final.
O novo AI Agent Debugger foi construído para isso.
Em vez de verificar apenas a resposta final, você pode seguir o caminho de execução do agente dentro do Apidog. Cada rodada de conversa, chamada de modelo, invocação de ferramenta MCP, execução de Skill e resultado final é gravado em um só lugar.
Isso torna muito mais fácil responder a perguntas práticas de depuração:
- O prompt forneceu contexto suficiente ao modelo?
- O agente escolheu a ferramenta certa?
- A ferramenta MCP retornou o resultado esperado?
- O problema veio da configuração do modelo, dos parâmetros da ferramenta ou da lógica de negócios?
Sistemas de agentes podem ficar complicados rapidamente. Isso oferece às equipes uma maneira mais limpa de ver o que realmente aconteceu.
🤝 A2A Debugger: Teste a Comunicação Agente-para-Agente
Sistemas multiagentes estão se tornando mais comuns. Uma vez que os agentes começam a trabalhar juntos, você precisa de uma maneira confiável de verificar se eles podem passar tarefas, trocar mensagens e retornar resultados corretamente.
O Apidog agora suporta depuração para o protocolo A2A, ou Agente-para-Agente, do Google.
Você pode enviar requisições A2A diretamente, inspecionar parâmetros de requisição, verificar respostas e validar o resultado da interação. Isso ajuda as equipes a testar a comunicação agente-para-agente sem pular entre ferramentas separadas ou ler detalhes brutos do protocolo manualmente.
A diferença entre as duas novas ferramentas de depuração é simples:
- O AI Agent Debugger verifica o que acontece dentro de um único agente enquanto ele executa uma tarefa.
- O A2A Debugger verifica se um agente pode se comunicar com outro agente.
A maioria das equipes que trabalham com agentes precisará de ambos, mais cedo ou mais tarde.
📦 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 a importação de arquivos locais do Postman. Agora você também pode importar Workspaces, Coleções e Ambientes através da API do Postman.
Isso é projetado para migração em massa ao criar novos projetos. Na prática, é mais próximo de mover um Workspace inteiro do Postman para o Apidog. Se sua conta do Postman tiver vários Workspaces, o Apidog criará projetos correspondentes após a importação.
Isso significa menos etapas de exportação local, upload e limpeza. Para pequenas importações, arquivos locais ainda funcionam. Para migrações maiores de workspace, a rota da API deve ser muito menos tediosa.
📄 Pergunte à IA em Documentos Publicados Agora Abre na Barra Lateral
O recurso Pergunte à IA em documentação publicada agora funciona em uma barra lateral.
Os leitores podem manter o documento atual aberto enquanto fazem perguntas sobre ele. Isso parece uma pequena mudança na interface do usuário, mas remove muito vai e vem. Você pode ler a documentação da API, fazer uma pergunta, acompanhar e ainda manter seu lugar na página.
É especialmente útil para documentos mais longos, onde a resposta pode estar em algum lugar da página, mas não é fácil de encontrar rapidamente.
🧠 Provedores de Modelo de IA Personalizados
As equipes também podem conectar provedores personalizados com uma URL Base personalizada. Se sua empresa já usa um serviço de modelo auto-hospedado ou um gateway de modelo interno, você pode trazer essa configuração para o Apidog em vez de mudar de ferramentas toda vez que precisar depurar um fluxo de trabalho relacionado à IA.
🐞 Correções de Bugs e Melhorias Menores
Também lançamos uma série de correções e atualizações de qualidade de vida este 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 --branchnã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
Abril é um lançamento prático para equipes que constroem produtos de Agentes de IA.
O AI Agent Debugger ajuda você a inspecionar uma única execução de agente. O A2A Debugger ajuda você a testar a comunicação entre agentes. A importação de API do Postman torna a migração menos dolorosa. A barra lateral Pergunte à IA torna os documentos publicados mais fáceis de usar. Provedores de modelo personalizados dão às equipes mais controle sobre sua configuração de IA.
Nada disso é chamativo por ser chamativo. É o tipo de ferramenta que você começa a querer quando o desenvolvimento de agentes passa de demos para projetos reais.
💬 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