Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

Nhập một agent Google ADK — một agent trên Gemini

Agent Config của một ứng dụng được xây dựng trên Agent Development Kit của Google — một agent trên Gemini, với công cụ Google Search đi kèm ADK — được aggrega import soạn nháp thành các tệp Aggrega, với image của ứng dụng được trả lời một lần trong một tệp câu trả lời, và được build cho Docker Compose.

Nhập một agent Google ADK hướng dẫn từng bước: lệnh, những gì nó hỏi, các tệp mà nó ghi và lý do từng dòng có mặt, quá trình build, và agent đang chạy. Thư mục này chứa từng giai đoạn của hướng dẫn đó:

thư mục hoặc tệpnội dung
source/cấu hình của agent, support_agent/root_agent.yaml, .aggrega-config.yaml biến thư mục thành một không gian làm việc, và support_agent/import-answers.yaml, các giá trị mà không cấu hình nào chứa: image của ứng dụng, và tên Secret Kubernetes mà một bản build cho Kubernetes đọc khóa API Gemini từ đó
draft/các tệp mà aggrega import support_agent --target compose đã ghi, không thay đổi, bao gồm cả release.lock, và những gì nó đã in ra: stdout.txt trên đầu ra chuẩn, import.txt trên đầu ra lỗi chuẩn

Cấu hình được viết cho ví dụ này. Mã của ứng dụng và tệp môi trường mà scaffold của ADK ghi ra không thuộc ví dụ: quá trình nhập không bao giờ đọc cái nào trong hai thứ đó, và Release chỉ định image mà ứng dụng chạy trong đó.

Trong một bản checkout của kho tài liệu, check.sh chạy lại quá trình nhập, so sánh những gì nó ghi và in ra với draft/, so sánh các khối mà hướng dẫn trích dẫn với các tệp này, và xác thực rồi build những gì quá trình nhập đã ghi. Nó cần catalog thư viện chuẩn (lấy ở đâu) được checkout bên cạnh kho này, hoặc thư mục của catalog đó được chỉ định trong AGGREGA_CATALOG_DIRS.

Tạo ví dụ

Bạn có thể chạy bước nhập của ví dụ này bằng các lệnh bên dưới, hoặc để trợ lý AI của bạn chạy thay bạn.

Ghi ví dụ vào một thư mục mới đặt theo tên của nó:

Terminal window
aggrega scaffold --example import-google-adk

Sau đó nó in ra các lệnh cần chạy tiếp theo. Lệnh đầu tiên chuyển vào thư mục mới:

Terminal window
cd import-google-adk

Build

Lệnh import soạn nháp các tệp Aggrega bên cạnh dự án, trong source/. Nó đối chiếu dự án với catalog của thư viện chuẩn, được registry mặc định của không gian làm việc phát hành dưới dạng một snapshot có chữ ký: lần import đầu tiên tải nó về, xác minh nó, lưu nó trong bộ nhớ đệm nội dung của không gian làm việc và ghi tên nó bằng digest trong bản ghi mà nó ghi bên cạnh các bản nháp. Một không gian làm việc chỉ định các thư mục catalog riêng — trong AGGREGA_CATALOG_DIRS, hoặc dưới workspace.catalog_dirs — thì sẽ import dựa trên các thư mục đó. Lệnh import đọc image từ support_agent/import-answers.yaml, rồi kéo về những gì mà Release đã soạn nháp phụ thuộc vào, nên có thể build ngay sau đó:

Terminal window
cd source
aggrega import support_agent --target compose
aggrega build --release release.yaml

Image mà ví dụ nêu tên đại diện cho image bạn build từ dự án của mình; cách build nó và chạy stack có trong hướng dẫn được liên kết ở trên.

Với trợ lý AI

Một trợ lý AI được thiết lập với các công cụ của Aggrega cũng có thể làm như vậy: hãy dán prompt này vào trợ lý.

Chỉ dùng các công cụ của Aggrega và không tự tạo thư mục nào. Nếu thư mục không gian làm việc chưa có thư mục `import-google-adk`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `import-google-adk` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `import-google-adk` mới, trong đó thư mục `source` chứa những gì ví dụ này nhập. Sau đó gọi công cụ `import` với `workspace_root` đặt thành `import-google-adk/source`, `source` đặt thành `support_agent` và `target` đặt thành `compose`: công cụ này đọc các câu trả lời nó cần từ `import-answers.yaml` bên trong thư mục `support_agent`, ghi các bản nháp vào `import-google-adk/source` và kéo về những gì chúng cần. Sau đó gọi công cụ `validate` với `workspace_root` đặt thành `import-google-adk/source` và `release` đặt thành `release.yaml`, và công cụ `build` với `workspace_root` đặt thành `import-google-adk/source`, `release` đặt thành `release.yaml` và `write` đặt thành true. Cho tôi biết bản build đã ghi những tệp nào; chúng nằm trong `import-google-adk/source/dist/`.

Kiểm thử

Khi stack đang chạy theo cách hướng dẫn chạy nó, trên image mà Dockerfile của nó build, hãy gửi cho agent một tin nhắn tại cổng mà Release công bố:

Terminal window
curl -sS -X POST http://127.0.0.1:8000/run -H 'Content-Type: application/json' \
-d '{"app_name": "support_agent", "user_id": "u1", "session_id": "s1", "new_message": {"role": "user", "parts": [{"text": "Where is my order 1234? Answer in one short sentence."}]}}'

Khóa Gemini của lần chạy là một giá trị giữ chỗ, nên yêu cầu trả về HTTP 500, Internal Server Error, và log của dịch vụ ghi rõ sự từ chối của Gemini:

google.genai.errors.ClientError: 400 INVALID_ARGUMENT. {'error': {'code': 400, 'message': 'API key not valid. Please pass a valid API key.', 'status': 'INVALID_ARGUMENT', [… omitted: the error's details]}}

Được nhập với --target helm, trên image được đẩy lên một registry mà cluster đọc, như hướng dẫn trình bày, agent trả lời cùng tin nhắn tại cùng địa chỉ khi một cổng cục bộ được chuyển tiếp tới Service của nó:

Terminal window
kubectl port-forward -n <namespace> svc/support-agent-default 8000:8000