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à thử nghiệm 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 khả năng hiển thị đầy đủ từ đầu đến cuối vòng đời của công cụ, bao gồm cả quá trình đăng ký, xác thực giản đồ và nhật ký lệnh gọi.

Mở ngăn WebMCP

Ngăn WebMCP nằm trong bảng điều khiển Ứng dụng. Để mở ngăn này, 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 trong DevTools 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ụ:

  • Invoked Tools (Các công cụ được gọi): Nhật ký theo trình tự thời gian về các lượt tương tác giữa tác nhân AI và trang.
  • Available Tools (Các công cụ có sẵn): Danh sách trực tiếp về 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 Available tools (Các công cụ có sẵn) hiển thị tên và nội dung mô tả của công cụ như chúng xuất hiện với tác nhân AI. Phần này cũng bao gồm bộ đếm lệnh gọi cho từng 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ác công cụ có sẵn cho thấy bộ đếm lời gọi có các biểu tượng trạng thái có thể nhấp để lọc.

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

Nhật ký Các công cụ được gọi cung cấp bản ghi liên tục về các lượt 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 các thông tin chi tiết sau:

  • Status (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).
  • Input (Dữ liệu đầu vào): Các tham số chính xác mà tác nhân đã dự đoán và gửi đến công cụ.
  • Output (Dữ liệu đầ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 Filter (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:

  • Name or description (Tên hoặc nội dung mô tả): Nhập văn bản để tìm các công cụ khớp với một tên hoặc mục đích cụ thể.
  • Status type (Loại trạng thái): Lọc các lệnh gọi theo trạng thái hiện tại, chẳng hạn như Completed (Đã hoàn tất), Error (Lỗi), Cancelled (Đã huỷ) hoặc In Progress (Đang tiến hành).
  • Tool type (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 không có bộ lọc nào đang hoạt động.

Thử nghiệm 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 để tự kiểm tra độ tin cậy của công cụ. Điều này hữu ích khi xác minh logic hàm mà không cần chờ 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 thử nghiệm. Ngoài ra, trong nhật ký Invoked Tools (Các công cụ được gọi), hãy di chuột qua một công cụ để hiển thị biểu tượng Play (Phát) (➜) rồi nhấp vào biểu tượng đó. Khu vực thử nghiệm thủ công sẽ mở ra.

  2. Trong khu vực thử nghiệm thủ công, hãy nhập hoặc điều chỉnh các tham số trong các trường nhập.

  3. Nhấp vào Run tool (Chạy công cụ).

Di chuột qua một mục trong danh sách Các công cụ được gọi để hiển thị biểu tượng Phát và mở khu vực thử nghiệm thủ công được điền sẵn.

Khắc phục sự cố về tính năng 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:

  • Schema violations (Vi phạm giản đồ): Ngăn đầu ra hiển thị thông báo lỗi nếu các tham số của công cụ hoặc giá trị trả về không khớp với giản đồ đã xác định.
  • Agent rejection (Tác nhân từ chối): Kiểm tra bộ đếm lời gọi trong danh sách Available Tools (Các 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ụ của trang web. Đối với quá trình 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 thử nghiệm và sử dụng các công cụ WebMCP của bạn.

Cờ hiệu dòng lệnh

Để tương tác với một số giao diện dựa trên tác nhân, bạn phải 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: