Gỡ lỗi các công cụ WebMCP

Sử dụng bảng điều khiển WebMCP trong Chrome DevTools để kiểm tra, gỡ lỗi và kiểm thử các công cụ AI phía máy khách mà trang web của bạn cung cấp cho các tác nhân AI. Bảng điều khiển này cung cấp thông tin đầy đủ về toàn bộ vòng đời của công cụ, bao gồm cả đăng ký, xác thực giản đồ và lịch sử lệnh gọi.

Mở ngăn WebMCP

Ngăn WebMCP nằm trong bảng điều khiển Application (Ứng dụng). Để mở, hãy làm theo các bước sau:

  1. Mở Chrome DevTools trên một trang sử dụng các công cụ WebMCP.
  2. Nhấp vào thẻ Ứng dụng.
  3. Ở cấp cao nhất của thanh bên, hãy chọn ngăn WebMCP.
Bảng điều khiển Ứng dụng của Công cụ cho nhà phát triển, trong đó ngăn WebMCP được chọn trong thanh bên Ứng dụng.
Bảng điều khiển Ứng dụng của Công cụ cho nhà phát triển có ngăn WebMCP được chọn trong thanh bên Ứng dụng.

Tổng quan về giao diện

Bảng điều khiển WebMCP sử dụng bố cục hai ngăn để giúp bạn quản lý và giám sát các công cụ của mình:

  • Công cụ được gọi: Nhật ký tương tác theo trình tự thời gian giữa tác nhân AI và trang.
  • Các công cụ có sẵn: Danh sách trực tiếp của tất cả các công cụ WebMCP được phát hiện trên thẻ đang hoạt động.

Các công cụ có sẵn

Phần Các công cụ có sẵn hiển thị tên và nội dung mô tả của công cụ khi chúng xuất hiện với tác nhân AI. Thẻ này cũng bao gồm một bộ đếm lệnh gọi cho mỗi công cụ, cho biết số lần một công cụ được gọi trong phiên hiện tại.

Danh sách Công cụ có sẵn cho thấy bộ đếm lệnh gọi với các biểu tượng trạng thái có thể nhấp để lọc.
Danh sách Công cụ có sẵn cho thấy bộ đếm lời gọi với các biểu tượng trạng thái có thể nhấp vào để lọc.

Công cụ được gọi

Nhật ký Invoked tools (Công cụ được gọi) cung cấp bản ghi liên tục về các hoạt động tương tác với công cụ. Khi chọn một mục trong nhật ký, bạn có thể kiểm tra những thông tin chi tiết sau:

  • Trạng thái: Kết quả của lời gọi (Đã hoàn tất, Đã huỷ, Đang tiến hành hoặc Lỗi).
  • Đầu vào: Các tham số chính xác mà trợ lý dự đoán và gửi đến công cụ.
  • Đầu ra: Giá trị trả về hoặc thông báo lỗi do công cụ cung cấp.

Lọc nhật ký

Sử dụng thanh Bộ lọc để thu hẹp danh sách các công cụ được gọi dựa trên các tiêu chí sau:

  • Tên hoặc nội dung mô tả: Nhập văn bản để tìm các công cụ có tên hoặc mục đích cụ thể.
  • Loại trạng thái: Lọc các cuộc gọi theo trạng thái hiện tại, chẳng hạn như Đã hoàn tất, Lỗi, Đã huỷ hoặc Đang tiến hành.
  • Loại công cụ: Chọn để lọc các công cụ Khai báo được xác định trong HTML và các công cụ Bắt buộc được xác định trong JavaScript. Để xem tất cả các loại công cụ, hãy đảm bảo rằng không có bộ lọc nào đang hoạt động.

Kiểm thử công cụ theo cách thủ công

Bạn có thể bỏ qua logic quyết định của tác nhân AI để kiểm thử độ tin cậy của công cụ một cách độc lập. Điều này hữu ích cho việc xác minh logic hàm mà không cần chờ một lời nhắc cụ thể của tác nhân.

  1. Trong danh sách Available Tools (Các công cụ có sẵn), hãy nhấp vào công cụ bạn muốn kiểm thử. Ngoài ra, trong nhật ký Invoked Tools (Công cụ được gọi), hãy di chuột lên một công cụ để biểu tượng Phát (➜) xuất hiện rồi nhấp vào biểu tượng đó. Khu vực kiểm thử thủ công sẽ mở ra. Lưu ý: Nếu bạn chọn công cụ trong danh sách Công cụ có sẵn, thì các tham số trong khu vực kiểm thử thủ công sẽ trống. Nếu không, nếu bạn chọn một công cụ được gọi, thì khu vực kiểm thử thủ công sẽ mở ra với các tham số từ phiên đó đã được điền sẵn.
  2. Trong khu vực kiểm thử thủ công, hãy nhập hoặc điều chỉnh các thông số trong các trường nhập.
  3. Nhấp vào Chạy công cụ.
Di chuột lên một mục trong danh sách Invoked Tools (Công cụ được gọi) để hiển thị biểu tượng Play và mở khu vực kiểm thử thủ công được điền sẵn.
Di chuột lên một mục trong danh sách Công cụ được gọi để hiển thị biểu tượng Phát và mở khu vực kiểm thử thủ công được điền sẵn.

Khắc phục sự cố về việc tích hợp

Bảng điều khiển WebMCP giúp bạn chẩn đoán các lỗi tích hợp thường gặp:

  • Lỗi vi phạm giản đồ: Ngăn đầu ra sẽ hiển thị thông báo lỗi nếu các tham số hoặc giá trị trả về của công cụ không khớp với giản đồ đã xác định.
  • Tác nhân từ chối: Kiểm tra bộ đếm lời gọi trong danh sách Công cụ có sẵn để xem tác nhân có từng cân nhắc công cụ của bạn cho một câu lệnh nhất định hay không.

Tự động hoá và tác nhân

WebMCP được thiết kế cho web dựa trên tác nhân, nơi các tác nhân AI có thể khám phá và tương tác với các công cụ trên trang web của bạn. Đối với hoạt động phát triển có sự hỗ trợ của tác nhân, dự án Chrome DevTools cho tác nhân cung cấp một giao diện chuyên biệt sử dụng giao thức này để giúp các tác nhân AI kiểm thử và sử dụng các công cụ WebMCP của bạn.

Cờ hiệu dòng lệnh

Một số giao diện dựa trên tác nhân yêu cầu bạn bật cờ --categoryWebMCP một cách rõ ràng.

Tài nguyên có liên quan

Để tìm hiểu thêm về WebMCP và web dựa trên tác nhân, hãy xem các tài nguyên sau: