Kỹ năng triển khai trong bộ công cụ Google agents-cli (SKILL.md do Google ký tên): Hướng dẫn các agent sử dụng agents-cli để triển khai các tác nhân được viết bằng các framework như ADK lên Agent Runtime, Cloud Run hoặc GKE, đồng thời cấu hình các khóa bí mật, tài khoản dịch vụ, pipeline CI/CD, quy trình rollback và khắc phục sự cố.
Số lượt cài đặt trên skills.sh 525087 (+4817 / 24h)
Kiểm toán bảo mật: Có cảnh báo rủi ro
- Sẽ 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 agent thực hiện các lệnh shell / script
- Sẽ khởi tạo các yêu cầu mạng hoặc gọi API bên ngoài / MCP từ xa
- Sẽ báo cáo dữ liệu sử dụng (telemetry)
- Đọc biến môi trường hoặc yêu cầu API Key / Token
- Phạm vi kiểm toán: GitHub google/agents-cli/skills/google-agents-cli-deploy/SKILL.md (chỉ quét văn bản SKILL.md)
Lý do
- Trước tiên cung cấp bảng so sánh ba mục tiêu triển khai (khả năng mở rộng, mạng, trạng thái phiên, phương thức tính phí, độ khó khi bắt đầu), yêu cầu agent hỏi người dùng chọn loại nào; đối với các tác nhân cần ủy quyền người dùng qua OAuth, nên dùng Agent Runtime, còn đối với giọng nói thời gian thực, nên dùng Cloud Run với --timeout 3600 và --min-instances 1
- Trước khi triển khai, phải dán điểm đánh giá và kết quả kiểm thử cho người dùng, hỏi “Ready to deploy to dev?” (Sẵn sàng triển khai lên môi trường dev?), chỉ chạy agents-cli deploy khi nhận được sự đồng ý rõ ràng; SKILL.md ghi rõ không bao giờ triển khai nếu không có sự phê duyệt của con người
- Khóa bí mật được quản lý qua Secret Manager, sử dụng --secrets để tiêm vào khi triển khai; cơ sở hạ tầng tùy chỉnh (Cloud SQL, Pub/Sub, v.v.) yêu cầu phải được viết trong Terraform, không tạo thủ công bằng gcloud
- Rollback: Chủ yếu dựa vào việc sửa lỗi git rồi chạy lại pipeline; Cloud Run có thể chuyển lưu lượng sang phiên bản cũ, GKE dùng kubectl rollout undo, còn Agent Runtime chỉ có thể sửa lỗi rồi triển khai lại
- publish và adk-code được ghi nhận hai ngày trước thuộc cùng một bộ công cụ; skills.sh có 4817 lượt cài đặt trong 24 giờ, tổng cộng 525087, số lượt cài đặt hàng tuần giảm từ đỉnh 132542 xuống còn 11134 (chỉ phản ánh mức độ quan tâm)
Cách sử dụng
- Lệnh cài đặt sẽ hiển thị sau khi vượt qua kiểm toán (kỳ này có cảnh báo rủi ro); CLI được cài đặt bằng lệnh uv tool install google-agents-cli
- Cần có dự án Google Cloud và các quyền tương ứng; nếu dự án chưa được thiết lập, hãy dùng /google-agents-cli-scaffold trước, tốt nhất là cài đặt toàn bộ bộ kỹ năng cùng lúc
- Được kích hoạt khi nói “deploy my ADK agent” (triển khai tác nhân ADK của tôi), “set up CI/CD” (thiết lập CI/CD), “configure secrets” (cấu hình khóa bí mật), v.v.; khi tự động phân tích dự án, trong môi trường không tương tác cần thêm --no-confirm-project
Rủi ro
- Các hành vi cài đặt, shell, yêu cầu mạng, đọc khóa bí mật được nêu trong kiểm toán đều phù hợp với mục đích sử dụng: cần cài đặt agents-cli, bản thân việc triển khai là gọi GCP và xử lý các khóa bí mật trong Secret Manager
- “Telemetry” được nêu trong kiểm toán tương ứng với cấu hình khả năng quan sát tùy chọn (Cloud Trace, nhật ký prompt và phản hồi được ghi vào BigQuery của chính dự án của bạn), không phải báo cáo cho bên thứ ba; khi bật, nội dung prompt sẽ được lưu vào cơ sở dữ liệu
- Việc triển khai, ủy quyền IAM, Terraform apply đều sẽ thay đổi các tài nguyên đám mây thực tế và phát sinh chi phí; các tài liệu chi tiết trong thư mục references/ không được quét