A2A (Agent2Agent) là một giao thức mở dành cho giao tiếp giữa các Agent. Thông qua A2A, các Agent khác nhau có thể khám phá năng lực của nhau, gửi tin nhắn và trả về kết quả thực thi.A2A Debugger là một công cụ trực quan để debug các A2A Agent. Bạn có thể kết nối với một A2A Agent, gửi tin nhắn kiểm thử, xem nội dung do Agent trả về, trạng thái thực thi và nhật ký debug, giúp nhà phát triển nhanh chóng xử lý sự cố liên quan đến tích hợp Agent, truyền gửi tin nhắn và kết quả trả về.A2A Debugger phù hợp với các tình huống sau:Kiểm tra xem một A2A Agent có thể kết nối bình thường hay không
Xem tên, mô tả, năng lực và Skills của Agent
Gửi văn bản hoặc tệp đính kèm đến Agent để xác minh phản hồi của Agent
Xử lý các sự cố kết nối hoặc yêu cầu như xác thực, Header, loại tệp, v.v.
Xem chi tiết yêu cầu và phản hồi để xác định nguyên nhân khiến nội dung trả về bất thường
Chúng tôi khuyến nghị sử dụng client Apidog mới nhất để trải nghiệm đầy đủ các tính năng của AI Agent Debugger.
Kết nối với một A2A Agent#
Nhập Agent Card URL ở đầu trang, sau đó nhấp vào Connect.Sau khi kết nối thành công, trạng thái ở phía trên sẽ hiển thị là Connected. Lúc này, bạn có thể xem thông tin Agent và bắt đầu gửi tin nhắn.Nếu cần chuyển sang Agent khác, bạn có thể nhấp vào Disconnect, sau đó nhập lại Agent Card URL.Viết tin nhắn kiểm thử#
Viết dữ liệu đầu vào kiểm thử để gửi đến Agent trong tab Messages.Khu vực chỉnh sửa tin nhắn được chia thành hai phần bên trái và bên phải:Bên trái: Nhập văn bản tin nhắn, tải lên tệp đính kèm, cấu hình Metadata
Bên phải: Xem nội dung yêu cầu thô tương ứng
Gửi tin nhắn#
Sau khi hoàn tất cấu hình tin nhắn, nhấp vào Send.Nếu hiện chưa có Agent nào được kết nối, A2A Debugger sẽ trước tiên cố gắng kết nối; công cụ sẽ gửi tin nhắn sau khi kết nối thành công.Sau khi gửi, bạn có thể thấy tin nhắn của người dùng và nội dung do Agent trả về trong khu vực tin nhắn.Xem tin nhắn phản hồi#
Khu vực tin nhắn hiển thị tin nhắn của người dùng và phản hồi của Agent trong phiên hiện tại.Nội dung do Agent trả về có thể là văn bản thuần túy, hoặc có thể bao gồm trạng thái tác vụ, kết quả thực thi hoặc artifact được tạo ra. Bạn có thể nhanh chóng xác định liệu Agent đã hiểu và xử lý yêu cầu đúng hay chưa thông qua khu vực hiển thị tin nhắn.Nhấp vào bất kỳ tin nhắn debug nào để xem chi tiết ở bên phải. Bảng chi tiết hỗ trợ ba chế độ xem:Preview: Hiển thị nội dung chính theo cách dễ đọc hơn
Content: Xem văn bản hoặc dữ liệu cốt lõi trong tin nhắn
Raw Data: Xem JSON thô hoàn chỉnh
What is the distance between the Earth and the Moon?
Xem Agent Card#
Tab Agent Card trong bảng debug được dùng để xem mô tả năng lực của Agent hiện đang được kết nối.Địa chỉ Agent, phiên bản giao thức, số phiên bản
Các năng lực được Agent hỗ trợ, chẳng hạn như có hỗ trợ phản hồi streaming, thông báo đẩy, lịch sử trạng thái, v.v. hay không
Loại đầu vào và loại đầu ra mặc định
Thêm tệp đính kèm#
Nếu Agent hiện tại hỗ trợ đầu vào dạng tệp, bạn có thể nhấp vào nút tệp đính kèm bên dưới khu vực nhập tin nhắn để tải tệp lên.A2A Debugger xác định việc có cho phép tải tệp đính kèm lên hay không dựa trên các loại đầu vào do Agent khai báo:Nếu Agent chỉ hỗ trợ đầu vào văn bản, nút tệp đính kèm sẽ không khả dụng
Nếu Agent chỉ hỗ trợ các loại tệp cụ thể, bạn chỉ có thể tải lên các tệp thuộc loại phù hợp
Nếu Agent hỗ trợ bất kỳ loại tệp nào, bạn có thể tải lên bất kỳ tệp nào
Cấu hình xác thực#
Nếu A2A Agent yêu cầu xác thực, bạn có thể cấu hình phương thức xác thực trong tab Authentication.Các loại xác thực sau được hỗ trợ:| Phương thức xác thực | Mô tả |
|---|
| None | Không thêm thông tin xác thực |
| Bearer Token | Xác thực bằng token |
| Basic Auth | Xác thực bằng tên người dùng và mật khẩu |
| API Key | Truyền API Key thông qua một Header được chỉ định |
Nếu lỗi không được ủy quyền được trả về khi gửi tin nh ắn, vui lòng kiểm tra xem phương thức xác thực, token, tên người dùng/mật khẩu hoặc API Key có chính xác hay không.Trong tab Header, bạn có thể thêm các Header yêu cầu tùy chỉnh.Header tùy chỉnh thường được dùng trong các tình huống sau:Truyền các tham số nghiệp vụ như tenant ID, định danh môi trường, v.v.
Xác thực thông qua gateway, proxy hoặc dịch vụ nội bộ
Debug các dịch vụ Agent yêu cầu header yêu cầu đặc biệt
Câu hỏi thường gặp#
Tôi nên làm gì nếu kết nối thất bại?#
Vui lòng kiểm tra các mục sau:1.
Agent Card URL có chính xác và có thể truy cập từ môi trường hiện tại hay không.
2.
Dịch vụ Agent có đang chạy hay không.
3.
Nếu cần xác thực, thông tin xác thực chính xác đã được cấu hình trong tab Authentication hay chưa.
4.
Có cần thêm Header bổ sung hay không, chẳng hạn như tenant ID, định danh môi trường hoặc thông tin xác thực gateway.
5.
Nội dung do Agent Card trả về có phải là JSON hợp lệ hay không.
Không thể tải lên tệp đính kèm sau khi kết nối thành công?#
Điều này thường là do Agent hiện tại chưa khai báo hỗ trợ đầu vào dạng tệp, hoặc chỉ cho phép tải lên các loại tệp cụ thể.Vui lòng xem các loại đầu vào được Agent hỗ trợ trong tab Agent Card, và xác nhận xem loại tệp được tải lên có khớp hay không.Làm cách nào để xem yêu cầu và phản hồi hoàn chỉnh?#
Nhấp vào nhật ký yêu cầu hoặc phản hồi tương ứng trong tab Messages của bảng debug, sau đó chuyển sang chế độ xem Raw Data để xem JSON hoàn chỉnh.Tôi nên làm gì nếu nội dung do Agent trả về hiển thị bất thường?#
Bạn có thể xử lý sự cố theo thứ tự sau:1.
Kiểm tra nội dung xem trước trong tin nhắn debug để xác nhận liệu Agent đã trả về kết quả hay chưa.
2.
Chuyển sang chế độ xem Raw Data để xem phản hồi hoàn chỉnh.
3.
Kiểm tra xem các loại đầu vào, loại đầu ra và Skills được khai báo trong Agent Card có đáp ứng kỳ vọng hay không.
4.
Kiểm tra các lời nhắc lỗi xác thực trong tin nhắn hoặc chi tiết debug.
