1. Tổng quan
Trong lớp học lập trình này, bạn sẽ chuyển đổi một tác nhân ADK 2.0 từ môi trường phát triển cục bộ sang một quy trình triển khai cấp sản xuất. Bạn sẽ sử dụng agents-cli để đóng gói, xác minh và lưu trữ quy trình làm việc dựa trên biểu đồ trực tiếp trên Thời gian chạy tác nhân trên Google Cloud.
Để khám phá quy trình triển khai này, bạn sẽ tạo một nguyên mẫu cục bộ của Ambient Expense Agent từ đầu trước khi triển khai nó lên đám mây. (Để tìm hiểu sâu hơn về cách thiết kế logic cốt lõi của tác nhân này, hãy xem các lớp học lập trình cơ bản trên trang web sự kiện Kaggle). Ambient Expense Agent giúp đơn giản hoá quy trình báo cáo chi phí của nhân viên bằng cách phê duyệt ngay lập tức các yêu cầu tiêu chuẩn, đồng thời gắn cờ những khoản chi phí lớn hơn để con người xem xét. Trong trường hợp này, quy trình sử dụng quy trình dựa trên đồ thị ADK 2.0 để điều phối các bước phê duyệt tự động và phân tích rủi ro này.
Kiến thức bạn sẽ học được
- Cách chuẩn bị dự án Ambient Expense Agent tại địa phương để lưu trữ trên đám mây.
- Cách tạo khung cho các bộ mô tả triển khai và trình bao bọc sản xuất cần thiết.
- Cách thực hiện các lượt chạy thử và triển khai mã trực tiếp vào Thời gian chạy của tác nhân.
- Cách theo dõi dấu vết thực thi của tác nhân sản xuất bằng Cloud Trace.
Bạn cần có
- Một dự án trên đám mây đang hoạt động trên Google Cloud đã bật tính năng thanh toán.
- gcloud SDK đã được cài đặt và xác thực.
- Trình quản lý gói uv đã được cài đặt.
- Đã cài đặt Google Antigravity IDE.
Điều kiện tiên quyết
Lớp học lập trình này giả định rằng bạn đã quen với:
- Điều hướng hệ thống bằng thiết bị đầu cuối.
- Các khái niệm cơ bản về phát triển Python.
- Các khái niệm cơ bản về Google Cloud.
2. Thiết lập môi trường Google Cloud
Trước khi triển khai, bạn phải định cấu hình dự án trên Google Cloud và bật các API cần thiết.
👉 Prompt Antigravity:
Help me set up my Google Cloud environment. Connect to my project
`YOUR_PROJECT_ID` in the global region, authenticate, and enable the necessary
generative platform APIs (aiplatform.googleapis.com, cloudtrace.googleapis.com,
cloudbuild.googleapis.com, agentregistry.googleapis.com).
Khi thực thi câu lệnh này, Antigravity sẽ đề xuất và chạy các lệnh cần thiết trên thiết bị đầu cuối gcloud để định cấu hình dự án và bật các dịch vụ. Trong bước xác thực, Antigravity sẽ hiển thị một URL uỷ quyền trong thiết bị đầu cuối. Nhấp vào đường liên kết để đăng nhập qua trình duyệt web và cấp quyền truy cập. Sau khi bạn hoàn tất quá trình đăng nhập bằng trình duyệt, Antigravity sẽ tiếp tục thực thi để thiết lập các biến môi trường dự án và bật các API bắt buộc.
3. Thiết lập Agents CLI và ADK Skills
Để Antigravity tạo và triển khai các tác nhân ADK một cách hiệu quả, bạn cần có bộ kỹ năng ADK. Đây là các tài liệu tham khảo được kết hợp cho ADK API, cấu trúc dự án, quy trình triển khai agents-cli và quy trình đánh giá. Việc cài đặt bộ công cụ agents-cli cũng sẽ cài đặt những kỹ năng này vào tác nhân mã hoá của bạn, giúp tác nhân này quản lý toàn bộ vòng đời của tác nhân từ giàn giáo cục bộ đến việc triển khai trên đám mây.
👉 Sao chép và dán câu lệnh sau vào Antigravity:
Install the agents-cli toolchain and its ADK skills so you can help me build
an ADK agent. Run "uvx google-agents-cli setup", then confirm with
"agents-cli info" and tell me which skills are now available.
Khi Antigravity thực thi câu lệnh này, công cụ này sẽ chạy uvx google-agents-cli setup trong thiết bị đầu cuối để cài đặt CLI và các kỹ năng đồng hành của CLI. Sau đó, Gemini sẽ chạy agents-cli info để xác minh quá trình cài đặt và liệt kê các kỹ năng miền mới cài đặt (chẳng hạn như google-agents-cli-deploy và google-agents-cli-workflow) ngay trong cuộc trò chuyện.
4. Tạo dự án tác nhân
Sau khi định cấu hình môi trường đám mây và cài đặt các kỹ năng CLI, bạn đã sẵn sàng tạo toàn bộ mã nguồn cục bộ cho tác nhân của mình. Trong bước này, bạn sẽ sử dụng Antigravity để tạo một nguyên mẫu Ambient Expense Agent có đầy đủ chức năng và tương thích với ADK 2.0.
👉 Prompt Antigravity:
Use Agents CLI to build a local prototype for an ambient expense agent that
streamlines employee expense reporting by instantly approving standard claims
while flagging larger expenses for review. Ensure the graph workflow is
compatible with ADK 2.0 and includes an `auto_approve` node that automatically
approves expenses under $100, and a `review_agent` node that triggers a
human-in-the-loop pause (`RequestInput`) for expenses of $100 or more.
Khi Antigravity thực thi câu lệnh này, công cụ này sẽ tận dụng các kỹ năng tạo khung mới cài đặt để chạy agents-cli scaffold create expense-agent --adk trong thiết bị đầu cuối. Sau đó, expense-agent sẽ xác minh và điều chỉnh mã nguyên mẫu đã tạo để đảm bảo expense-agent triển khai chính xác ngưỡng phê duyệt tự động $100 và quy trình xem xét có sự tham gia của con người trong quy trình công việc đồ thị Bộ công cụ phát triển tác nhân (ADK).
5. Chuẩn bị cho việc triển khai phát hành công khai
Thời gian chạy của tác nhân là một dịch vụ được quản lý hoàn toàn của Google Cloud, cho phép bạn triển khai, quản lý và mở rộng quy mô các tác nhân AI trong quá trình sản xuất. Agent Runtime xử lý các vấn đề phức tạp về hoạt động lưu trữ, cung cấp một môi trường có trạng thái với các tính năng như quản lý phiên, bộ nhớ dài hạn và hộp cát thực thi mã an toàn.
Tại sao nên triển khai đến Thời gian chạy của tác nhân?
Khi bạn tạo các tác nhân cục bộ bằng Antigravity, tác nhân của bạn sẽ chạy trên máy cục bộ dựa trên localhost. Mặc dù rất phù hợp để tạo mẫu nhanh, nhưng các tác nhân cục bộ sẽ ngừng chạy ngay khi bạn đóng máy tính xách tay.
Việc triển khai tác nhân của bạn vào Agent Runtime sẽ chuyển quy trình làm việc của bạn vào một môi trường Google Cloud luôn bật và được quản lý hoàn toàn. Điều này thiết lập một điểm cuối phụ trợ trực tiếp, an toàn và luôn hoạt động 24/7. Trong lớp học lập trình tiếp theo, bạn sẽ tạo một giao diện người dùng web kết nối trực tiếp với điểm cuối trên đám mây này, giúp tác nhân của bạn có một URL công khai.
Ngoài ra, Agent Runtime cung cấp cơ sở hạ tầng chuyên dụng được tối ưu hoá riêng cho các tác nhân AI, cung cấp các chức năng tích hợp như:
- Thực thi có trạng thái được quản lý: Quản lý phiên tích hợp và duy trì bộ nhớ dài hạn trong các lượt trò chuyện.
- Hộp cát an toàn: Thực thi an toàn các lệnh gọi công cụ động và mã do tác nhân tạo trong môi trường biệt lập.
- Khả năng quan sát doanh nghiệp: Truyền trực tiếp dữ liệu đo từ xa ngay khi xuất xưởng đến Cloud Trace và Cloud Logging.
Để lưu trữ tác nhân trên Agent Runtime, bạn phải nâng cao thư mục dự án cục bộ bằng các bộ mô tả, giản đồ và trình bao bọc điểm cuối sản xuất.
👉 Prompt Antigravity:
Scaffold the production deployment files for Agent Runtime.
Khi Antigravity thực thi câu lệnh này, nó sẽ chạy agents-cli scaffold enhance --deployment-target agent_runtime --yes trong thư mục gốc của dự án. Lệnh này sẽ quét thư mục của bạn và tự động tạo:
app/agent_runtime_app.py: Trình bao bọc dịch vụ cấp sản xuất.deployment_metadata.json: Lược đồ bố cục mà Agent Runtime dùng để tăng tốc các tài nguyên.
Logic cốt lõi của tác nhân trong app/agent.py vẫn hoàn toàn nguyên vẹn.
6. Đóng gói và xác minh tại địa phương
Trước khi bắt đầu tải lên đám mây, hãy khoá các gói và chạy thử nghiệm cục bộ để xác định các xung đột có thể xảy ra về phần phụ thuộc.
👉 Prompt Antigravity:
Lock my python dependencies and run a dry-run deployment to check for any
configuration or dependency issues.
Khi Antigravity thực thi lời nhắc này, trước tiên, công cụ sẽ chạy uv lock trong thiết bị đầu cuối để tạo một tệp khoá xác định, đảm bảo các phiên bản thư viện nhất quán trên đám mây. Sau đó, nó sẽ thực thi agents-cli deploy --dry-run để xác minh tính hợp lệ của cấu hình và xem trước các bước triển khai mà không cần cung cấp tài nguyên trên đám mây. Bạn có thể xem lại đầu ra của chế độ chạy thử trong thiết bị đầu cuối để xác nhận rằng tất cả tệp và chế độ cài đặt đều chính xác.
7. Triển khai cho Thời gian chạy tác nhân
Triển khai Ambient Expense Agent vào Agent Runtime.
👉 Prompt Antigravity:
Deploy this agent to Agent Runtime.
Khi Antigravity thực thi câu lệnh này, kỹ năng google-agents-cli-deploy sẽ được kích hoạt và chạy agents-cli deploy --project YOUR_PROJECT_ID --region us-west1. Quá trình đóng gói, tải lên và cung cấp Agent Runtime thường mất 5 đến 10 phút. Antigravity sẽ theo dõi tiến trình triển khai trong thiết bị đầu cuối và sau khi hoàn tất, nó sẽ hiển thị URL điểm cuối trực tiếp của bạn.
💡 Mẹo chuyên nghiệp (Quản lý khoảng thời gian chờ): Nếu không muốn khoá thiết bị đầu cuối trong quá trình triển khai dài, bạn có thể hướng dẫn Antigravity sử dụng cờ --no-wait để bắt đầu triển khai không đồng bộ và kiểm tra tiến trình sau bằng cách sử dụng agents-cli deploy --status.
8. Kiểm thử Nhân viên hỗ trợ
Sau khi triển khai trợ lý ảo, bạn có thể xác minh rằng trợ lý ảo tự động phê duyệt các khoản chi phí nhỏ và gắn cờ đúng cách để xác minh có sự tham gia của con người đối với các khoản chi phí lớn hơn.
👉 Yêu cầu Antigravity xác minh công cụ đã triển khai trực tiếp:
Test my deployed Agent Runtime engine with two test cases: first a standard
meal expense of $50 to verify automatic approval, and second, a client dinner
expense of $150 to verify that the human-in-the-loop pause is triggered.
Ngoài ra, bạn có thể kiểm thử tác nhân theo cách thủ công bằng cách sử dụng bản xem trước của Cloud Console Playground. Cách mở Playground:
- Trong Bảng điều khiển Google Cloud, hãy sử dụng trình đơn điều hướng để chọn Nền tảng tác nhân > Triển khai.
- Chọn tác nhân đã triển khai trong danh sách triển khai.
- Nhấp vào nút Playground (Sân chơi) để mở giao diện trò chuyện thử nghiệm tương tác.
👉 Để kiểm thử tính năng Tự động phê duyệt (dưới 100 đô la), hãy dán tải trọng JSON sau vào hộp trò chuyện:
{"data": {"amount": 50.0, "submitter": "user@example.com", "category": "meals", "description": "Lunch", "date": "2026-06-04"}}
Bạn sẽ nhận được một phản hồi JSON cho thấy đầu ra của nút auto_approve có trạng thái "đã phê duyệt".
👉 Để kiểm thử quy trình Human-in-the-Loop (HITL), hãy dán tải trọng JSON sau.
{"data": {"amount": 150.0, "submitter": "user@example.com", "category": "meals", "description": "Client dinner", "date": "2026-06-04"}}
Thao tác này sẽ kích hoạt review_agent, phát cảnh báo rồi tạm dừng thực thi, tạo ra RequestInput (Có sự tham gia của con người) yêu cầu phê duyệt.
9. Theo dõi và quan sát Production Agent
Với Agent Runtime, dữ liệu đo từ xa sẽ được tự động kết nối. Mọi lượt tương tác, lượt gọi mô hình và lượt thực thi công cụ đều truyền nhật ký và khoảng thời gian theo thời gian thực đến dự án của bạn.
- Kiểm tra dấu vết: Mở Cloud Trace Console để kiểm tra các bản đồ giao dịch trực tiếp, độ trễ của mô hình và các bước thực thi công cụ.
- Nhật ký kiểm tra: Sử dụng Cloud Logging để kiểm tra đầu ra tiêu chuẩn và dấu vết ngăn xếp chẩn đoán theo thời gian thực.
- Tổng hợp Analytics: Nếu cờ
--bq-analyticsđược bật trong quá trình dàn xếp, hãy truy vấn nhật ký của bạn trong BigQuery bằng SQL để xem tỷ lệ phê duyệt và xu hướng lượt tương tác trong cuộc trò chuyện.
Truy vấn SQL sau đây cung cấp một ví dụ về cách tính tỷ lệ phê duyệt. Bạn có thể nhắc Antigravity tuỳ chỉnh truy vấn này cho dự án cụ thể và tập dữ liệu BigQuery của mình:
SELECT
COUNTIF(REGEXP_CONTAINS(response_text, r'(?i)approved')) AS approved_count,
COUNTIF(REGEXP_CONTAINS(response_text, r'(?i)rejected')) AS rejected_count,
COUNT(1) AS total_processed,
SAFE_DIVIDE(COUNTIF(REGEXP_CONTAINS(response_text, r'(?i)approved')), COUNT(1)) AS approval_ratio
FROM
`[YOUR_PROJECT_ID].[YOUR_DATASET_ID].v_agent_response`
WHERE
agent = 'expense_processor';
10. (Không bắt buộc) Xác minh thông tin đăng ký trong Sổ đăng ký tác nhân
Để các dịch vụ, nhà phát triển hoặc tác nhân khác trong tổ chức của bạn có thể khám phá và sử dụng tác nhân chi phí một cách an toàn, bạn phải đăng ký tác nhân đó trong Sổ đăng ký tác nhân của doanh nghiệp (Gemini Enterprise).
Vì bạn đã triển khai tác nhân của mình cho Agent Runtime, nên tác nhân này sẽ tự động được đăng ký trong Agent Registry. Mọi nội dung cập nhật hoặc xoá tác nhân của bạn trong Agent Runtime trong tương lai cũng sẽ tự động đồng bộ hoá với Agent Registry.
👉 Yêu cầu Antigravity xác minh quy trình đăng ký tự động của tác nhân:
Verify that my deployed expense agent is automatically registered in the Gemini
Enterprise Agent Registry.
Khi Antigravity thực thi câu lệnh này, nó sẽ chạy agents-cli publish gemini-enterprise --list trong thiết bị đầu cuối. Thao tác này sẽ truy vấn Sổ đăng ký tác nhân và liệt kê tất cả các tác nhân Gemini Enterprise đã đăng ký trong dự án của bạn, cho phép bạn xác nhận rằng Tác nhân chi phí môi trường đang hoạt động và có thể phát hiện được trong tổ chức của bạn.
11. Dọn dẹp
Để tránh phát sinh các khoản phí liên tục trong tài khoản Google Cloud, bạn phải tắt và dọn dẹp các tài nguyên đã triển khai khi hoàn tất.
👉 Prompt Antigravity:
Clean up all my deployed cloud resources. Use the Agent Runtime ID from
deployment_metadata.json to delete the engine from Vertex AI, remove the local
deployment_metadata.json file, and delete the container image repository from
Artifact Registry.
Khi Antigravity thực thi lời nhắc này, công cụ sẽ tự động hoá toàn bộ quy trình dọn dẹp tài nguyên:
- Xoá Agent đã triển khai: Thao tác này sẽ đọc
deployment_metadata.jsonđể lấy Agent Runtime ID từ xa của bạn, sau đó xoá phiên bản công cụ đang hoạt động khỏi Vertex AI theo phương thức lập trình. - Clean up Local Workspace (Dọn dẹp không gian làm việc cục bộ): Thao tác này sẽ xoá tệp
deployment_metadata.jsonlỗi thời khỏi gốc dự án của bạn. - Dọn dẹp Artifact Registry: Thao tác này sẽ thực thi
gcloud artifacts docker images deleteđể xoá các hình ảnh vùng chứa đã tạo khỏi Artifact Registry, giải phóng dung lượng lưu trữ trên đám mây.
12. Xin chúc mừng
Xin chúc mừng! Bạn đã triển khai và xác minh thành công một Ambient Expense Agent cấp sản xuất trên Google Cloud.
Kiến thức bạn học được
- Thiết lập Google Cloud: Đã định cấu hình thông tin đăng nhập dự án và bật các API nền tảng bắt buộc.
- Công cụ và kỹ năng: Đã cài đặt
agents-clivà tải các kỹ năng đồng hành ADK vào Antigravity. - Khung dàn dựng sản xuất: Khung dàn dựng Thời gian chạy tác nhân được tạo cho tác nhân ADK 2.0.
- Xác minh cục bộ: Đã tạo các tệp khoá xác định (
uv lock) và thực hiện các bước kiểm tra chạy thử. - Triển khai trên đám mây: Lưu trữ trực tiếp tác nhân của bạn trên cơ sở hạ tầng Agent Runtime được quản lý.
- Khả năng ghi nhận và phân tích: Thực thi được theo dõi trong Cloud Trace và phân tích dữ liệu đo từ xa trong BigQuery.
- Khám phá doanh nghiệp: Đăng ký tự động đã xác minh trong Sổ đăng ký đại lý doanh nghiệp.
Tiếp theo là gì?
- Thực hiện hoạt động phân tích BigQuery: Truy vấn nhật ký đo từ xa của tác nhân trong BigQuery để phân tích tỷ lệ phê duyệt và xu hướng lượt đàm thoại theo thời gian.
- Lớp học lập trình Vibe to Live: Sử dụng Google Antigravity để phát triển một ứng dụng khách giao diện người dùng trên Cloud Run và kết nối ứng dụng đó trực tiếp với điểm cuối phụ trợ Agent Runtime đang hoạt động.
Nhận huy hiệu Tác nhân AI trong 5 ngày trên Kaggle 🎉
Bạn đã hoàn thành phòng thí nghiệm này trong khoá học 5-Day AI Agents: Intensive Vibe Coding Course with Google của Kaggle chưa? Nhận huy hiệu hoàn thành:
Nhận huy hiệu Tác nhân AI trong 5 ngày