4월 릴리스는 주로 한 가지에 관한 것입니다: AI Agent 개발을 더 쉽게 검사할 수 있도록 만드는 것입니다.
에이전트를 구축하고 있다면, 어려운 부분이 항상 최종 답변은 아니라는 것을 이미 알고 계실 것입니다. 그것은 답변이 나타나기 전에 일어난 모든 것입니다. 에이전트는 사용자가 무엇을 원한다고 생각했을까요? 어떤 도구를 호출했을까요? 그 도구에서 무엇이 돌아왔을까요? 프롬프트가 실패했나요, 아니면 비즈니스 로직이 실패했나요?
이번 달, Apidog는 이러한 종류의 작업을 위한 새로운 도구들을 추가합니다: AI Agent 디버거, A2A 디버거, 대규모 마이그레이션을 위한 Postman API 가져오기, 게시된 문서에서 더 나은 Ask AI 경험, 그리고 사용자 정의 모델 제공자.
변경된 내용은 다음과 같습니다👇
⭐ 새로운 업데이트
🔥 AI Agent 디버거: 전체 에이전트 실행 검사
Apidog는 SSE 엔드포인트에 대한 시각적 디버깅을 오랫동안 지원해왔습니다. 이는 스트리밍 모델 응답, 진행 상황 업데이트, 실시간 알림 및 기타 이벤트 기반 API에 유용했습니다.
하지만 에이전트 디버깅은 스트림 뷰어 이상을 필요로 합니다.
모델 응답은 에이전트가 어디에 도달했는지만 알려줄 뿐입니다. 어떻게 거기에 도달했는지는 알려주지 않습니다. 실제 프로젝트에서는 종종 그 사이의 단계들을 볼 필요가 있습니다: 대화 턴, 모델 호출, MCP 도구 호출, 사용자 정의 스킬 실행, 도구 결과, 그리고 최종 출력.
새로운 AI Agent 디버거는 이를 위해 만들어졌습니다.
최종 응답만 확인하는 대신, Apidog 내에서 에이전트의 실행 경로를 따라갈 수 있습니다. 각 대화 라운드, 모델 호출, MCP 도구 호출, 스킬 실행, 그리고 최종 결과가 한 곳에 기록됩니다.
이를 통해 실제 디버깅 질문에 훨씬 쉽게 답할 수 있습니다:
- 프롬프트가 모델에 충분한 컨텍스트를 제공했는가?
- 에이전트가 올바른 도구를 선택했는가?
- MCP 도구가 예상된 결과를 반환했는가?
- 문제가 모델 구성, 도구 매개변수 또는 비즈니스 로직에서 발생했는가?
에이전트 시스템은 빠르게 복잡해질 수 있습니다. 이는 팀에게 실제로 무슨 일이 일어났는지 확인할 수 있는 더 깔끔한 방법을 제공합니다.
🤝 A2A 디버거: 에이전트 간 통신 테스트
다중 에이전트 시스템이 점점 더 보편화되고 있습니다. 에이전트가 함께 작동하기 시작하면, 작업을 전달하고, 메시지를 교환하고, 결과를 올바르게 반환하는지 확인할 수 있는 신뢰할 수 있는 방법이 필요합니다.
Apidog는 이제 Google의 A2A 또는 에이전트 간(Agent-to-Agent) 프로토콜에 대한 디버깅을 지원합니다.
A2A 요청을 직접 보내고, 요청 매개변수를 검사하고, 응답을 확인하고, 상호 작용의 결과를 검증할 수 있습니다. 이는 팀이 별도의 도구 사이를 오가거나 원시 프로토콜 세부 정보를 수동으로 읽지 않고도 에이전트 간 통신을 테스트하는 데 도움이 됩니다.
두 가지 새로운 디버깅 도구의 차이점은 간단합니다:
- AI Agent 디버거는 단일 에이전트가 작업을 실행하는 동안 내부에 어떤 일이 발생하는지 확인합니다.
- A2A 디버거는 한 에이전트가 다른 에이전트와 통신할 수 있는지 확인합니다.
에이전트 작업을 하는 대부분의 팀은 조만간 둘 다 필요하게 될 것입니다.
📦 Postman API를 통한 Postman 데이터 가져오기
Postman 마이그레이션은 이제 대규모 팀을 위한 더 나은 옵션을 제공합니다.
Apidog는 이미 로컬 Postman 파일 가져오기를 지원했습니다. 이제 Postman API를 통해 워크스페이스, 컬렉션 및 환경도 가져올 수 있습니다.
이는 새 프로젝트를 생성할 때 대량 마이그레이션을 위해 설계되었습니다. 실제로는 전체 Postman 워크스페이스를 Apidog로 옮기는 것과 더 가깝습니다. Postman 계정에 여러 워크스페이스가 있는 경우, 가져오기 후 Apidog는 해당 프로젝트를 생성합니다.
이는 로컬 내보내기, 업로드 및 정리 단계를 줄여줍니다. 작은 가져오기에는 로컬 파일이 여전히 작동합니다. 더 큰 워크스페이스 마이그레이션에는 API 경로가 훨씬 덜 지루할 것입니다.
📄 게시된 문서의 Ask AI가 이제 사이드바에서 열림
게시된 문서의 Ask AI가 이제 사이드바에서 작동합니다.
독자는 현재 문서를 열어둔 채로 질문을 할 수 있습니다. 이는 작은 UI 변경처럼 들리지만, 많은 왕복 과정을 줄여줍니다. API 문서를 읽고, 질문하고, 후속 질문을 하고, 페이지에서 자신의 위치를 유지할 수 있습니다.
특히 답변이 페이지 어딘가에 있지만 빠르게 찾기 어려운 긴 문서에 유용합니다.
🧠 사용자 정의 AI 모델 제공자
팀은 사용자 정의 기본 URL을 사용하여 사용자 정의 제공자를 연결할 수도 있습니다. 회사에서 이미 자체 호스팅 모델 서비스 또는 내부 모델 게이트웨이를 사용하는 경우, AI 관련 워크플로를 디버깅해야 할 때마다 도구를 전환하는 대신 해당 설정을 Apidog로 가져올 수 있습니다.
🐞 버그 수정 및 소규모 개선 사항
이번 달에는 다음과 같은 여러 수정 사항과 사용 편의성 업데이트도 출시했습니다:
- OpenAPI 스마트 병합이 엔드포인트 응답 예제를 유지하지 못하는 문제 수정.
- 자식 브랜치에서 보호된 메인 브랜치로 병합할 때 선택되지 않은 엔드포인트가 포함될 수 있는 문제 수정.
- 브랜치에서 엔드포인트 버전을 생성할 때 드롭다운 표시가 올바르지 않던 문제 수정.
- CLI를 통해 테스트를 실행할 때 TestData 및 TestCases가 작동하지 않던 문제 수정.
- OpenAPI 내보내기가 관련 없는 모듈의 응답 구성 요소를 포함하던 문제 수정.
- 주석이 있는 JSON에 대한 Markdown 내보내기 형식 수정.
- `crypto is not defined`로 인한 Word 내보내기 오류 수정.
- Basic Auth가 활성화된 Knife4j를 가져올 때 사용자 이름 및 비밀번호 필드가 표시되지 않던 문제 수정.
- 태그가 숫자인 경우 엔드포인트 필터링 오류 수정.
- `apidog endpoint list --branch`가 지정된 브랜치에 대한 데이터를 반환하지 않던 문제 수정.
- 여러 MCP 도구 매개변수, 필터링 및 오류 메시지 문제 수정.
- 생성된 코드에 `typescriptThreePlus` 구성 옵션이 누락된 문제 수정.
🌟 이것이 의미하는 것
4월 릴리스는 AI Agent 제품을 구축하는 팀을 위한 실용적인 릴리스입니다.
AI Agent 디버거는 단일 에이전트 실행을 검사하는 데 도움이 됩니다. A2A 디버거는 에이전트 간 통신을 테스트하는 데 도움이 됩니다. Postman API 가져오기는 마이그레이션의 어려움을 덜어줍니다. Ask AI 사이드바는 게시된 문서를 더 쉽게 사용할 수 있도록 합니다. 사용자 정의 모델 제공자는 팀이 AI 설정을 더 잘 제어할 수 있도록 합니다.
이 중 어떤 것도 화려함을 위한 화려함이 아닙니다. 이것은 에이전트 개발이 데모에서 실제 프로젝트로 넘어갈 때 필요해지기 시작하는 종류의 도구입니다.
💬 대화에 참여하세요
동료 API 엔지니어 및 Apidog 팀과 연결하세요:
- 실시간 토론 및 지원을 위해 Discord 커뮤니티에 참여하세요.
- 기술적인 대화를 위해 Slack 커뮤니티에 참여하세요.
- 최신 업데이트를 받으려면 X (Twitter)에서 팔로우하세요.
추신. 모든 업데이트에 대한 자세한 내용은 Apidog 변경 로그를 확인하세요!
감사합니다,
Apidog 팀