Chrome DevTools cho tác nhân cho phép tác nhân của bạn bắt đầu một phiên trình duyệt và cài đặt hoặc tương tác với các tiện ích Chrome bằng máy chủ MCP. Điều này cho phép tác nhân lập trình của bạn kiểm soát vòng đời của tiện ích: cài đặt, tải lại và kích hoạt các thao tác.
Thay vì tải một tiện ích đã giải nén theo cách thủ công, nhấp vào nút tải lại trong trang quản lý tiện ích mỗi khi bạn thay đổi mã và kích hoạt tiện ích theo cách thủ công để kiểm thử, hãy hướng dẫn tác nhân AI của bạn tự quản lý toàn bộ quy trình. Điều này giúp thu hẹp khoảng cách giữa quá trình tạo mã tĩnh và kiểm thử tiện ích trực tiếp.
Bạn có thể sử dụng các công cụ tiện ích để làm những việc sau:
- Cài đặt tiện ích: Cài đặt một tiện ích Chrome chưa đóng gói từ đường dẫn thư mục cục bộ.
- Liệt kê các tiện ích: Truy xuất danh sách tất cả các tiện ích Chrome đã cài đặt, bao gồm cả tên, mã nhận dạng, phiên bản và trạng thái đã bật của các tiện ích đó.
- Tải lại tiện ích: Tải lại một tiện ích Chrome chưa được đóng gói theo mã nhận dạng để áp dụng ngay các thay đổi về mã.
- Hành động kích hoạt: Kích hoạt hành động mặc định của một tiện ích theo mã nhận dạng của tiện ích đó, chẳng hạn như mở một trình đơn hoặc thực thi một hành động của tập lệnh nền (xem chrome.action trong tài liệu API).
- Gỡ cài đặt tiện ích: Xoá một tiện ích Chrome khỏi phiên trình duyệt theo mã nhận dạng của tiện ích đó.
Điều kiện tiên quyết
Trước khi sử dụng các công cụ tiện ích, hãy đảm bảo bạn có những thông tin sau:
- Cờ thử nghiệm: Danh mục Tiện ích không hoạt động theo mặc định trong Công cụ cho nhà phát triển cho các tác nhân. Bạn phải định cấu hình máy chủ MCP bằng cờ
--categoryExtensions. - Tiện ích chưa đóng gói: Các công cụ như
install_extensionyêu cầu một đường dẫn tuyệt đối đến thư mục tiện ích chưa đóng gói, khiến chúng trở thành lựa chọn lý tưởng cho quá trình phát triển cục bộ.
Trường hợp sử dụng các công cụ tiện ích của Chrome
Hướng dẫn tác nhân quản lý vòng đời tiện ích của bạn trong khi phát triển và sửa lỗi.
Lưu ý: Các bước thực thi của tác nhân là ví dụ về hành vi tiềm ẩn. Tác nhân của bạn có thể hoạt động theo cách khác.
Nhanh chóng lặp lại và tải lại một tiện ích
Việc tải lại tiện ích theo cách thủ công sau mỗi lần thay đổi tệp sẽ làm chậm quá trình phát triển. Hướng dẫn tác nhân của bạn áp dụng bản sửa lỗi mã và tải lại tiện ích ngay lập tức để xác minh hành vi mới mà không cần can thiệp thủ công.
Câu lệnh mẫu:
Bạn có thể sử dụng phương pháp chung:
Verify the extension has access to the active tab.
Hoặc bạn có thể mô tả chi tiết hơn:
Update the manifest.json to include the "activeTab" permission. Then, reload the extension with ID 'abc123xyz' and trigger its default action to ensure it works.
Ví dụ về quá trình thực thi tác nhân: Tác nhân của bạn chỉnh sửa tệp manifest.json trên hệ thống tệp. Sau đó, công cụ này sẽ gọi công cụ reload_extension bằng mã nhận dạng được cung cấp.
Cuối cùng, nó sẽ gọi công cụ trigger_extension_action để kích hoạt tiện ích và xác minh rằng không có lỗi nào về quyền xuất hiện trong bảng điều khiển.
Thử nghiệm hành động mặc định của tiện ích trên một trang đích
Bạn thường cần kiểm thử cách một tập lệnh nội dung hoặc thao tác của tiện ích tương tác với một trang web cụ thể. Tự động hoá quy trình này bằng cách hướng dẫn tác nhân của bạn chuyển đến trang web, cài đặt tiện ích và kích hoạt tiện ích đó.
Câu lệnh mẫu:
Bạn có thể sử dụng phương pháp chung:
Test my extension on example.com and verify it works correctly.
Hoặc bạn có thể mô tả chi tiết hơn:
Navigate to example.com, install the unpacked extension located at '/Users/dev/my-extension', and trigger the extension action. Check the console logs to verify the content script executed correctly.
Ví dụ về việc thực thi tác nhân: Tác nhân của bạn chuyển đến URL mục tiêu bằng cách sử dụng navigate_page. Sau đó, nó sẽ dùng install_extension với đường dẫn tuyệt đối được cung cấp. Sau khi tiện ích được tải, tiện ích sẽ thực thi trigger_extension_action để mô phỏng lượt nhấp của người dùng. Cuối cùng, nó sử dụng list_console_messages để xác nhận rằng tập lệnh nội dung đã chạy và tạo ra kết quả đầu ra như mong đợi.
Xác minh các tiện ích đã cài đặt và dọn dẹp
Trong quá trình kiểm thử tự động, bạn có thể cần xác minh xem một tiện ích có được tải đúng cách với phiên bản phù hợp hay không, hoặc xoá tiện ích đó để đảm bảo trạng thái sạch cho lần kiểm thử tiếp theo.
Câu lệnh mẫu:
Uninstall 'My Test Extension' from the browser.
Ví dụ về việc thực thi tác nhân: Tác nhân của bạn sử dụng công cụ list_extensions để truy xuất danh sách các tiện ích đã cài đặt và siêu dữ liệu của chúng. Thao tác này sẽ phân tích cú pháp đầu ra để xác định mã nhận dạng được liên kết với "Tiện ích kiểm thử của tôi". Sau đó, công cụ này sẽ dùng công cụ uninstall_extension với mã nhận dạng đó để xoá mã nhận dạng một cách an toàn khỏi trình duyệt.
Tạo một tiện ích mới và kiểm thử tiện ích đó
Việc bắt đầu một tiện ích Chrome mới từ đầu thường đòi hỏi bạn phải tạo các tệp mẫu và tải thư mục đã giải nén vào trình duyệt theo cách thủ công để kiểm thử. Bỏ qua bước thiết lập thủ công này bằng cách hướng dẫn tác nhân tạo mã ban đầu, tải tiện ích và xác minh chức năng cơ bản của tiện ích từ đầu đến cuối chỉ trong một bước.
Câu lệnh mẫu:
Build a Chrome extension that turns the page background gray when I click its icon. Save the files to '/tmp/gray-bg-ext', navigate to example.com, load the extension, and verify that it works.
Ví dụ về việc thực thi tác nhân: Tác nhân của bạn tạo một manifest.json Manifest V3 cơ bản và một trình chạy dịch vụ nền để theo dõi sự kiện chrome.action.onClicked. Sau đó, thao tác này chuyển đến trang kiểm thử, gọi install_extension và dùng trigger_extension_action để mô phỏng một lượt nhấp của người dùng. Cuối cùng, nó sẽ kiểm tra DOM hoặc chụp ảnh màn hình để xác nhận rằng nền đã chuyển sang màu xám, chứng minh rằng phần mã mặc định hoạt động.