Hướng dẫn
Tối ưu hóa triển khai Google Cloud cho AI Agent với plugin google-cloud-developer
(giờ Việt Nam)
Tóm tắt AI
Remigiusz Samborski hướng dẫn sử dụng Antigravity CLI để cài đặt plugin google-cloud-developer, giúp các AI Agent như Claude Code tuân thủ các tiêu chuẩn tốt nhất của Google Cloud thông qua MCP server.
Chính văn · Bản dịch AI

Các tác nhân lập trình (coding agents) trong terminal có thể tạo khung microservices chỉ trong vài giây. Nhưng điều gì sẽ xảy ra khi tác nhân của bạn cần triển khai trực tiếp lên Google Cloud?
Nếu không có hướng dẫn cụ thể về đám mây, các tác nhân thông thường sẽ gặp khó khăn. Chúng thường "ảo tưởng" ra các lệnh SDK đã lỗi thời, cố gắng chạy lệnh mà không có quyền cần thiết, hoặc âm thầm kích hoạt các API tính phí gây ra những khoản chi phí bất ngờ trên hóa đơn của bạn.
Plugin google-cloud-developer thay đổi cục diện này. Nó trang bị cho tác nhân của bạn (như Antigravity CLI, Claude Code, Codex CLI) các kỹ năng được tinh chỉnh và máy chủ Developer Knowledge MCP server.
Để đánh giá plugin trong thực tế, tôi đã giao nhiệm vụ cho Antigravity CLI (agy) xây dựng một giải pháp hoàn chỉnh dựa trên đám mây từ một dự án Google Cloud mới. Kịch bản: tạo khung, đóng gói container và triển khai một proxy truyền phát Gemini API bảo mật trên Cloud Run, hoàn thiện với xác thực Cloud IAM và theo dõi token bằng Firestore.
Mặc dù cơ sở mã proxy Cloud Run thu được hoạt động tốt, nhưng bản thân proxy chỉ là một ví dụ. Giá trị thực sự nằm ở cách plugin hướng dẫn tác nhân qua từng giai đoạn của quy trình phát triển trên đám mây:
- Thiết kế ứng dụng và tạo mã SDK: Viết mã Gemini SDK mà không bị "ảo tưởng" và chọn đúng cơ sở dữ liệu.
- Giới thiệu dự án, xác minh thanh toán và kích hoạt API: Kiểm tra dự án, liên kết tài khoản Cloud Billing và yêu cầu sự chấp thuận rõ ràng từ người dùng trước khi kích hoạt các API tính phí.
- IAM đặc quyền tối thiểu và triển khai Cloud Run: Cấp phát các tài khoản dịch vụ chuyên dụng và triển khai container một cách bất đồng bộ.
- Xác minh toàn diện (End-to-end): Kiểm tra việc truyền phát và lưu trữ token trên dịch vụ thực tế.

Cài đặt nhanh: Năm kỹ năng và một máy chủ MCP
Bạn còn nhớ cảnh trong phim The Matrix khi Trinity gọi Tank để tải chương trình lái trực thăng và học nó trong vài giây không? Việc thêm plugin vào agy cũng hoạt động tương tự chỉ với một lệnh terminal:
agy plugin install https://github.com/google/skills/plugins/cloud/google-cloud-developerCLI sẽ sao chép kho lưu trữ plugin, đăng ký các thành phần của nó và làm cho chúng khả dụng ngay lập tức.

Chỉ trong vài giây, agy cấu hình:
- Năm kỹ năng chuyên biệt bao gồm các mẫu và quy trình làm việc của Google Cloud CLI.
- Máy chủ Developer Knowledge MCP cung cấp quyền truy cập vào cú pháp API hiện tại và tài liệu Google Cloud.
Khi plugin được kích hoạt, agy kết hợp mô hình Gemini 3.8 Flash của nó với các hướng dẫn đám mây có thẩm quyền.
Lưu ý: Là người dùng thường xuyên của Google Cloud, tôi đã cài đặt và xác thực gcloud. Tôi cũng đã kích hoạt Developer Knowledge API trong dự án của mình. Đối với người dùng mới và những người sử dụng các công cụ khác như Claude Code CLI hoặc Codex CLI, tôi khuyên bạn nên làm theo tài liệu chính thức để bắt đầu.
Nền tảng kiến thức: Viết mã SDK hiện đại mà không bị "ảo tưởng"
Một lỗi thường gặp ở các trợ lý lập trình AI là sự lỗi thời của API. Ví dụ, các hướng dẫn cũ thường dựa vào các thư viện đã bị loại bỏ như google-generativeai.
Vì plugin google-cloud-developer kết nối trực tiếp với Developer Knowledge API, tác nhân sẽ kiểm tra cú pháp chính thức mới nhất trước khi viết một dòng mã nào.
Khi tạo khung app/gemini_client.py, agy đã sử dụng ngay Google Gen AI SDK hợp nhất hiện tại:

Tác nhân đã tạo ra mã Python sạch với cấu hình Pydantic, các bộ định dạng Cloud Logging có cấu trúc và các bài kiểm thử đơn vị sử dụng pytest và TestClient của FastAPI.
Kiến trúc có cơ sở: Đánh giá các tùy chọn cơ sở dữ liệu với Developer Knowledge
Việc chọn đúng cơ sở dữ liệu cho một proxy serverless đòi hỏi sự cân bằng giữa độ trễ, xử lý kết nối, tính đồng thời và chi phí. Khi tôi yêu cầu agy theo dõi mức sử dụng token theo người dùng và đề xuất cơ sở dữ liệu tốt nhất, tác nhân không chỉ chọn ngẫu nhiên.
Được hỗ trợ bởi Developer Knowledge API, tác nhân đã truy xuất hướng dẫn kiến trúc theo thời gian thực và đánh giá các tùy chọn cơ sở dữ liệu của Google Cloud:

Bằng cách dựa trên nền tảng kiến thức Developer Knowledge, tác nhân đã trình bày một bảng so sánh rõ ràng ngay trong terminal. Nó đề xuất Cloud Firestore là lựa chọn hiệu quả nhất về chi phí và đơn giản nhất về mặt vận hành cho Cloud Run. Bạn nhận được một quyết định kiến trúc có cơ sở dựa trên các mẫu đám mây chính thức thay vì đoán mò.
Rào cản chi phí và giới thiệu: Xác minh thanh toán trước khi kích hoạt API
Khi mã và thiết kế Firestore đã sẵn sàng, tác nhân cần kích hoạt các API Gemini Enterprise, Cloud Run và Firestore trong dự án của tôi. Các tác nhân tự hành cần những ranh giới nghiêm ngặt ở đây vì việc kích hoạt API hoặc cấp phát tài nguyên được quản lý có thể phát sinh chi phí.
Hai kỹ năng trong plugin google-cloud-developer phối hợp bước này:
- Kiểm tra thanh toán trước khi thực hiện (Pre-flight billing audit): Trước khi kích hoạt các dịch vụ tính phí, kỹ năng google-cloud-recipe-onboarding hướng dẫn tác nhân xác minh rằng dự án mục tiêu đã được liên kết với một tài khoản Cloud Billing đang hoạt động (gcloud billing projects describe).
- Sự đồng ý rõ ràng của người dùng: Kỹ năng gcloud yêu cầu sự chấp thuận rõ ràng từ người dùng trước khi chạy lệnh gcloud services enable hoặc bất kỳ hành động gây thay đổi nào.
Khi agy xác định các API cần thiết cho proxy, nó đã kiểm tra trạng thái dự án của tôi trước và tạm dừng để chờ sự cho phép rõ ràng:
Các rào cản của hệ thống yêu cầu sự chấp thuận rõ ràng từ người dùng trước khi kích hoạt bất kỳ API nào, nhằm giải quyết cụ thể các rủi ro bảo mật tiềm ẩn và chi phí bất ngờ.
Điều này giúp bạn luôn nắm quyền kiểm soát và loại bỏ việc chi tiêu ngoài ý muốn.
Cách agy hỗ trợ: Lên lịch hẹn giờ cho việc cập nhật thanh toán
Trong quá trình kiểm tra trước khi thực hiện của kỹ năng giới thiệu, tôi đã liên kết một tài khoản thanh toán mới vào dự án thử nghiệm để agy có thể kích hoạt các API. Trong Google Cloud, việc liên kết tài khoản thanh toán thường mất vài phút để cập nhật trên các hệ thống backend.
Trong khi plugin google-cloud-developer hướng dẫn tác nhân cách xác thực trạng thái thanh toán (gcloud billing projects describe kiểm tra billingEnabled: true), agy bổ sung cho plugin bằng công cụ Schedule gốc của nó để phiên làm việc không bị lỗi hoặc rơi vào vòng lặp thử lại.
Tôi đã nhập:
"Được rồi. Hãy đợi bây giờ. Tôi vừa kích hoạt thanh toán và nó cần thời gian để cập nhật. Tôi sẽ kiểm tra lại sau 10 phút."
Bài gốc còn tiếp — xem tiếp tại bài gốc ↗
Bài viết được AI dịch và tổng hợp tự động từ Google AI: DEV tác giả. Liên kết bài gốc ở phía trên. Dữ liệu đồng bộ qua API công khai được ghi nguồn tại AI HOT (canonical) ↗. AIHOT.vn luôn dẫn nguồn đầy đủ — nếu bạn thấy điểm cần chỉnh sửa, hãy gửi ý kiến tại trang phản hồi.