Tóm tắt nhanh:
ak-google-adk-pythondựng agent bằng Google ADK cho Python: một agent có tool, chuỗi nhiều agent, gắn MCP server, gọi agent ở xa qua A2A, rồi deploy khi bạn yêu cầu. Nó viết code theo bảngoogle-adkproject đang cài và luôn kèm task hoặc eval để kiểm. Nó không nâng thư viện chỉ để khớp ví dụ mẫu, và không có skill tiếp theo cố định.
Công khai: mình là maintainer của AgentKit và có quan hệ affiliate: link AgentKit trong bài là link affiliate, mua qua link này bạn được giảm 30%.
Tóm tắt
Dùng khi bạn muốn làm hoặc mở rộng một agent viết bằng Google ADK Python, từ agent đơn tới đưa lên Cloud Run, Vertex AI hay GKE. Không cần khi project không dùng ADK, hoặc bạn chỉ hỏi một khái niệm chung về agent mà không viết code.
flowchart LR
A["Ý tưởng agent ADK"] --> B["ak-google-adk-python"]
B --> C["Code agent theo bản SDK đã cài"]
B --> D["Task hoặc eval để kiểm"]
C --> E["Chạy thử, deploy khi bạn yêu cầu"]Bốn điều skill luôn giữ khi viết agent:
| Khái niệm | Câu hỏi | Ví dụ |
|---|---|---|
| Điểm vào root_agent hoặc app | ADK tìm agent của bạn ở đâu? | __init__.py có from . import agent, agent.py khai root_agent = Agent(...). Cần plugin hay nén sự kiện cho phiên dài thì khai app = App(...). |
| Theo bản SDK đã cài | Ví dụ trong tài liệu có chạy được với bản google-adk của project không? | Mẫu dùng một model preview mà danh sách model hiện tại của bạn không có. Skill giữ model đang dùng và sửa code cho hợp SDK, chứ không nâng google-adk cho vừa mẫu. |
| Chọn đúng loại agent | Luồng này cố định, hay để model tự quyết gọi ai? | Thứ tự cố định dùng SequentialAgent. Điều phối viên chuyển câu hỏi cho agent "billing" hay "tech" dùng Agent có sub_agents. Soát lại vài vòng dùng LoopAgent với max_iterations. |
| Kiểm được bằng quan sát | Bằng chứng nào cho thấy agent chạy đúng? | Evalset có câu "2+2?" mong kết quả "4". Mỗi lần chạy ghi model, lỗi, thời gian, và chi phí nếu có telemetry, không có thì ghi không rõ. |
Đánh đổi: giữ bản SDK đang cài nghĩa là đôi khi phải sửa ví dụ mẫu thay vì chép nguyên. Ngoại lệ là lỗi mất phiên khi tool MCP trả lỗi: bản ADK hiện tại đã giữ phiên, nên nâng google-adk là cách đúng.
Prompt mẫu (agent đơn có tool):
/ak-google-adk-python Tạo agent hỗ trợ đơn hàng cho <tên dự án>.
Tool: tra trạng thái đơn theo mã, tính phí ship theo tỉnh.
Ràng buộc: giữ bản google-adk đang cài, model đang dùng trong project.
Xong khi: có evalset vài câu hỏi mẫu và agent trả đúng các câu đó.Skill này không có cờ.
Phần dưới đây là bản chi tiết: luồng chạy, 5 tình huống kèm prompt, lịch sử thay đổi theo bản ak và các lỗi hay vấp. Bản chi tiết và trang trực quan dành cho subscriber. Agent của bạn cũng tìm được trong đó qua MCP của portal.
Mở khi tài khoản có quyền subscriber
Bài này dành cho subscriber
Khi tài khoản có quyền, toàn bộ bài, bản visual tương tác và lệnh gọi từ agent đều mở.
- Đăng nhập hoặc tạo tài khoản modernEngineerQuyền đọc gắn với email tài khoản.
- Chọn gói trên trang Bảng giáGói 1, 3 hoặc 12 tháng, trả bằng chuyển khoản VietQR. Quyền đọc mở khoảng một phút sau khi tiền về.
- Hoặc nhập mã Facebook subscriberNgười ủng hộ trang qua Facebook nhận mã kích hoạt qua tin nhắn mỗi tháng.
Đã là subscriber? Đăng nhập để đọc.
Dùng bài này trong agent của bạn
Lấy API keyChép đoạn dưới, dán vào Claude Code, Codex hay agent bạn đang dùng. Agent đọc bài rồi đối chiếu với repo đang mở.
Đọc bài "ak-google-adk-python: dựng agent Google ADK theo đúng bản SDK đã cài" trên modernEngineer rồi áp dụng vào repo này.
1. Gọi tool content_get của MCP server modernengineer với locale "vi", slug "ak-google-adk-python". Nếu chưa nối MCP server modernengineer, dừng lại và hướng dẫn tôi nối theo https://modernengineer.dev/vi/mcp.
2. Tóm tắt các bước chính của bài, chỉ ra bước nào áp dụng được cho repo này.
3. Đề xuất thay đổi cụ thể và hỏi tôi trước khi sửa file.Nối MCP cho Claude Code (một lần)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Đọc trọn bài qua MCP cần API key của tài khoản subscriber hoặc đã mua guide này. Không có quyền, agent sẽ chỉ đọc được phần mở đầu.
- Phiên bản
- v1.0.0
- Cập nhật
- 22/10/2026
- Giấy phép
- Bảo lưu mọi quyền
- Slug
- ak-google-adk-python
