Cập Nhật APIDOG Tháng 4: Gỡ Lỗi AI Agent, Gỡ Lỗi A2A, Dễ Dàng Chuyển Đổi Postman

Bản phát hành tháng 4 chủ yếu tập trung vào một điều: giúp việc kiểm tra quá trình phát triển AI Agent dễ dàng hơn.

Nếu bạn đang xây dựng các agent, bạn đã biết rằng phần khó khăn không phải lúc nào cũng là câu trả lời cuối cùng. Đó là tất cả những gì đã xảy ra trước khi câu trả lời xuất hiện. Agent nghĩ người dùng muốn gì? Nó đã gọi công cụ nào? Công cụ đó trả về gì? Lời nhắc bị lỗi hay logic nghiệp vụ bị lỗi?

Tháng này, Apidog bổ sung các công cụ mới cho công việc đó: AI Agent Debugger, A2A Debugger, nhập API Postman cho các đợt di chuyển lớn hơn, trải nghiệm Ask AI tốt hơn trong tài liệu đã xuất bản và các nhà cung cấp mô hình tùy chỉnh.

Dưới đây là những gì đã thay đổi👇

⭐ Cập Nhật Mới

🔥 AI Agent Debugger: Kiểm Tra Toàn Bộ Quá Trình Hoạt Động Của Agent

Apidog đã hỗ trợ gỡ lỗi trực quan cho các điểm cuối SSE một thời gian. Điều đó hữu ích cho việc truyền phản hồi mô hình, cập nhật tiến độ, thông báo thời gian thực và các API dựa trên sự kiện khác.

Nhưng gỡ lỗi agent cần nhiều hơn một trình xem luồng.

Một phản hồi mô hình chỉ cho bạn biết agent đã kết thúc ở đâu. Nó không cho bạn biết nó đã đến đó bằng cách nào. Trong các dự án thực tế, bạn thường cần xem các bước trung gian: các lượt hội thoại, các lệnh gọi mô hình, các lệnh gọi công cụ MCP, việc thực thi Skill tùy chỉnh, kết quả công cụ và đầu ra cuối cùng.

AI Agent Debugger mới được xây dựng cho mục đích đó.

Thay vì chỉ kiểm tra phản hồi cuối cùng, bạn có thể theo dõi đường dẫn thực thi của agent bên trong Apidog. Mỗi vòng hội thoại, lệnh gọi mô hình, lệnh gọi công cụ MCP, chạy Skill và kết quả cuối cùng đều được ghi lại ở một nơi.

Điều đó giúp việc trả lời các câu hỏi gỡ lỗi thực tế dễ dàng hơn nhiều:

• Lời nhắc có cung cấp đủ ngữ cảnh cho mô hình không?
• Agent có chọn đúng công cụ không?
• Công cụ MCP có trả về kết quả mong đợi không?
• Vấn đề đến từ cấu hình mô hình, tham số công cụ hay logic nghiệp vụ?

Các hệ thống agent có thể trở nên phức tạp nhanh chóng. Điều này mang lại cho các nhóm một cách rõ ràng hơn để xem những gì thực sự đã xảy ra.

🤝 A2A Debugger: Kiểm Tra Giao Tiếp Giữa Các Agent

Các hệ thống đa agent đang trở nên phổ biến hơn. Khi các agent bắt đầu làm việc cùng nhau, bạn cần một cách đáng tin cậy để kiểm tra xem chúng có thể chuyển giao nhiệm vụ, trao đổi thông điệp và trả về kết quả chính xác hay không.

Apidog hiện hỗ trợ gỡ lỗi cho giao thức A2A của Google, hay Agent-to-Agent.

Bạn có thể gửi yêu cầu A2A trực tiếp, kiểm tra các tham số yêu cầu, kiểm tra phản hồi và xác minh kết quả của tương tác. Điều này giúp các nhóm kiểm tra giao tiếp giữa các agent mà không cần phải chuyển đổi giữa các công cụ riêng biệt hoặc đọc chi tiết giao thức thô bằng tay.

Sự khác biệt giữa hai công cụ gỡ lỗi mới rất đơn giản:

• AI Agent Debugger kiểm tra những gì xảy ra bên trong một agent duy nhất khi nó thực hiện một tác vụ.
• A2A Debugger kiểm tra xem một agent có thể giao tiếp với một agent khác hay không.

Hầu hết các nhóm làm việc với các agent sẽ cần cả hai sớm hay muộn.

📦 Nhập Dữ Liệu Postman Thông Qua Postman API

Tính năng di chuyển từ Postman giờ đây có một tùy chọn tốt hơn cho các nhóm lớn hơn.

Apidog đã hỗ trợ nhập các tệp Postman cục bộ. Giờ đây, bạn cũng có thể nhập Workspaces, Collections và Environments thông qua Postman API.

Điều này được thiết kế để di chuyển hàng loạt khi tạo các dự án mới. Trên thực tế, nó gần giống như việc di chuyển toàn bộ Postman Workspace vào Apidog. Nếu tài khoản Postman của bạn có nhiều Workspace, Apidog sẽ tạo các dự án tương ứng sau khi nhập.

Điều đó có nghĩa là ít bước xuất, tải lên và dọn dẹp cục bộ hơn. Đối với các lần nhập nhỏ, tệp cục bộ vẫn hoạt động. Đối với các lần di chuyển Workspace lớn hơn, tuyến API sẽ ít tẻ nhạt hơn nhiều.

📄 Hỏi AI Trong Tài Liệu Đã Xuất Bản Giờ Đây Mở Ở Thanh Bên

Tính năng Ask AI trong tài liệu đã xuất bản giờ đây hoạt động trong một thanh bên.

Người đọc có thể giữ tài liệu hiện tại mở trong khi hỏi các câu hỏi về nó. Nghe có vẻ như một thay đổi nhỏ về giao diện người dùng, nhưng nó loại bỏ rất nhiều thao tác qua lại. Bạn có thể đọc tài liệu API, đặt câu hỏi, theo dõi và vẫn giữ được vị trí của mình trên trang.

Điều này đặc biệt hữu ích cho các tài liệu dài hơn, nơi câu trả lời có thể nằm đâu đó trên trang nhưng không dễ tìm thấy nhanh chóng.

🧠 Các Nhà Cung Cấp Mô Hình AI Tùy Chỉnh

Các nhóm cũng có thể kết nối các nhà cung cấp tùy chỉnh với một Base URL tùy chỉnh. Nếu công ty bạn đã sử dụng dịch vụ mô hình tự lưu trữ hoặc cổng mô hình nội bộ, bạn có thể đưa thiết lập đó vào Apidog thay vì chuyển đổi công cụ mỗi khi cần gỡ lỗi một quy trình làm việc liên quan đến AI.

🐞 Sửa Lỗi và Các Cải Thiện Nhỏ Hơn

Chúng tôi cũng đã phát hành một số bản sửa lỗi và cập nhật tiện ích trong tháng này:

• Đã khắc phục sự cố khi tính năng hợp nhất thông minh OpenAPI không giữ lại các ví dụ phản hồi điểm cuối.
• Đã khắc phục sự cố khi hợp nhất từ một nhánh con vào một nhánh chính được bảo vệ có thể bao gồm các điểm cuối không được chọn.
• Đã khắc phục hiển thị thả xuống không chính xác khi tạo các phiên bản điểm cuối từ các nhánh.
• Đã khắc phục sự cố khi TestData và TestCases không hoạt động khi chạy thử nghiệm thông qua CLI.
• Đã khắc phục sự cố khi xuất OpenAPI bao gồm các thành phần phản hồi từ các mô-đun không liên quan.
• Đã khắc phục định dạng xuất Markdown cho JSON có nhận xét.
• Đã khắc phục lỗi xuất Word do crypto is not defined.
• Đã khắc phục sự cố khi nhập Knife4j với Basic Auth được bật không hiển thị các trường tên người dùng và mật khẩu.
• Đã khắc phục lỗi lọc điểm cuối khi các thẻ là số.
• Đã khắc phục sự cố khi apidog endpoint list --branch không trả về dữ liệu cho nhánh được chỉ định.
• Đã khắc phục một số vấn đề về tham số, lọc và thông báo lỗi của công cụ MCP.
• Đã khắc phục sự cố khi mã được tạo thiếu tùy chọn cấu hình typescriptThreePlus.

🌟 Ý Nghĩa Của Việc Này

Tháng 4 là một bản phát hành thiết thực dành cho các nhóm xây dựng sản phẩm AI Agent.

AI Agent Debugger giúp bạn kiểm tra một lần chạy của một agent. A2A Debugger giúp bạn kiểm tra giao tiếp giữa các agent. Nhập Postman API giúp việc di chuyển bớt khó khăn hơn. Thanh bên Ask AI giúp tài liệu đã xuất bản dễ sử dụng hơn. Các nhà cung cấp mô hình tùy chỉnh mang lại cho các nhóm nhiều quyền kiểm soát hơn đối với thiết lập AI của họ.

Tất cả những điều này đều không hào nhoáng chỉ vì muốn hào nhoáng. Đó là loại công cụ mà bạn bắt đầu muốn có khi quá trình phát triển agent chuyển từ các bản demo sang các dự án thực tế.

💬 Tham Gia Cuộc Trò Chuyện

Kết nối với các kỹ sư API khác và nhóm Apidog:

• Tham gia cộng đồng Discord của chúng tôi để thảo luận và hỗ trợ theo thời gian thực.
• Tham gia cộng đồng Slack của chúng tôi để trao đổi kỹ thuật.
• Theo dõi chúng tôi trên X (Twitter) để nhận các cập nhật mới nhất.

Tái bút: Để biết đầy đủ chi tiết về tất cả các cập nhật, hãy xem Apidog Changelog!

Trân trọng,
Đội ngũ Apidog