Trình gỡ lỗi AI Agent của Apidog có sẵn trong phiên bản client Apidog mới nhất trên tất cả các gói, bao gồm cả gói Miễn phí. Trình gỡ lỗi cho phép bạn chạy các AI agent với các mô hình OpenAI và Anthropic, kết nối các máy chủ MCP, kiểm tra mọi lệnh gọi mô hình và lời gọi công cụ trong bảng Traces, và theo dõi chi phí mỗi lần chạy.
Bài viết này đề cập đến ai có thể sử dụng Trình gỡ lỗi AI Agent, những gì nó hỗ trợ, những gì nó không hỗ trợ, cách bật nó và những gì không thay đổi đối với các dự án Apidog hiện có của bạn.
Những gì có sẵn
Trình gỡ lỗi AI Agent được tích hợp trong client Apidog tiêu chuẩn. Không có giấy phép riêng, không có gói bổ trợ và không có phí cho mỗi người dùng.
- Tất cả các gói Miễn phí, Cơ bản, Chuyên nghiệp và Doanh nghiệp đều bao gồm Trình gỡ lỗi AI Agent.
- Tính năng này được bật theo mặc định; không cần bật/tắt.
- Bạn phải sử dụng phiên bản client Apidog mới nhất. Các client cũ hơn không có tab Trình gỡ lỗi AI Agent.
Các nhà cung cấp mô hình được hỗ trợ
| Nhà cung cấp | Trạng thái | Mô hình |
|---|---|---|
| OpenAI | Được hỗ trợ | GPT-5.5, GPT-5.5 Instant, o-series và bất kỳ mô hình nào trong tài khoản OpenAI |
| Anthropic | Được hỗ trợ | Claude 4.7 Sonnet, Claude 4.7 Opus, Claude 4.7 Haiku |
| Điểm cuối tương thích với OpenAI tùy chỉnh | Được hỗ trợ qua ghi đè URL cơ sở | Bất kỳ nhà cung cấp nào phơi bày API tương thích với OpenAI |
| Các nhà cung cấp khác (Google, Mistral, xAI) | Trong lộ trình | Hiện chưa được ưu tiên hàng đầu |
Các phương thức kết nối máy chủ MCP
Trình gỡ lỗi giao tiếp với Giao thức Ngữ cảnh Mô hình (Model Context Protocol) một cách nguyên bản. Ba phương thức truyền tải được hỗ trợ:
- STDIO. Quy trình con cục bộ. Tốt nhất cho các máy chủ MCP đang trong quá trình phát triển tích cực.
- HTTP Streamable. Các máy chủ MCP được lưu trữ có thể truy cập qua HTTP.
- SSE. Server-Sent Events cũ. Vẫn phổ biến; được hỗ trợ để tương thích ngược.
Xác thực cho các máy chủ MCP bao gồm hai mẫu: tiêu đề chuẩn (khóa API) và OAuth 2.0 (trao đổi mã thông báo đầy đủ).
Những gì trình gỡ lỗi bao gồm
Trình gỡ lỗi ghi lại toàn bộ chuỗi thực thi của một lần chạy tác nhân:
- Các lệnh gọi mô hình với toàn bộ tải trọng yêu cầu và phản hồi.
- Các dấu vết suy nghĩ của mô hình, khi mô hình phơi bày chúng (OpenAI o-series, Anthropic extended thinking).
- Lời gọi công cụ với giá trị tham số và dữ liệu trả về.
- Lưu lượng máy chủ MCP, được liệt kê trong bảng Traces giống như bất kỳ lệnh gọi công cụ nào khác.
- Các công cụ tích hợp:
bash,web_fetch,read,edit,write,grep,glob,kill_shell. - Các số liệu hiệu suất mỗi lần chạy: thời gian phản hồi, token đầu vào, token đầu ra, chi phí ước tính.
- Kỹ năng: các gói được lưu của lời nhắc hệ thống + danh sách công cụ + tham số để chạy lại một kịch bản.
Những gì trình gỡ lỗi không bao gồm
- Khả năng quan sát trong môi trường sản xuất. Sử dụng công cụ quan sát chuyên dụng để ghi nhật ký lưu lượng truy cập dài hạn.
- Kiểm thử hồi quy tự động. Đối với các lưới lời nhắc so với các fixtures, hãy sử dụng một công cụ như Promptfoo.
- Lưu lượng giao thức Agent-to-Agent (A2A). Đối với A2A, hãy sử dụng Trình gỡ lỗi A2A riêng của Apidog.
- Xác thực máy chủ MCP một cách độc lập. Để kiểm tra các công cụ và tài nguyên của một máy chủ MCP mà không có vòng lặp tác nhân, hãy sử dụng quy trình kiểm thử máy chủ MCP của Apidog.
Cách bật
- Cập nhật Apidog lên phiên bản mới nhất.
- Mở Apidog và nhấp vào AI Agent Debugger trên thanh tab trên cùng.
- Chọn nhà cung cấp mô hình và mô hình.
- Xác nhận URL cơ sở (tự động điền từ nhà cung cấp) hoặc ghi đè nó cho một điểm cuối tùy chỉnh.
- Dán khóa API của bạn.
- Nhấp vào Run trên một luồng trống để xác nhận kết nối.
Không cần cấu hình cấp dự án. Trình gỡ lỗi chạy trong không gian làm việc riêng của nó.
Những gì không thay đổi
- Các dự án Apidog hiện có, định nghĩa API và bộ kiểm thử không bị ảnh hưởng.
- Quy trình kiểm thử máy chủ MCP và Trình gỡ lỗi A2A tiếp tục hoạt động song song.
- Gỡ lỗi điểm cuối API, máy chủ giả lập và chỉnh sửa OpenAPI không thay đổi.
- Thanh toán và các cấp gói không thay đổi; Trình gỡ lỗi AI Agent không tiêu thụ bất kỳ tín dụng mới nào.
Bạn thanh toán cho các lệnh gọi API mô hình cơ bản theo hóa đơn tài khoản OpenAI hoặc Anthropic của bạn. Apidog không tính thêm phí sử dụng.
Dành cho quản trị viên nhóm và doanh nghiệp
- Trình gỡ lỗi AI Agent được bật cho mỗi người dùng. Mỗi thành viên sử dụng khóa API nhà cung cấp riêng của họ.
- Khóa API được nhập vào trình gỡ lỗi được lưu trữ cục bộ trên client của mỗi người dùng. Chúng không được truyền đến máy chủ Apidog.
- Chủ sở hữu không gian làm việc có thể quản lý tập trung các điểm cuối máy chủ MCP được chia sẻ thông qua các biến môi trường Apidog tiêu chuẩn.
- Kiểm toán và kiểm soát truy cập cho các máy chủ MCP tuân theo mô hình xác thực riêng của máy chủ MCP (tiêu đề hoặc OAuth 2.0).
Các hạn chế đã biết
- Việc mở rộng nhà cung cấp ngoài OpenAI và Anthropic đang nằm trong lộ trình; trong thời gian chờ đợi, hãy sử dụng tùy chọn ghi đè URL cơ sở cho các nhà cung cấp tương thích với OpenAI.
- Chia sẻ dấu vết chỉ ở cục bộ. Để chia sẻ dấu vết, hãy sao chép JSON của chế độ xem Raw hoặc chụp ảnh màn hình bảng điều khiển.
- Ước tính chi phí là một xấp xỉ cục bộ dựa trên giá mô hình đã công bố; hãy tham khảo bảng điều khiển sử dụng của nhà cung cấp để biết thông tin thanh toán.