Kỹ năng phát hành của bộ Google agents-cli (SKILL.md do Google ký): Đăng ký các tác nhân đã triển khai vào ứng dụng Gemini (trước đây là Gemini Enterprise) và quản lý các tác nhân cũng như máy chủ MCP trong Agent Registry bằng gcloud.
Số lượt cài đặt trên skills.sh 516262 (+2918 / 24h)
Kiểm toán bảo mật: Có cảnh báo rủi ro
- Cài đặt hoặc chạy các gói của bên thứ ba (npx / pip, v.v.), thuộc loại thực thi lệnh
- Cho phép tác nhân thực thi lệnh shell / script
- Thực hiện các yêu cầu mạng hoặc gọi API bên ngoài / MCP từ xa
- Tham chiếu đến các script chưa được quét: tools/list
- Phạm vi kiểm toán: GitHub google/agents-cli/skills/google-agents-cli-publish/SKILL.md (chỉ quét văn bản SKILL.md)
Lý do
- Làm rõ hai phương thức đăng ký: Các tác nhân ADK được triển khai trên Agent Runtime mặc định sử dụng gọi gốc ADK (:streamQuery), còn các tác nhân trên Cloud Run / GKE và các tác nhân từ các framework khác chỉ có thể sử dụng A2A, chỉ cần truyền URL thẻ tác nhân
- Khi có deployment_metadata.json, tự động đọc ID Agent Runtime và phương thức đăng ký, tối giản chỉ cần cung cấp --gemini-app-id; mặc định không tương tác, có thể đưa trực tiếp vào CI, việc phát hành lại sẽ cập nhật tại chỗ
- Kèm theo các lệnh gcloud cho Agent Registry và bảng xử lý sự cố (quyền 403, lỗi Session not found của phiên bản google-cloud-aiplatform cũ, v.v.)
- Bộ agents-cli còn có 6 kỹ năng khác đang xếp hạng; skills.sh có 2918 lượt cài đặt trong 24 giờ, tổng cộng 516262, số lượt cài đặt hàng tuần trong những tuần gần đây giảm từ 132534 xuống 11115 (chỉ phản ánh mức độ quan tâm)
Cách sử dụng
- npx skills add https://github.com/google/agents-cli --skill google-agents-cli-publish; CLI được cài đặt bằng uv tool install google-agents-cli
- Điều kiện tiên quyết là tác nhân đã được triển khai và có thể truy cập, ứng dụng Gemini đã được tạo trong bảng điều khiển Google Cloud; việc triển khai được xử lý bởi google-agents-cli-deploy
- Cần có dự án và tài khoản Google Cloud, tài khoản đăng ký phải có quyền Discovery Engine Editor; nếu sử dụng A2A trên Cloud Run, còn phải cấp quyền roles/run.servicesInvoker cho tài khoản dịch vụ Discovery Engine
Rủi ro
- Các cảnh báo về cài đặt, shell và yêu cầu mạng từ kiểm toán phù hợp với mục đích sử dụng; “script chưa được quét tools/list” thực chất là tên phương thức của giao thức MCP, không phải là script
- Các lệnh sẽ thay đổi tài nguyên thực tế trên Google Cloud (đăng ký, cập nhật, xóa), chi phí được ghi vào dự án được chỉ định bởi --project-id
- Chỉ hỗ trợ tác nhân văn bản, không thể phát hành tác nhân giọng nói / Live vào ứng dụng Gemini