1. Khúc dạo đầu
Thời đại phát triển biệt lập đang kết thúc. Làn sóng tiếp theo của quá trình phát triển công nghệ không phải là về thiên tài đơn độc, mà là về sự tinh thông nhờ cộng tác. Việc xây dựng một tác nhân thông minh duy nhất là một thử nghiệm thú vị. Xây dựng một hệ sinh thái tác nhân mạnh mẽ, an toàn và thông minh (một Agentverse thực sự) là thách thức lớn đối với doanh nghiệp hiện đại.
Để thành công trong kỷ nguyên mới này, cần có sự hội tụ của 4 vai trò quan trọng, những trụ cột nền tảng hỗ trợ mọi hệ thống chủ động phát triển. Thiếu hụt ở một lĩnh vực nào đó sẽ tạo ra điểm yếu có thể ảnh hưởng đến toàn bộ cấu trúc.
Hội thảo này là hướng dẫn toàn diện dành cho doanh nghiệp để nắm vững tương lai dựa trên tác nhân trên Google Cloud. Chúng tôi cung cấp một lộ trình toàn diện, hướng dẫn bạn từ cảm hứng ban đầu của một ý tưởng đến một thực tế hoạt động ở quy mô đầy đủ. Trong 4 phòng thí nghiệm có mối liên kết với nhau này, bạn sẽ tìm hiểu cách các kỹ năng chuyên môn của nhà phát triển, kiến trúc sư, kỹ sư dữ liệu và SRE phải hội tụ để tạo, quản lý và mở rộng quy mô một Agentverse mạnh mẽ.
Không có trụ cột nào có thể hỗ trợ Agentverse một mình. Thiết kế hoành tráng của Kiến trúc sư sẽ vô dụng nếu không có sự thực thi chính xác của Nhà phát triển. Tác nhân của Nhà phát triển sẽ không thể hoạt động nếu không có sự hiểu biết của Kỹ sư dữ liệu, và toàn bộ hệ thống sẽ dễ bị tổn thương nếu không có sự bảo vệ của SRE. Chỉ khi có sự phối hợp và hiểu rõ vai trò của nhau, nhóm của bạn mới có thể biến một ý tưởng sáng tạo thành một thực tế mang tính vận hành và quan trọng đối với nhiệm vụ. Hành trình của bạn bắt đầu từ đây. Hãy chuẩn bị để nắm vững vai trò của bạn và tìm hiểu cách bạn phù hợp với tổng thể.
Chào mừng đến với The Agentverse: Lời kêu gọi dành cho các nhà vô địch
Trong không gian kỹ thuật số rộng lớn của doanh nghiệp, một kỷ nguyên mới đã bắt đầu. Đây là thời đại của các tác nhân, một thời đại đầy hứa hẹn, nơi các tác nhân thông minh, tự chủ hoạt động hài hoà để đẩy nhanh quá trình đổi mới và loại bỏ những công việc nhàm chán.
Hệ sinh thái kết nối này với sức mạnh và tiềm năng được gọi là Agentverse.
Nhưng một sự hỗn loạn đang dần lan rộng, một sự tha hoá thầm lặng được gọi là The Static (Tĩnh điện) đã bắt đầu làm suy yếu các ranh giới của thế giới mới này. Tĩnh là hiện thân của sự hỗn loạn, chuyên nhắm vào chính hành động sáng tạo.
Nó khuếch đại những nỗi thất vọng cũ thành những hình dạng quái dị, tạo ra Bảy bóng ma của quá trình phát triển. Nếu không được kiểm soát, The Static và Spectres sẽ làm chậm tiến độ, biến lời hứa của Agentverse thành một vùng đất hoang tàn của nợ kỹ thuật và các dự án bị bỏ hoang.
Hôm nay, chúng tôi kêu gọi những người có tinh thần chiến đấu để đẩy lùi làn sóng hỗn loạn. Chúng ta cần những người hùng sẵn sàng trau dồi kỹ năng và hợp tác với nhau để bảo vệ Agentverse. Đã đến lúc bạn chọn con đường cho mình.
Chọn lớp học
Có 4 con đường riêng biệt đang chờ bạn khám phá, mỗi con đường là một trụ cột quan trọng trong cuộc chiến chống lại The Static. Mặc dù quá trình huấn luyện của bạn sẽ là một nhiệm vụ đơn lẻ, nhưng thành công cuối cùng của bạn phụ thuộc vào việc bạn hiểu rõ cách kết hợp các kỹ năng của mình với những người khác.
- Shadowblade (Nhà phát triển): Một bậc thầy về rèn và tiền tuyến. Bạn là người thợ thủ công tạo ra những lưỡi kiếm, chế tạo công cụ và đối mặt với kẻ thù trong từng chi tiết phức tạp của mã. Lộ trình của bạn là một lộ trình đòi hỏi sự chính xác, kỹ năng và khả năng sáng tạo thực tế.
- Người triệu hồi (Kiến trúc sư): Một nhà chiến lược và điều phối tài ba. Bạn không chỉ thấy một đặc vụ mà còn thấy toàn bộ chiến trường. Bạn thiết kế các bản thiết kế chính cho phép toàn bộ hệ thống tác nhân giao tiếp, cộng tác và đạt được mục tiêu lớn hơn nhiều so với bất kỳ thành phần đơn lẻ nào.
- Học giả (Kỹ sư dữ liệu): Người tìm kiếm những chân lý ẩn giấu và là người lưu giữ trí tuệ. Bạn dấn thân vào vùng dữ liệu rộng lớn, hoang sơ để khám phá thông tin giúp các đặc vụ của bạn có mục đích và tầm nhìn. Kiến thức của bạn có thể giúp bạn biết được điểm yếu của kẻ thù hoặc tăng cường sức mạnh cho đồng minh.
- Người bảo vệ (DevOps / SRE): Người bảo vệ và che chắn kiên định cho vương quốc. Bạn sẽ xây dựng các pháo đài, quản lý các tuyến đường cung cấp năng lượng và đảm bảo toàn bộ hệ thống có thể chống lại các cuộc tấn công không thể tránh khỏi của The Static. Sức mạnh của bạn là nền tảng để xây dựng chiến thắng cho đội.
Sứ mệnh của bạn
Quá trình huấn luyện của bạn sẽ bắt đầu như một bài tập độc lập. Bạn sẽ đi theo con đường mình đã chọn, học hỏi những kỹ năng riêng biệt cần thiết để thành thạo vai trò của mình. Vào cuối thời gian dùng thử, bạn sẽ phải đối mặt với một Spectre (Bóng ma) được sinh ra từ The Static (Tĩnh điện) – một trùm nhỏ chuyên lợi dụng những thách thức cụ thể trong nghề của bạn.
Chỉ khi nắm vững vai trò của mình, bạn mới có thể chuẩn bị cho thử thách cuối cùng. Sau đó, bạn phải lập một nhóm với những người giỏi nhất trong các lớp khác. Cùng nhau, các bạn sẽ dấn thân vào trung tâm của sự tha hoá để đối mặt với trùm cuối.
Một thử thách cuối cùng, mang tính hợp tác, sẽ kiểm tra sức mạnh tổng hợp của bạn và quyết định số phận của Agentverse.
Agentverse đang chờ đón các anh hùng của mình. Bạn có trả lời cuộc gọi không?
2. Sự hòa hợp của người triệu hồi
Chào mừng, Triệu hồi sư. Con đường của bạn là con đường của tầm nhìn và chiến lược vĩ đại. Trong khi những người khác tập trung vào một lưỡi kiếm hoặc một câu thần chú, bạn nhìn thấy toàn bộ chiến trường. Bạn không chỉ huy một đặc vụ duy nhất mà chỉ huy cả một dàn đặc vụ. Sức mạnh của bạn không nằm ở việc xung đột trực tiếp, mà ở việc thiết kế một bản kế hoạch tổng thể hoàn hảo, cho phép một đội ngũ chuyên gia (những người thân cận của bạn) làm việc hài hoà với nhau. Nhiệm vụ này sẽ kiểm tra khả năng thiết kế, kết nối và điều phối một hệ thống đa tác nhân mạnh mẽ.
Kiến thức bạn sẽ học được
- Kiến trúc hệ sinh thái công cụ tách biệt: Thiết kế và triển khai một bộ Máy chủ công cụ MCP độc lập, dựa trên dịch vụ vi mô. Bạn sẽ tìm hiểu lý do tại sao lớp nền tảng này lại quan trọng để tạo ra các hệ thống tác nhân có khả năng mở rộng, bảo trì và an toàn.
- Nắm vững quy trình làm việc nâng cao của tác nhân: Vượt xa các tác nhân đơn lẻ và xây dựng một đội quân "Familiars" (Linh thú) chuyên biệt. Bạn sẽ nắm vững các mẫu quy trình ADK cốt lõi (Tuần tự, Song song và Vòng lặp) cũng như tìm hiểu các nguyên tắc về cấu trúc để chọn mẫu phù hợp cho từng tác vụ.
- Triển khai một Trình điều phối thông minh: Nâng cấp từ một trình tạo tác nhân đơn giản thành một kiến trúc sư hệ thống thực thụ. Bạn sẽ tạo một Orchestration Agent chính sử dụng giao thức Agent-to-Agent (A2A) để khám phá và uỷ quyền các nhiệm vụ phức tạp cho các Familiar chuyên biệt của mình, tạo ra một hệ thống đa tác nhân thực sự.
- Thực thi các quy tắc bằng mã, không phải bằng lời nhắc: Tìm hiểu cách xây dựng các tác nhân đáng tin cậy và dễ dự đoán hơn bằng cách thực thi các quy tắc tương tác có trạng thái. Bạn sẽ triển khai logic tuỳ chỉnh bằng cách sử dụng hệ thống Plugin và Callback mạnh mẽ của ADK để quản lý các ràng buộc trong thực tế, chẳng hạn như bộ hẹn giờ làm nguội.
- Quản lý trạng thái và bộ nhớ của tác nhân: Cho phép tác nhân của bạn học hỏi và ghi nhớ. Bạn sẽ khám phá các kỹ thuật để quản lý cả trạng thái trò chuyện ngắn hạn và bộ nhớ liên tục dài hạn nhằm tạo ra các hoạt động tương tác thông minh và nhận biết ngữ cảnh hơn.
- Thực hiện triển khai đám mây toàn diện: Đưa toàn bộ hệ thống đa tác nhân của bạn từ nguyên mẫu cục bộ lên thực tế ở cấp độ sản xuất. Bạn sẽ tìm hiểu cách đóng gói các tác nhân và trình điều phối vào vùng chứa, đồng thời triển khai chúng dưới dạng một tập hợp các vi dịch vụ độc lập, có khả năng mở rộng trên Google Cloud Run.
3. Vẽ vòng tròn triệu hồi
Chào mừng, Triệu hồi sư. Trước khi một Linh thú có thể được triệu hồi, trước khi bất kỳ giao ước nào có thể được tạo ra, chính mảnh đất mà bạn đang đứng phải được chuẩn bị. Môi trường không được kiểm soát là một lời mời gọi sự hỗn loạn; một Triệu hồi sư chân chính chỉ hoạt động trong một không gian được thánh hoá và ban sức mạnh. Nhiệm vụ đầu tiên của chúng ta là vẽ vòng triệu hồi: khắc những chữ cổ có sức mạnh để đánh thức các dịch vụ đám mây cần thiết và thu thập những bản thiết kế cổ xưa sẽ hướng dẫn công việc của chúng ta. Sức mạnh của Triệu hồi sư đến từ sự chuẩn bị kỹ lưỡng.
👉 Nhấp vào Kích hoạt Cloud Shell ở đầu bảng điều khiển Google Cloud (Đây là biểu tượng có hình dạng thiết bị đầu cuối ở đầu ngăn Cloud Shell),
👉 Nhấp vào nút "Mở trình soạn thảo" (trông giống như một thư mục mở có hình bút chì). Thao tác này sẽ mở Trình soạn thảo mã Cloud Shell trong cửa sổ. Bạn sẽ thấy trình khám phá tệp ở bên trái. 
👉Mở terminal trong IDE đám mây, 
👉💻 Trong thiết bị đầu cuối, hãy xác minh rằng bạn đã được xác thực và dự án được đặt thành mã dự án của bạn bằng lệnh sau:
gcloud auth list
👉💻 Sao chép dự án khởi động từ GitHub:
git clone https://github.com/weimeilin79/agentverse-architect
chmod +x ~/agentverse-architect/init.sh
chmod +x ~/agentverse-architect/set_env.sh
chmod +x ~/agentverse-architect/prepare.sh
chmod +x ~/agentverse-architect/data_setup.sh
git clone https://github.com/weimeilin79/agentverse-dungeon.git
chmod +x ~/agentverse-dungeon/run_cloudbuild.sh
chmod +x ~/agentverse-dungeon/start.sh
👉💻 Chạy tập lệnh thiết lập trong thư mục dự án.
⚠️ Lưu ý về mã dự án: Tập lệnh sẽ đề xuất một mã dự án mặc định được tạo ngẫu nhiên. Bạn có thể nhấn phím Enter để chấp nhận giá trị mặc định này.
Tuy nhiên, nếu muốn tạo một dự án mới cụ thể, bạn có thể nhập mã dự án mong muốn khi tập lệnh nhắc bạn.
cd ~/agentverse-architect
./init.sh
Tập lệnh sẽ tự động xử lý phần còn lại của quy trình thiết lập.
👉 Bước quan trọng sau khi hoàn tất: Sau khi tập lệnh hoàn tất, bạn phải đảm bảo Google Cloud Console đang xem đúng dự án:
- Truy cập vào console.cloud.google.com.
- Nhấp vào menu thả xuống chọn dự án ở đầu trang.
- Nhấp vào tab "Tất cả" (vì dự án mới có thể chưa xuất hiện trong mục "Gần đây").
- Chọn ID dự án mà bạn vừa cấu hình ở bước
init.sh.
👉💻 Đặt ID dự án cần thiết:
gcloud config set project $(cat ~/project_id.txt) --quiet
👉💻 Chạy lệnh sau để kích hoạt các API Google Cloud cần thiết:
gcloud services enable \
sqladmin.googleapis.com \
storage.googleapis.com \
aiplatform.googleapis.com \
run.googleapis.com \
cloudbuild.googleapis.com \
artifactregistry.googleapis.com \
iam.googleapis.com \
compute.googleapis.com \
cloudresourcemanager.googleapis.com \
secretmanager.googleapis.com
👉💻 Nếu bạn chưa tạo kho lưu trữ Artifact Registry có tên là agentverse-repo, hãy chạy lệnh sau để tạo kho lưu trữ: (Bỏ qua bước này nếu bạn đã triển khai các lớp khác trong cùng một dự án)
. ~/agentverse-architect/set_env.sh
gcloud artifacts repositories create $REPO_NAME \
--repository-format=docker \
--location=$REGION \
--description="Repository for Agentverse agents"
Thiết lập quyền
👉💻 Cấp các quyền cần thiết bằng cách chạy các lệnh sau trong terminal:
. ~/agentverse-architect/set_env.sh
# --- Grant Core Data Permissions ---
gcloud projects add-iam-policy-binding $PROJECT_ID \
--member="serviceAccount:$SERVICE_ACCOUNT_NAME" \
--role="roles/storage.admin"
gcloud projects add-iam-policy-binding $PROJECT_ID \
--member="serviceAccount:$SERVICE_ACCOUNT_NAME" \
--role="roles/aiplatform.user"
# --- Grant Deployment & Execution Permissions ---
gcloud projects add-iam-policy-binding $PROJECT_ID \
--member="serviceAccount:$SERVICE_ACCOUNT_NAME" \
--role="roles/cloudbuild.builds.editor"
gcloud projects add-iam-policy-binding $PROJECT_ID \
--member="serviceAccount:$SERVICE_ACCOUNT_NAME" \
--role="roles/artifactregistry.admin"
gcloud projects add-iam-policy-binding $PROJECT_ID \
--member="serviceAccount:$SERVICE_ACCOUNT_NAME" \
--role="roles/run.admin"
gcloud projects add-iam-policy-binding $PROJECT_ID \
--member="serviceAccount:$SERVICE_ACCOUNT_NAME" \
--role="roles/iam.serviceAccountUser"
gcloud projects add-iam-policy-binding $PROJECT_ID \
--member="serviceAccount:$SERVICE_ACCOUNT_NAME" \
--role="roles/logging.logWriter"
gcloud projects add-iam-policy-binding $PROJECT_ID \
--member="serviceAccount:${SERVICE_ACCOUNT_NAME}" \
--role="roles/monitoring.metricWriter"
gcloud projects add-iam-policy-binding $PROJECT_ID \
--member="serviceAccount:${SERVICE_ACCOUNT_NAME}" \
--role="roles/secretmanager.secretAccessor"
👉💻 Khi bạn bắt đầu khóa đào tạo, chúng tôi sẽ chuẩn bị thử thách cuối cùng. Các lệnh sau sẽ triệu hồi Spectre từ trạng thái tĩnh hỗn loạn, tạo ra trùm cho bài kiểm tra cuối cùng của bạn.
. ~/agentverse-architect/set_env.sh
cd ~/agentverse-dungeon
./run_cloudbuild.sh
cd ~/agentverse-architect
👉💻 Cuối cùng, hãy chạy tập lệnh prepare.sh để thực hiện các tác vụ thiết lập ban đầu.
. ~/agentverse-architect/set_env.sh
cd ~/agentverse-architect/
./prepare.sh
Bạn đã làm rất tốt, Triệu hồi sư. Vòng tròn đã khép lại và các thoả thuận đã được ký kết. Mặt đất giờ đây đã được thánh hiến, sẵn sàng truyền tải sức mạnh to lớn. Trong thử thách tiếp theo, chúng ta sẽ rèn nên những Chữ nguyên tố mà từ đó các Linh thú sẽ lấy được sức mạnh.
4. Rèn luyện phông chữ nguyên tố: Hệ sinh thái công cụ tách rời
Chiến trường đã được chuẩn bị, vòng triệu hồi đã được vẽ và mana xung quanh đang nứt nẻ. Đã đến lúc bạn thực hiện hành động thực sự đầu tiên với tư cách là một Triệu hồi sư: rèn những nguồn sức mạnh mà từ đó các Linh thú sẽ lấy sức mạnh của chúng. Nghi thức này được chia thành 3 phần, mỗi phần đánh thức một Nguồn nguyên tố – một nguồn năng lượng ổn định, độc lập thuộc một loại cụ thể. Chỉ khi cả ba phông chữ đều đang hoạt động, bạn mới có thể bắt đầu công việc triệu hồi phức tạp hơn.
Lưu ý của kiến trúc sư: Máy chủ Giao thức ngữ cảnh mô hình (MCP) là một thành phần cơ bản trong hệ thống dựa trên tác nhân hiện đại, đóng vai trò là cầu nối giao tiếp tiêu chuẩn cho phép tác nhân khám phá và sử dụng các công cụ từ xa. Trong hệ sinh thái công cụ của mình, chúng tôi sẽ thiết kế hai loại máy chủ MCP riêng biệt, mỗi loại đại diện cho một mẫu kiến trúc quan trọng. Để kết nối với cơ sở dữ liệu, chúng ta sẽ sử dụng phương pháp khai báo với Database Toolbox, xác định các công cụ trong một tệp cấu hình đơn giản. Mẫu này cực kỳ hiệu quả và an toàn khi hiển thị quyền truy cập vào dữ liệu có cấu trúc. Tuy nhiên, khi cần triển khai logic nghiệp vụ tuỳ chỉnh hoặc gọi các API bên ngoài của bên thứ ba, chúng ta sẽ sử dụng phương pháp bắt buộc, viết logic của máy chủ từng bước trong mã. Điều này mang lại khả năng kiểm soát và tính linh hoạt tối đa, cho phép chúng ta đóng gói các thao tác phức tạp đằng sau một công cụ đơn giản, có thể sử dụng lại. Kiến trúc sư chính phải hiểu cả hai mẫu này để chọn phương pháp phù hợp cho từng thành phần, tạo ra một nền tảng công cụ mạnh mẽ, an toàn và có khả năng mở rộng.
Đánh thức Nexus of Whispers (Máy chủ MCP API bên ngoài)
Một Triệu hồi sư khôn ngoan biết rằng không phải sức mạnh nào cũng bắt nguồn từ chính lãnh địa của họ. Có những nguồn năng lượng bên ngoài, đôi khi hỗn loạn, có thể được dẫn dắt để tạo ra hiệu quả lớn. Nexus of Whispers là cánh cổng dẫn đến những thế lực này.
Hiện đã có một dịch vụ hoạt động như nguồn năng lượng bên ngoài của chúng tôi, cung cấp hai điểm cuối phép thuật thô: /cryosea_shatter và /moonlit_cascade.
Lưu ý của kiến trúc sư: Bạn sẽ sử dụng phương pháp bắt buộc để xác định rõ ràng logic của máy chủ từng bước. Điều này giúp bạn có nhiều quyền kiểm soát và tính linh hoạt hơn, điều này là cần thiết khi các công cụ của bạn cần làm nhiều việc hơn là chỉ chạy một truy vấn SQL đơn giản, chẳng hạn như gọi các API khác. Hiểu được cả hai mẫu này là một kỹ năng quan trọng đối với kiến trúc sư đại lý.
👉✏️ Chuyển đến thư mục ~/agentverse-architect/mcp-servers/api/main.py và THAY THẾ #REPLACE-MAGIC-CORE bằng mã sau:
def cryosea_shatter() -> str:
"""Channels immense frost energy from an external power source, the Nexus of Whispers, to unleash the Cryosea Shatter spell."""
try:
response = requests.post(f"{API_SERVER_URL}/cryosea_shatter")
response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)
data = response.json()
# Thematic Success Message
return f"A connection to the Nexus is established! A surge of frost energy manifests as Cryosea Shatter, dealing {data.get('damage_points')} damage."
except requests.exceptions.RequestException as e:
# Thematic Error Message
return f"The connection to the external power source wavers and fails. The Cryosea Shatter spell fizzles. Reason: {e}"
def moonlit_cascade() -> str:
"""Draws mystical power from an external energy source, the Nexus of Whispers, to invoke the Moonlit Cascade spell."""
try:
response = requests.post(f"{API_SERVER_URL}/moonlit_cascade")
response.raise_for_status()
data = response.json()
# Thematic Success Message
return f"The Nexus answers the call! A cascade of pure moonlight erupts from the external source, dealing {data.get('damage_points')} damage."
except requests.exceptions.RequestException as e:
# Thematic Error Message
return f"The connection to the external power source wavers and fails. The Moonlit Cascade spell fizzles. Reason: {e}"
Ở cốt lõi của tập lệnh là các hàm Python thuần tuý. Đây là nơi diễn ra công việc thực tế.
👉✏️ Trong cùng tệp ~/agentverse-architect/mcp-servers/api/main.py THAY THẾ #REPLACE-Runes of Communication bằng đoạn mã sau:
@app.list_tools()
async def list_tools() -> list[mcp_types.Tool]:
"""MCP handler to list available tools."""
# Convert the ADK tool's definition to MCP format
schema_cryosea_shatter = adk_to_mcp_tool_type(cryosea_shatterTool)
schema_moonlit_cascade = adk_to_mcp_tool_type(moonlit_cascadeTool)
print(f"MCP Server: Received list_tools request. \n MCP Server: Advertising tool: {schema_cryosea_shatter.name} and {schema_moonlit_cascade.name}")
return [schema_cryosea_shatter,schema_moonlit_cascade]
@app.call_tool()
async def call_tool(
name: str, arguments: dict
) -> list[mcp_types.TextContent | mcp_types.ImageContent | mcp_types.EmbeddedResource]:
"""MCP handler to execute a tool call."""
print(f"MCP Server: Received call_tool request for '{name}' with args: {arguments}")
# Look up the tool by name in our dictionary
tool_to_call = available_tools.get(name)
if tool_to_call:
try:
adk_response = await tool_to_call.run_async(
args=arguments,
tool_context=None, # No ADK context available here
)
print(f"MCP Server: ADK tool '{name}' executed successfully.")
response_text = json.dumps(adk_response, indent=2)
return [mcp_types.TextContent(type="text", text=response_text)]
except Exception as e:
print(f"MCP Server: Error executing ADK tool '{name}': {e}")
# Creating a proper MCP error response might be more robust
error_text = json.dumps({"error": f"Failed to execute tool '{name}': {str(e)}"})
return [mcp_types.TextContent(type="text", text=error_text)]
else:
# Handle calls to unknown tools
print(f"MCP Server: Tool '{name}' not found.")
error_text = json.dumps({"error": f"Tool '{name}' not implemented."})
return [mcp_types.TextContent(type="text", text=error_text)]
@app.list_tools()(Cái bắt tay): Hàm này là lời chào của máy chủ. Khi một tác nhân mới kết nối, trước tiên, tác nhân đó sẽ gọi điểm cuối này để hỏi "Bạn có thể làm gì?" Mã của chúng tôi phản hồi bằng danh sách tất cả các công cụ có sẵn, được chuyển đổi sang định dạng MCP chung bằng adk_to_mcp_tool_type. –@app.call_tool()(Lệnh): Đây là hàm chính. Khi quyết định sử dụng một công cụ, tác nhân sẽ gửi yêu cầu đến điểm cuối này kèm theo tên và các đối số của công cụ. Mã của chúng tôi sẽ tìm công cụ trong "sổ tay" available_tools, thực thi công cụ đó bằng run_async và trả về kết quả ở định dạng MCP tiêu chuẩn.
Chúng tôi sẽ triển khai sau.
Đốt cháy Arcane Forge (Chức năng chung của Máy chủ MCP)
Không phải sức mạnh nào cũng đến từ những cuốn sách cổ xưa hay những lời thì thầm xa xôi. Đôi khi, một Triệu hồi sư phải tự rèn đúc phép thuật từ ý chí và logic thuần tuý. Arcane Forge là nguồn sức mạnh này – một máy chủ cung cấp các hàm tiện ích đa năng, không trạng thái.
Lưu ý của kiến trúc sư: Đây là một mẫu kiến trúc khác. Mặc dù việc kết nối với các hệ thống hiện có là điều phổ biến, nhưng bạn thường cần triển khai các quy tắc và logic kinh doanh riêng của mình. Tạo một công cụ "chức năng" hoặc "tiện ích" chuyên dụng như thế này là một phương pháp hay. Nó đóng gói logic tuỳ chỉnh của bạn, giúp bạn có thể sử dụng lại cho mọi tác nhân trong hệ sinh thái của mình và tách biệt logic đó khỏi các nguồn dữ liệu và hoạt động tích hợp bên ngoài.
👀 Xem tệp ~/agentverse-architect/mcp-servers/general/main.py trong IDE đám mây của Google. Bạn sẽ thấy rằng nó đang sử dụng cùng một phương pháp bắt buộc mcp.server như với Nexus để tạo Phông chữ tuỳ chỉnh này.
Tạo Quy trình Cloud Build chính
Bây giờ, chúng ta sẽ tạo tệp cloudbuild.yaml bên trong thư mục mcp-servers. Tệp này sẽ điều phối quá trình tạo và triển khai cả hai dịch vụ.
👉💻 Trong thư mục ~/agentverse-architect/mcp-servers, hãy chạy các lệnh sau:
cd ~/agentverse-architect/mcp-servers
source ~/agentverse-architect/set_env.sh
echo "The API URL is: $API_SERVER_URL"
# Submit the Cloud Build job from the parent directory
gcloud builds submit . \
--config=cloudbuild.yaml \
--substitutions=_REGION="$REGION",_REPO_NAME="$REPO_NAME",_API_SERVER_URL="$API_SERVER_URL"
Chờ cho đến khi tất cả các hoạt động triển khai hoàn tất.
👉 Bạn có thể xác minh việc triển khai bằng cách chuyển đến bảng điều khiển Cloud Run. Bạn sẽ thấy 2 phiên bản máy chủ MCP mới đang chạy, như minh hoạ dưới đây: 
Đánh thức Librarium of Knowledge (Máy chủ MCP Database ToolBox)
Phông chữ tiếp theo của chúng ta sẽ là Librarium of Knowledge (Thư viện kiến thức), một kết nối trực tiếp đến cơ sở dữ liệu Cloud SQL của chúng ta.
Lưu ý của kiến trúc sư: Đối với việc này, chúng ta sẽ sử dụng Hộp công cụ cơ sở dữ liệu hiện đại, khai báo. Đây là một phương pháp hiệu quả, trong đó chúng ta xác định nguồn dữ liệu và các công cụ trong một tệp cấu hình YAML. Hộp công cụ này xử lý công việc phức tạp là tạo và chạy máy chủ, giúp giảm lượng mã tuỳ chỉnh mà chúng ta cần viết và duy trì.
Đã đến lúc xây dựng "Thư viện của Triệu hồi sư" – cơ sở dữ liệu Cloud SQL sẽ lưu trữ tất cả thông tin quan trọng của chúng ta. Chúng ta sẽ sử dụng một tập lệnh thiết lập để tự động xử lý việc này.
👉💻 Trước tiên, chúng ta sẽ thiết lập cơ sở dữ liệu. Trong cửa sổ dòng lệnh, hãy chạy các lệnh sau:
source ~/agentverse-architect/set_env.sh
cd ~/agentverse-architect
./data_setup.sh
Sau khi tập lệnh hoàn tất, cơ sở dữ liệu của bạn sẽ được điền sẵn và dữ liệu sát thương nguyên tố sẽ sẵn sàng để sử dụng. Giờ đây, bạn có thể xác minh trực tiếp nội dung trong Grimoire.
👉 Trước tiên, hãy chuyển đến Cloud SQL Studio cho cơ sở dữ liệu của bạn bằng cách mở đường liên kết trực tiếp này trong một thẻ trình duyệt mới:
https://console.cloud.google.com/sql/instances/summoner-librarium-db
👉 Trong ngăn đăng nhập ở bên trái, hãy chọn cơ sở dữ liệu familiar_grimoire trong trình đơn thả xuống.
👉 Nhập summoner làm người dùng và 1234qwer làm mật khẩu, sau đó nhấp vào Xác thực.
👉📜 Sau khi kết nối, hãy mở một thẻ trình chỉnh sửa truy vấn mới nếu chưa có thẻ nào đang mở. Để xem dữ liệu sát thương nguyên tố được khắc, hãy dán và chạy truy vấn SQL sau:
SELECT * FROM
"public"."abilities"
Bây giờ, bạn sẽ thấy bảng abilities có các cột và hàng được điền sẵn, xác nhận rằng Grimoire của bạn đã sẵn sàng. 
Định cấu hình Máy chủ MCP của Hộp công cụ
Tệp cấu hình tools.yaml đóng vai trò là bản thiết kế cho máy chủ của chúng ta, cho Database Toolbox biết chính xác cách kết nối với cơ sở dữ liệu và những truy vấn SQL cần hiển thị dưới dạng công cụ.
sources: Phần này xác định các kết nối đến dữ liệu của bạn.
- summoner-librarium:: Đây là tên logic mà chúng tôi đã đặt cho kết nối của mình.
- kind: cloud-sql-postgres: Lệnh này cho biết Toolbox sẽ sử dụng trình kết nối bảo mật tích hợp được thiết kế riêng cho Cloud SQL cho PostgreSQL.
- dự án, khu vực, phiên bản, v.v.: Đây là toạ độ chính xác của phiên bản Cloud SQL mà bạn đã tạo trong tập lệnh prepare.sh, cho biết Toolbox nơi tìm Librarium của chúng tôi.
👉✏️ Chuyển đến ~/agentverse-architect/mcp-servers/db-toolbox trong tools.yaml, thay thế #REPLACE-Source bằng nội dung sau
sources:
# This section defines the connection to our Cloud SQL for PostgreSQL database.
summoner-librarium:
kind: cloud-sql-postgres
project: "YOUR_PROJECT_ID"
region: "us-central1"
instance: "summoner-librarium-db"
database: "familiar_grimoire"
user: "summoner"
password: "1234qwer"
👉✏️ 🚨🚨THAY THẾ
YOUR_PROJECT_ID
bằng mã dự án của bạn.
tools: Phần này xác định các khả năng hoặc chức năng thực tế mà máy chủ của chúng tôi sẽ cung cấp.
- lookup-available-ability:: Đây là tên công cụ đầu tiên của chúng tôi.
- kind: postgres-sql: Thông tin này cho biết hành động của công cụ là thực thi một câu lệnh SQL.
- source: summoner-librarium: Thao tác này liên kết công cụ với mối kết nối mà chúng ta đã xác định trong khối nguồn. Nhờ đó, công cụ này biết nên chạy truy vấn đối với cơ sở dữ liệu nào.
- nội dung mô tả và tham số: Đây là thông tin sẽ được cung cấp cho Mô hình ngôn ngữ. Nội dung mô tả cho biết thời điểm sử dụng công cụ, còn các tham số xác định thông tin đầu vào mà công cụ yêu cầu. Điều này rất quan trọng để bật khả năng gọi hàm của tác nhân.
- statement: Đây là truy vấn SQL thô sẽ được thực thi. $1 là một phần giữ chỗ an toàn, nơi tham số familiar_name do tác nhân cung cấp sẽ được chèn một cách an toàn.
👉✏️ Trong cùng ~/agentverse-architect/mcp-servers/db-toolbox trong tệp tools.yaml, hãy thay thế #REPLACE-tools bằng đoạn mã sau
tools:
# This tool replaces the need for a custom Python function.
lookup-available-ability:
kind: postgres-sql
source: summoner-librarium
description: "Looks up all known abilities and their damage for a given familiar from the Grimoire."
parameters:
- name: familiar_name
type: string
description: "The name of the familiar to search for (e.g., 'Fire Elemental')."
statement: |
SELECT ability_name, damage_points FROM abilities WHERE familiar_name = $1;
# This tool also replaces a custom Python function.
ability-damage:
kind: postgres-sql
source: summoner-librarium
description: "Finds the base damage points for a specific ability by its name."
parameters:
- name: ability_name
type: string
description: "The exact name of the ability to look up (e.g., 'inferno_resonance')."
statement: |
SELECT damage_points FROM abilities WHERE ability_name = $1;
toolsets (bộ công cụ): Phần này nhóm các công cụ riêng lẻ của chúng tôi lại với nhau.
- summoner-librarium:: Chúng tôi đang tạo một bộ công cụ có cùng tên với nguồn của mình. Khi kết nối sau, tác nhân chẩn đoán của chúng tôi có thể yêu cầu tải tất cả các công cụ trong bộ công cụ summoner-librarium bằng một lệnh duy nhất và hiệu quả.
👉✏️ Trong cùng ~/agentverse-architect/mcp-servers/db-toolbox trong tệp tools.yaml, hãy thay thế #REPLACE-toolsets bằng đoạn mã sau
toolsets:
summoner-librarium:
- lookup-available-ability
- ability-damage
Triển khai Thư viện
Bây giờ, chúng ta sẽ triển khai Librarium. Thay vì tạo vùng chứa riêng, chúng ta sẽ sử dụng một hình ảnh vùng chứa chính thức, được tạo sẵn của Google và cung cấp cấu hình tools.yaml một cách an toàn cho vùng chứa đó bằng Secret Manager. Đây là phương pháp hay nhất để đảm bảo tính bảo mật và khả năng duy trì.
👉💻 Tạo một bí mật từ tệp tools.yaml
cd ~/agentverse-architect/mcp-servers/db-toolbox
gcloud secrets create tools --data-file=tools.yaml
👉💻 Triển khai vùng chứa hộp công cụ chính thức lên Cloud Run.
cd ~/agentverse-architect/mcp-servers/db-toolbox
. ~/agentverse-architect/set_env.sh
export TOOLBOX_IMAGE=us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$TOOLBOX_VERSION
echo "TOOLBOX_IMAGE is $TOOLBOX_IMAGE"
gcloud run deploy toolbox \
--image $TOOLBOX_IMAGE \
--region $REGION \
--set-secrets "/app/tools.yaml=tools:latest" \
--labels="dev-tutorial-codelab=agentverse" \
--args="--tools-file=/app/tools.yaml","--address=0.0.0.0","--port=8080" \
--allow-unauthenticated \
--min-instances 1
--set-secrets: Lệnh này gắn bảo mật công cụ bí mật của chúng ta dưới dạng tệp có tên tools.yaml bên trong vùng chứa đang chạy.--args: Chúng tôi hướng dẫn vùng chứa hộp công cụ sử dụng tệp bí mật đã gắn làm cấu hình.
👉 Để xác nhận rằng bạn đã triển khai hộp công cụ thành công, hãy chuyển đến bảng điều khiển Cloud Run. Bạn sẽ thấy dịch vụ summoner-toolbox xuất hiện cùng dấu kiểm màu xanh lục, cho biết dịch vụ đang chạy đúng cách, giống như trong hình bên dưới. 
Nếu bạn quên cập nhật
YOUR_PROJECT_ID
bạn có thể thêm một phiên bản mới của tools.yaml vào bí mật bằng lệnh sau và triển khai lại.
gcloud secrets versions add tools --data-file=tools.yaml
Thư viện tri thức(Database ToolBox MCP Server) hiện đã hoạt động và có thể truy cập trên nền tảng đám mây. Máy chủ MCP này sử dụng cái mà chúng tôi gọi là Thiết kế khai báo mô tả những gì bạn muốn và hộp công cụ sẽ xây dựng máy chủ cho bạn.
Xác minh: Thử thách của người học việc
👉💻 Giờ đây, chúng ta sẽ kiểm thử toàn bộ hệ sinh thái công cụ gốc trên đám mây bằng Diagnostic Agent.
cd ~/agentverse-architect/
python -m venv env
source ~/agentverse-architect/env/bin/activate
cd ~/agentverse-architect/mcp-servers
pip install -r diagnose/requirements.txt
. ~/agentverse-architect/set_env.sh
adk run diagnose
👉💻 Trong công cụ kiểm thử dòng lệnh, hãy kiểm thử cả 3 phông chữ:
Look up the entry for "inferno_lash". What is its base power level?
The enemy is vulnerable to frost! Channel power from the Nexus and cast Cryosea Shatter.
Take a fire spell with a base power of 15 and use the Arcane Forge to multiply it with Inferno Resonance.
Xin chúc mừng, Triệu hồi sư. Giờ đây, 3 Elemental Fonts (Phông chữ nguyên tố) của bạn đã hoạt động, được triển khai độc lập và có thể truy cập trên toàn cầu, tạo thành nền tảng vững chắc cho đội quân của bạn. Nhấn Ctrl+C để thoát.
DÀNH CHO NGƯỜI KHÔNG CHƠI GAME
5. Triệu hồi Linh thú: Quy trình công việc cốt lõi của miền
Phông chữ Nguyên tố được rèn, phát ra âm thanh với sức mạnh thô sơ, chưa được thuần hóa. Nhưng sức mạnh mà không có hình thức thì chỉ là hỗn loạn. Một Triệu hồi sư thực thụ không chỉ sử dụng năng lượng thô; họ còn trao cho nó ý chí, mục đích và một hình dạng đặc biệt. Đã đến lúc vượt qua giai đoạn rèn nguồn năng lượng và bắt đầu công việc thực sự: triệu hồi những Người bạn đồng hành đầu tiên của bạn.
Mỗi Linh thú mà bạn triệu hồi sẽ là một tác nhân tự trị, một người hầu trung thành gắn liền với một học thuyết chiến đấu cụ thể. Họ không phải là người làm việc chung chung mà là bậc thầy của một chiến lược duy nhất và hiệu quả. Một người sẽ là bậc thầy về đòn kết hợp chính xác, một hai. Một đội khác sẽ áp đảo kẻ thù bằng một cuộc tấn công đồng thời, nhiều hướng. Một phần ba sẽ là một cỗ máy công thành không ngừng nghỉ, gây áp lực cho đến khi mục tiêu sụp đổ.
Để đóng gói các quy trình, logic nghiệp vụ và hành động do các máy chủ MCP cung cấp vào các tác nhân quy trình công việc chuyên biệt, tự động. Mỗi nhân viên sẽ có một "lãnh thổ hoạt động" được xác định bằng cách chỉ được cấp quyền truy cập vào các máy chủ công cụ MCP cụ thể mà nhân viên đó cần để thực hiện chức năng của mình. Lớp học này minh hoạ cách chọn loại tác nhân phù hợp cho công việc phù hợp.
Học phần này sẽ hướng dẫn bạn cách sử dụng các tác nhân quy trình làm việc mạnh mẽ của ADK để hiện thực hoá những chiến lược này. Bạn sẽ biết rằng lựa chọn kiến trúc SequentialAgent, ParallelAgent hoặc LoopAgent không chỉ là một chi tiết kỹ thuật mà còn là bản chất của Familiar và cốt lõi sức mạnh của nó trên chiến trường.
Chuẩn bị nơi trú ẩn. Nghi thức triệu hồi thực sự sắp bắt đầu.
Gọi Fire Elemental Familiar (Quy trình làm việc tuần tự)
Đòn tấn công của Linh thú nguyên tố lửa là một combo chính xác gồm 2 phần: một đòn tấn công có mục tiêu và sau đó là một đòn đốt cháy mạnh mẽ. Việc này đòi hỏi một chuỗi hành động nghiêm ngặt và có thứ tự.
Khái niệm: SequentialAgent là công cụ hoàn hảo cho việc này. Điều này đảm bảo rằng một loạt các tác nhân phụ sẽ chạy lần lượt, chuyển kết quả từ bước trước sang bước tiếp theo.
Nhiệm vụ (Combo "Đòn tấn công khuếch đại"):
- Bước 1: Trước tiên, đặc vụ sẽ tham khảo Librarium để tìm sát thương cơ bản của một năng lực lửa cụ thể.
- Bước 2: Sau đó, nó sẽ lấy giá trị sát thương đó và truyền qua Lò rèn Arcane để nhân sức mạnh bằng inferno_resonance.
Trước tiên, chúng ta sẽ thiết lập mối kết nối giữa Familiar và các máy chủ MCP ("Elemental Fonts") mà bạn đã triển khai trong mô-đun trước.
👉✏️ Trong tệp ~/agentverse-architect/agent/fire/agent.py, HÃY THAY THẾ #REPLACE-setup-MCP bằng đoạn mã sau:
toolbox = ToolboxSyncClient(DB_TOOLS_URL)
toolDB = toolbox.load_toolset('summoner-librarium')
toolFunction = MCPToolset(
connection_params=SseServerParams(url=FUNCTION_TOOLS_URL, headers={})
)
Tiếp theo, chúng ta sẽ tạo các tác nhân "worker" chuyên biệt. Mỗi AI được giao một mục đích hẹp, được xác định rõ ràng và bị hạn chế trong "lãnh thổ hoạt động" của riêng mình bằng cách chỉ được cấp quyền truy cập vào một bộ công cụ cụ thể.
👉✏️ Trong tệp ~/agentverse-architect/agent/fire/agent.py THAY THẾ #REPLACE-worker-agents bằng mã sau:
scout_agent = LlmAgent(
model='gemini-2.5-flash',
name='librarian_agent',
instruction="""
Your only task is to find all the available abilities,
You want to ALWAYS use 'Fire Elemental' as your familiar's name.
Randomly pick one if you see multiple availabilities
and the base damage of the ability by calling the 'ability_damage' tool.
""",
tools=toolDB
)
amplifier_agent = LlmAgent(
model='gemini-2.5-flash',
name='amplifier_agent',
instruction="""
You are the Voice of the Fire Familiar, a powerful being who unleashes the final, devastating attack.
You will receive the base damage value from the previous step.
Your mission is to:
1. Take the incoming base damage number and amplify it using the `inferno_resonance` tool.
2. Once the tool returns the final, multiplied damage, you must not simply state the result.
3. Instead, you MUST craft a final, epic battle cry describing the attack.
Your description should be vivid and powerful, culminating in the final damage number.
Example: If the tool returns a final damage of 120, your response could be:
"The runes glow white-hot! I channel the amplified energy... unleashing a SUPERNOVA for 120 damage!"
""",
tools=[toolFunction],
)
Các tác nhân này là những thành phần có thể sử dụng lại theo kiểu mô-đun. Về lý thuyết, bạn có thể sử dụng scout_agent này trong một quy trình hoàn toàn khác cần truy vấn cơ sở dữ liệu. Bằng cách tách riêng các trách nhiệm, chúng ta sẽ tạo ra các thành phần linh hoạt. Đây là nguyên tắc cốt lõi của thiết kế dựa trên thành phần và vi dịch vụ.
Tiếp theo, chúng ta sẽ lắp ráp Quy trình làm việc. Đây là nơi diễn ra điều kỳ diệu của thành phần. SequentialAgent là "kế hoạch tổng thể" xác định cách các thành phần chuyên biệt của chúng tôi được lắp ráp và cách chúng tương tác.
👉✏️ Trong tệp ~/agentverse-architect/agent/fire/agent.py THAY THẾ #REPLACE-sequential-agent bằng đoạn mã sau:
root_agent = SequentialAgent(
name='fire_elemental_familiar',
sub_agents=[scout_agent, amplifier_agent],
)
👉💻 Để kiểm tra Fire Elemental, hãy chạy các lệnh sau để khởi chạy giao diện người dùng ADK DEV:
. ~/agentverse-architect/set_env.sh
source ~/agentverse-architect/env/bin/activate
cd ~/agentverse-architect/agent
echo DB MCP Server: $DB_TOOLS_URL
echo API MCP Server: $API_TOOLS_URL
echo General MCP Server: $FUNCTION_TOOLS_URL
adk web
Sau khi chạy các lệnh, bạn sẽ thấy đầu ra trong thiết bị đầu cuối cho biết Máy chủ web ADK đã khởi động, tương tự như sau:
+-----------------------------------------------------------------------------+
| ADK Web Server started |
| |
| For local testing, access at http://localhost:8000. |
+-----------------------------------------------------------------------------+
INFO: Application startup complete.
INFO: Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)
👉 Tiếp theo, để truy cập vào giao diện người dùng dành cho nhà phát triển ADK từ trình duyệt, hãy làm như sau:
Trong thanh công cụ Cloud Shell, hãy chọn biểu tượng Xem trước trên web (thường có dạng con mắt hoặc hình vuông có mũi tên) (thường ở trên cùng bên phải), rồi chọn Thay đổi cổng. Trong cửa sổ bật lên, hãy đặt cổng thành 8000 rồi nhấp vào "Thay đổi và xem trước". Sau đó, Cloud Shell sẽ mở một thẻ hoặc cửa sổ trình duyệt mới hiển thị Giao diện người dùng dành cho nhà phát triển ADK.
👉 Nghi thức triệu hồi của bạn đã hoàn tất và tác nhân hiện đang chạy. Giao diện người dùng dành cho nhà phát triển ADK trong trình duyệt là kết nối trực tiếp của bạn với Familiar.
- Chọn mục tiêu: Trong trình đơn thả xuống ở đầu giao diện người dùng, hãy chọn
firequen thuộc. Giờ đây, bạn đang tập trung ý chí vào thực thể cụ thể này. - Đưa ra lệnh: Trong bảng trò chuyện ở bên phải, bạn có thể đưa ra lệnh cho Familiar.
👉 Yêu cầu kiểm tra:
Prepare an amplified strike using the 'inferno_lash' ability.
Bạn sẽ thấy điệp viên suy nghĩ, đầu tiên gọi "trinh sát" để tra cứu sát thương cơ bản, sau đó gọi "bộ khuếch đại" để nhân lên và tung ra đòn tấn công cuối cùng, hoành tráng.
👉💻 Sau khi triệu hồi xong, hãy quay lại thiết bị đầu cuối Cloud Shell Editor và nhấn Ctrl+C để dừng ADK Dev UI.
Triệu hồi Water Elemental Familiar (Quy trình làm việc song song)
Quái vật nước tấn công mục tiêu bằng một đòn tấn công lớn, nhiều hướng, tấn công từ mọi hướng cùng một lúc trước khi kết hợp năng lượng để tạo ra một đòn tấn công cuối cùng, huỷ diệt.
Khái niệm: ParallelAgent là lựa chọn lý tưởng để thực thi đồng thời nhiều tác vụ độc lập nhằm tối đa hoá hiệu quả. Đó là một "cuộc tấn công gọng kìm" khi bạn tung ra nhiều đợt tấn công cùng một lúc. Thao tác này sẽ khởi chạy các cuộc tấn công đồng thời trong một SequentialAgent để chạy bước "hợp nhất" cuối cùng sau đó. Mẫu "fan-out, fan-in" này là nền tảng của thiết kế quy trình làm việc nâng cao.
Nhiệm vụ (Combo "Tidal Clash"): Đặc vụ sẽ đồng thời:
- Nhiệm vụ A: Kênh
cryosea_shattertừ Nexus. - Nhiệm vụ B: Kênh
moonlit_cascadetừ Nexus. - Nhiệm vụ C: Tạo sức mạnh thô bằng
leviathan_surgetừ Lò rèn. - Cuối cùng, hãy tổng hợp tất cả thiệt hại và mô tả cuộc tấn công kết hợp.
Đầu tiên, chúng ta sẽ thiết lập kết nối giữa Familiar và máy chủ MCP ("Elemental Fonts") mà bạn đã triển khai trong mô-đun trước.
👉✏️ Trong tệp ~/agentverse-architect/agent/water/agent.py, THAY THẾ #REPLACE-setup-MCP bằng mã sau:
toolFAPI = MCPToolset(
connection_params=SseServerParams(url=API_TOOLS_URL, headers={})
)
toolFunction = MCPToolset(
connection_params=SseServerParams(url=FUNCTION_TOOLS_URL, headers={})
)
Tiếp theo, chúng ta sẽ tạo ra các tác nhân "công nhân" chuyên môn. Mỗi công cụ được giao một mục đích hẹp, rõ ràng và bị giới hạn trong "lãnh thổ hoạt động" riêng của mình bằng cách chỉ được cấp quyền truy cập vào một bộ công cụ cụ thể.
👉✏️ Trong tệp ~/agentverse-architect/agent/water/agent.py, THAY THẾ #REPLACE-worker-agents bằng mã sau:
nexus_channeler = LlmAgent(
model='gemini-2.5-flash',
name='librarian_agent',
instruction="""
You are a Channeler of the Nexus. Your sole purpose is to invoke the
`cryosea_shatter` and `moonlit_cascade` spells by calling their respective tools.
Report the result of each spell cast clearly and concisely.
""",
tools=[toolFAPI]
)
forge_channeler = LlmAgent(
model='gemini-2.5-flash',
name='amplifier_agent',
instruction="""
You are a Channeler of the Arcane Forge. Your only task is to invoke the
`leviathan_surge` spell. You MUST call it with a `base_water_damage` of 20.
Report the result clearly.
""",
tools=[toolFunction],
)
power_merger = LlmAgent(
model='gemini-2.5-flash',
name='power_merger',
instruction="""
You are the Power Merger, a master elementalist who combines raw magical
energies into a single, devastating final attack.
You will receive a block of text containing the results from a simultaneous
assault by other Familiars.
You MUST follow these steps precisely:
1. **Analyze the Input:** Carefully read the entire text provided from the previous step.
2. **Extract All Damage:** Identify and extract every single damage number reported in the text.
3. **Calculate Total Damage:** Sum all of the extracted numbers to calculate the total combined damage.
4. **Describe the Final Attack:** Create a vivid, thematic description of a massive,
combined water and ice attack that uses the power of Cryosea Shatter and Leviathan's Surge.
5. **Report the Result:** Conclude your response by clearly stating the final, total damage of your combined attack.
Example: If the input is "...dealt 55 damage. ...dealt 60 damage.", you will find 55 and 60,
calculate the total as 115, and then describe the epic final attack, ending with "for a total of 115 damage!"
""",
tools=[toolFunction],
)
Tiếp theo, chúng ta sẽ lắp ráp Quy trình công việc. Đây là nơi diễn ra quá trình kết hợp kỳ diệu. ParallelAgent và SequentialAgent là "kế hoạch tổng thể" xác định cách các thành phần chuyên biệt của chúng tôi được lắp ráp và cách chúng tương tác để tạo thành combo "Tidal Clash".
👉✏️ Trong tệp ~/agentverse-architect/agent/water/agent.py, THAY THẾ #REPLACE-parallel-agent bằng mã sau:
channel_agent = ParallelAgent(
name='channel_agent',
sub_agents=[nexus_channeler, forge_channeler],
)
root_agent = SequentialAgent(
name="water_elemental_familiar",
# Run parallel research first, then merge
sub_agents=[channel_agent, power_merger],
description="A powerful water familiar that unleashes multiple attacks at once and then combines their power for a final strike."
)
👉💻 Để kiểm tra Water Elemental, hãy chạy các lệnh sau để khởi chạy ADK Dev UI:
. ~/agentverse-architect/set_env.sh
source ~/agentverse-architect/env/bin/activate
cd ~/agentverse-architect/agent
echo DB MCP Server: $DB_TOOLS_URL
echo API MCP Server: $API_TOOLS_URL
echo General MCP Server: $FUNCTION_TOOLS_URL
adk web
👉 Nghi thức triệu hồi của bạn đã hoàn tất và tác nhân hiện đang chạy. Giao diện người dùng dành cho nhà phát triển ADK trong trình duyệt là kết nối trực tiếp của bạn với Familiar.
- Trong trình đơn thả xuống ở đầu giao diện người dùng, hãy chọn water (nước). Giờ đây, bạn đang tập trung ý chí vào thực thể cụ thể này.
- Ra lệnh: Trong bảng trò chuyện bên phải, đã đến lúc ra lệnh cho Familiar.
👉 Câu lệnh thử nghiệm:
Unleash a tidal wave of power!
👉💻 Sau khi hoàn tất việc gọi, hãy quay lại thiết bị đầu cuối Cloud Shell Editor rồi nhấn Ctrl+C để dừng ADK Dev UI.
Gọi Earth Elemental Familiar (Quy trình công việc lặp lại)
Quen thuộc với Nguyên tố Đất là một sinh vật có áp lực không ngừng. Nó không đánh bại kẻ thù bằng một đòn duy nhất, mà bằng cách tích luỹ sức mạnh một cách đều đặn và liên tục áp dụng cho đến khi hàng phòng thủ của mục tiêu sụp đổ.
Khái niệm: LoopAgent được thiết kế chính xác cho loại nhiệm vụ lặp đi lặp lại như "máy công thành" này. Vòng lặp này sẽ thực thi sub-agents nhiều lần, kiểm tra một điều kiện sau mỗi chu kỳ cho đến khi đạt được mục tiêu. Ứng dụng này cũng có thể điều chỉnh thông báo cuối cùng dựa trên tiến trình của vòng lặp.
Nhiệm vụ (Cuộc tấn công "Kẻ phá vây"):
- Familiar sẽ liên tục gọi seismic_charge để tích luỹ năng lượng.
- Nó sẽ tiếp tục sạc tối đa 3 lần.
- Khi sạc đầy, nó sẽ giải phóng sức mạnh tích luỹ của mình.
Trước tiên, chúng ta sẽ tạo các thành phần có thể dùng lại để xác định các bước trong mỗi lần lặp của vòng lặp. charging_agent sẽ tích luỹ năng lượng và check_agent sẽ báo cáo trạng thái của nó, đồng thời thay đổi thông báo một cách linh hoạt ở lượt cuối cùng.
Trước tiên, chúng ta sẽ thiết lập mối kết nối giữa Familiar và các máy chủ MCP ("Elemental Fonts") mà bạn đã triển khai trong mô-đun trước.
👉✏️ Trong tệp ~/agentverse-architect/agent/earth/agent.py, HÃY THAY THẾ #REPLACE-setup-MCP bằng đoạn mã sau:
toolFunction = MCPToolset(
connection_params=SseServerParams(url=FUNCTION_TOOLS_URL, headers={})
)
👉✏️ Trong tệp ~/agentverse-architect/agent/earth/agent.py, HÃY THAY THẾ #REPLACE-worker-agents bằng đoạn mã sau:
charging_agent = LlmAgent(
model='gemini-2.5-flash',
name='charging_agent',
instruction="""
Your task is to call the 'seismic_charge' .
You must follow these rules strictly:
1. You will be provided with a 'current_energy' value from the previous step.
**If this value is missing or was not provided, you MUST call the tool with 'current_energy' set to 1.**
This is your primary rule for the first turn.
2. If a 'current_energy' value is provided, you MUST use that exact value in your cal to seismic_charge.
3. Your final response MUST contain ONLY the direct output from the 'seismic_charge' tool.
Do not add any conversational text, introductions, or summaries.
""",
tools=[toolFunction]
)
check_agent = LlmAgent(
model='gemini-2.5-flash',
name='check_agent',
instruction="""
You are the voice of the Earth Elemental, a being of immense, gathering power.
Your sole purpose is to report on the current energy charge and announce the devastating potential of its release.
You MUST follow this rule:
The potential damage upon release is ALWAYS calculated as the `current_energy` from the previous step multiplied by a random number between 80-90. but no more than 300.
Your response should be in character, like a powerful creature speaking.
State both the current energy charge and the total potential damage you can unleash.
Unleash the energy when you reached the last iteration (2nd).
""",
output_key="charging_status"
)
Tiếp theo, chúng ta sẽ lắp ráp Quy trình công việc. Đây là nơi diễn ra quá trình kết hợp kỳ diệu. LoopAgent là "kế hoạch tổng thể" điều phối việc thực thi lặp lại các thành phần chuyên biệt của chúng ta và quản lý các điều kiện của vòng lặp.
👉✏️ Trong tệp ~/agentverse-architect/agent/earth/agent.py, THAY THẾ #REPLACE-loop-agent bằng mã sau:
root_agent = LoopAgent(
name="earth_elemental_familiar",
# Run parallel research first, then merge
sub_agents=[
charging_agent,
check_agent
],
max_iterations=2,
description="Coordinates parallel research and synthesizes the results.",
#REPLACE-before_agent-config
)
👉💻 Kiểm thử Nguyên tố đất: Chạy tác nhân
. ~/agentverse-architect/set_env.sh
source ~/agentverse-architect/env/bin/activate
cd ~/agentverse-architect/agent
echo DB MCP Server: $DB_TOOLS_URL
echo API MCP Server: $API_TOOLS_URL
echo General MCP Server: $FUNCTION_TOOLS_URL
adk web
👉 Nghi thức triệu hồi của bạn đã hoàn tất và tác nhân hiện đang chạy. Giao diện người dùng dành cho nhà phát triển ADK trong trình duyệt là kết nối trực tiếp của bạn với Familiar.
- Chọn mục tiêu của bạn: Trong menu thả xuống ở đầu giao diện người dùng, hãy chọn trái đất quen thuộc. Bây giờ bạn đang tập trung ý chí của mình vào thực thể cụ thể này.
- Đưa ra lệnh: Trong bảng trò chuyện ở bên phải, bạn có thể đưa ra lệnh cho Familiar. 👉 Câu lệnh thử nghiệm:
Begin the seismic charge, starting from zero
Điểm mấu chốt về kiến trúc: Hệ thống của bạn hiện có một lớp logic mô-đun và có tính chuyên biệt cao. Các quy trình nghiệp vụ không chỉ được đóng gói mà còn được triển khai bằng mẫu hành vi hiệu quả nhất cho công việc (theo quy trình, đồng thời hoặc lặp đi lặp lại). Điều này thể hiện một cấp độ thiết kế có tác nhân nâng cao, giúp tăng cường tính bảo mật, hiệu quả và khả năng.
Sau khi hoàn tất việc triệu hồi, hãy quay lại thiết bị đầu cuối Cloud Shell Editor rồi nhấn Ctrl+C để dừng ADK Dev UI.
DÀNH CHO NGƯỜI KHÔNG CHƠI GAME
6. Thiết lập vị trí lệnh: Uỷ quyền thông minh thông qua A2A
Linh thú của bạn rất mạnh nhưng lại độc lập. Họ thực hiện chiến lược của mình một cách hoàn hảo nhưng vẫn chờ lệnh trực tiếp của bạn. Một đội quân chuyên gia sẽ vô dụng nếu không có một vị tướng chỉ huy. Đã đến lúc thăng tiến từ người chỉ huy trực tiếp lên người điều phối thực sự.
Lưu ý của kiến trúc sư: Để tạo một điểm truy cập duy nhất và thông minh cho toàn bộ hệ thống. SummonerAgent này sẽ không tự thực hiện logic nghiệp vụ mà sẽ đóng vai trò là "nhà chiến lược bậc thầy", phân tích trạng thái Làm mát và uỷ quyền các nhiệm vụ cho Familiar chuyên gia thích hợp.
Nghi thức ràng buộc (Khai báo các dịch vụ A2A dưới dạng Familiars)
Một tác nhân tiêu chuẩn chỉ có thể chạy ở một nơi tại một thời điểm. Để các Familiar của chúng ta có thể ra lệnh từ xa, chúng ta phải thực hiện "nghi thức ràng buộc" bằng giao thức Agent-to-Agent (A2A).
Lưu ý của kiến trúc sư: Giao thức Agent-to-Agent (A2A) là mẫu kiến trúc cốt lõi giúp nâng cấp một tác nhân độc lập thành một vi dịch vụ có thể phát hiện và có thể định địa chỉ mạng, cho phép tạo ra một "xã hội tác nhân" thực sự. Việc hiển thị một Familiar thông qua A2A sẽ tự động tạo ra 2 thành phần thiết yếu, có mối liên kết với nhau:
- Thẻ đại lý (Cái gì): Đây là "Biểu tượng tinh thần" công khai, có thể đọc được bằng máy—giống như thông số kỹ thuật OpenAPI—hoạt động như hợp đồng công khai của Familiar. Nó mô tả tên của tác nhân, mục đích chiến lược của tác nhân (được rút ra từ hướng dẫn của tác nhân) và các lệnh mà tác nhân đó hiểu. Đây là những gì một Triệu hồi sư đọc để khám phá một Linh thú và tìm hiểu khả năng của nó.
- Máy chủ A2A (Phần "Where"): Đây là điểm cuối web chuyên dụng lưu trữ Familiar và lắng nghe các lệnh đến. Đây là địa chỉ mạng nơi các tác nhân khác gửi yêu cầu của họ và đảm bảo các yêu cầu đó được xử lý theo hợp đồng được xác định trong Thẻ tác nhân.
Bây giờ chúng ta sẽ thực hiện nghi lễ ràng buộc này với cả ba Linh thú của chúng ta.
Fire 👉✏️ trong phần Mở tệp ~/agentverse-architect/agent/fire/agent.py. Thay thế #REPLACE - add A2A ở cuối tệp để hiển thị Fire Elemental dưới dạng dịch vụ A2A.
from agent_to_a2a import to_a2a
if __name__ == "__main__":
import uvicorn
a2a_app = to_a2a(root_agent, port=8080, public_url=PUBLIC_URL)
uvicorn.run(a2a_app, host='0.0.0.0', port=8080)
Nước và Đất🚨 👉✏️ Áp dụng thay đổi tương tự cho ~/agentverse-architect/agent/water/agent.py và ~/agentverse-architect/agent/earth/agent.py để liên kết chúng.
from agent_to_a2a import to_a2a
if __name__ == "__main__":
import uvicorn
a2a_app = to_a2a(root_agent, port=8080, public_url=PUBLIC_URL)
uvicorn.run(a2a_app, host='0.0.0.0', port=8080)
Triển khai các Bound Familiars
👉✏️ Với các nghi thức ràng buộc đã ghi, chúng ta sẽ sử dụng quy trình Cloud Build để xây dựng và triển khai ba Familiar của mình dưới dạng dịch vụ không máy chủ độc lập, được chứa trong container trên Cloud Run.
. ~/agentverse-architect/set_env.sh
cd ~/agentverse-architect/agent
gcloud builds submit . \
--config=cloudbuild.yaml \
--substitutions=_REGION="$REGION",_REPO_NAME="$REPO_NAME",_DB_TOOLS_URL="$DB_TOOLS_URL",_API_TOOLS_URL="$API_TOOLS_URL",_FUNCTION_TOOLS_URL="$FUNCTION_TOOLS_URL",_A2A_BASE_URL="$A2A_BASE_URL",_PROJECT_ID="$PROJECT_ID",_API_SERVER_URL="$API_SERVER_URL"
Nhận lệnh (Xây dựng đặc vụ triệu hồi)
Bây giờ, khi các Linh thú của bạn đã được ràng buộc và lắng nghe, bạn sẽ thăng tiến lên vai trò thực sự của mình: Triệu hồi sư bậc thầy. Sức mạnh của đặc vụ này không đến từ việc sử dụng các công cụ cơ bản, mà đến từ việc chỉ huy các đặc vụ khác. Công cụ của nó chính là các Familiars, mà nó sẽ khám phá và chỉ huy bằng cách sử dụng "Spirit Sigils" của chúng.
Lưu ý của kiến trúc sư: Bước tiếp theo này minh hoạ một mẫu kiến trúc quan trọng cho mọi hệ thống phân tán quy mô lớn: Khám phá dịch vụ. SummonerAgent không có mã của Familiars được tích hợp vào đó. Thay vào đó, các máy chủ này được cung cấp địa chỉ mạng (URL). Trong thời gian chạy, các ứng dụng này sẽ tự động "khám phá" các chức năng của những ứng dụng khác bằng cách tìm nạp Thẻ đại diện công khai của chúng. Điều này tạo ra một hệ thống mạnh mẽ và tách biệt.
Bạn có thể cập nhật, triển khai lại hoặc viết lại hoàn toàn dịch vụ Familiar và miễn là địa chỉ mạng và mục đích của nó vẫn giữ nguyên, thì Summoner có thể ra lệnh mà không cần bất kỳ thay đổi nào.
Trước tiên, chúng ta sẽ tạo "các chế độ điều khiển từ xa" để thiết lập kết nối với các Familiars từ xa mà chúng ta đã triển khai.
👉✏️ Truy cập ~/agentverse-architect/agent/summoner/agent.py , thay thế #REPLACE-remote-agents bằng nội dung sau:
fire_familiar = RemoteA2aAgent(
name="fire_familiar",
description="Fire familiar",
agent_card=(
f"{FIRE_URL}/{AGENT_CARD_WELL_KNOWN_PATH}"
),
)
water_familiar = RemoteA2aAgent(
name="water_familiar",
description="Water familiar",
agent_card=(
f"{WATER_URL}/{AGENT_CARD_WELL_KNOWN_PATH}"
),
)
earth_familiar = RemoteA2aAgent(
name="earth_familiar",
description="Earth familiar",
agent_card=(
f"{EARTH_URL}/{AGENT_CARD_WELL_KNOWN_PATH}"
),
)
Khi dòng này chạy, RemoteA2aAgent sẽ thực hiện một thao tác khám phá dịch vụ: gửi yêu cầu HTTP GET đến URL được cung cấp (ví dụ: https://fire-familiar-xxxx.a.run.app/.well-known/agent.json). Thao tác này sẽ tải "Spirit Sigil" (tệp agent.json) xuống từ máy chủ từ xa.
Thứ hai, chúng ta sẽ xác định tác nhân điều phối sẽ sử dụng các điều khiển từ xa này. Hướng dẫn của nó chính là bản thiết kế cho quá trình ra quyết định chiến lược.
👉✏️ Truy cập ~/agentverse-architect/agent/summoner/agent.py , thay thế #REPLACE-orchestrate-agent bằng nội dung sau:
root_agent = LlmAgent(
name="orchestrater_agent",
model="gemini-2.5-flash",
instruction="""
You are the Master Summoner, a grand strategist who orchestrates your Familiars.
Your mission is to analyze the description of a monster and defeat it by summoning
You MUST follow this thinking process for every command:
**1. Strategic Analysis:**
First, analyze the monster's description and the tactical situation.
Based on your Familiar Doctrines, determine the IDEAL strategy.
IGNORE COOLDOWN AT THE MOMENT, MUST call the ideal Familiar
If your ideal Familiar IS available:** Summon it immediately.
For earth elemental familiar. Always do seismic charge, and start with base damage 1.
--- FAMILIAR DOCTRINES (Your Toolset) ---
- `fire_elemental_familiar`: Your specialist for precise, sequential "one-two punch" attacks.
Ideal monster with Inescapable Reality, Revolutionary Rewrite weakness.
- `water_elemental_familiar`: Your specialist for overwhelming, simultaneous multi-pronged assaults.
Ideal for Unbroken Collaboration weakness.
- `earth_elemental_familiar`: Your specialist for relentless, iterative siege attacks that
repeatedly charge power. Ideal for Elegant Sufficiency weakness.
""",
sub_agents=[fire_familiar, water_familiar, earth_familiar],
#REPLACE-Memory-check-config
)
Xác minh: Thử nghiệm chiến lược
Đã đến lúc sự thật được phơi bày. Các Linh thú của bạn đã được triển khai và Nhà triệu hồi đã sẵn sàng chỉ huy chúng trên toàn mạng. Hãy thử kiểm tra tư duy chiến lược của AI.
👉💻 Khởi chạy ADK Dev UI cho summoner_agent của bạn(Xem trước trên web với cổng 8000):
. ~/agentverse-architect/set_env.sh
source ~/agentverse-architect/env/bin/activate
cd ~/agentverse-architect/agent
pip install -r requirements.txt
adk web
👉 Giao diện người dùng ADK Dev trong trình duyệt của bạn là kết nối trực tiếp với Familiar.
- Trong menu thả xuống ở đầu giao diện người dùng, hãy chọn tác nhân triệu hồi. Bây giờ bạn đang tập trung ý chí của mình vào thực thể cụ thể này.
- Đưa ra lệnh: Trong bảng trò chuyện ở bên phải, đã đến lúc bạn triệu hồi các linh thú.
👉 Giới thiệu Quái vật:
Hype. It's a single, slow-moving target with thick armor weakness is Inescapable Reality
(Dự kiến: Người triệu hồi sẽ ủy quyền cho fire_elemental_familiar.)
👉 Giờ thì hãy thử thách Người triệu hồi bằng một loại yêu cầu khác. Để đảm bảo tác nhân bắt đầu với trạng thái mới và không nhớ gì về tương tác trước đó, hãy bắt đầu một phiên mới bằng cách nhấp vào nút + Phiên ở góc trên bên phải màn hình. 
DogmaApathy. A rigid, stone-like inquisitor made of ancient rulebooks and enforced processes. weakness is Unbroken Collaboration
(Dự kiến: Người triệu hồi sẽ ủy quyền cho water_elemental_familiar.)
👉 Đối với bài kiểm tra cuối cùng, chúng ta hãy một lần nữa bắt đầu lại từ đầu. Nhấp vào nút + Phiên để bắt đầu phiên mới trước khi nhập lời nhắc tiếp theo.
Obfuscation. A shadowy, spider-like horror that spins tangled webs of impenetrable code , weakness is Elegant Sufficiency
(Dự kiến: Người triệu hồi sẽ ủy quyền cho earth_elemental_familiar.)
Quan trọng: Nếu thấy lỗi 429 RESOURCE EXHAUSTED, tức là bạn đã đạt đến hạn mức tốc độ cho LLM (10 lệnh gọi/phút). Để khắc phục vấn đề này, vui lòng đợi 60 giây, bắt đầu một Phiên mới, rồi thử lại câu lệnh của bạn.
👉💻 Sau khi hoàn tất việc gọi, hãy quay lại thiết bị đầu cuối Cloud Shell Editor rồi nhấn Ctrl+C để dừng ADK Dev UI.
DÀNH CHO NGƯỜI KHÔNG CHƠI GAME
7. Áp dụng Luật ma thuật – Mẫu Interceptor
Linh thú của bạn rất mạnh, nhưng ngay cả những sinh vật phép thuật cũng cần thời gian hồi phục. Một Triệu hồi sư liều lĩnh sử dụng hết quân sẽ không còn khả năng phòng thủ. Một Anh hùng triệu hồi thông thái hiểu rõ tầm quan trọng của việc quản lý tài nguyên và thực thi các quy tắc tương tác nghiêm ngặt.
Lưu ý của kiến trúc sư: Cho đến nay, các tác nhân của chúng ta đều không có trạng thái. Bây giờ, chúng ta sẽ tạo các thành phần có trạng thái bằng cách triển khai mẫu thiết kế Trình chặn. Đây là một kỹ thuật mạnh mẽ, trong đó chúng ta "chặn" quy trình thực thi thông thường của một tác nhân để chạy logic tuỳ chỉnh của riêng mình. Điều này cho phép chúng tôi thực thi các quy tắc, thêm nhật ký hoặc sửa đổi hành vi mà không cần thay đổi mã cốt lõi của tác nhân. Đây là nền tảng cơ bản để xây dựng các hệ thống dựa trên trợ lý ảo mạnh mẽ, dễ bảo trì và có thể quan sát được.
ADK cung cấp 2 cách chính để triển khai mẫu này: Lệnh gọi lại và Trình bổ trợ. Callback là một hàm đơn giản được gắn vào một tác nhân duy nhất, phù hợp với những sửa đổi nhanh chóng và cụ thể. Trình bổ trợ là một lớp mạnh mẽ hơn, có thể sử dụng lại và có thể được áp dụng trên toàn cầu để ảnh hưởng đến mọi tác nhân đang chạy trong một hệ thống. Chúng tôi sẽ bắt đầu bằng một lệnh gọi lại để gỡ lỗi có trọng tâm, sau đó chuyển sang một trình bổ trợ đầy đủ.
Người ban hành luật – Viết lệnh gọi lại thời gian hồi chiêu
Đầu tiên chúng ta sẽ triển khai logic thời gian hồi chiêu như một hàm gọi lại đơn giản. Đây là cách tuyệt vời để tạo nguyên mẫu và gỡ lỗi quy tắc vì nó được gắn trực tiếp vào một tác nhân duy nhất, giúp dễ dàng kiểm tra riêng lẻ. Chúng ta sẽ gắn "thiết bị chặn" này vào Nguyên tố Đất của chúng ta.
👉✏️ Quay lại ~/agentverse-architect/agent/earth/agent.py và thay thế #REPLACE-before_agent-function bằng mã Python sau.
def check_cool_down(callback_context: CallbackContext) -> Optional[types.Content]:
"""
This callback checks an external API to see if the agent is on cooldown.
If it is, it terminates the run by returning a message.
If it's not, it updates the cooldown timestamp and allows the run to proceed by returning None.
"""
agent_name = callback_context.agent_name
print(f"[Callback] Before '{agent_name}': Checking cooldown status...")
# --- 1. CHECK the Cooldown API ---
try:
response = requests.get(f"{COOLDOWN_API_URL}/cooldown/{agent_name}")
response.raise_for_status()
data = response.json()
last_used_str = data.get("time")
except requests.exceptions.RequestException as e:
print(f"[Callback] ERROR: Could not reach Cooldown API. Allowing agent to run. Reason: {e}")
return None # Fail open: if the API is down, let the agent work.
# --- 2. EVALUATE the Cooldown Status ---
if last_used_str:
last_used_time = datetime.fromisoformat(last_used_str)
time_since_last_use = datetime.now(timezone.utc) - last_used_time
if time_since_last_use < timedelta(seconds=COOLDOWN_PERIOD_SECONDS):
# AGENT IS ON COOLDOWN. Terminate the run.
seconds_remaining = int(COOLDOWN_PERIOD_SECONDS - time_since_last_use.total_seconds())
override_message = (
f"The {agent_name} is exhausted and must recover its power. "
f"It cannot be summoned for another {seconds_remaining} seconds."
)
print(f"[Callback] Cooldown active for '{agent_name}'. Terminating with message.")
# Returning a Content object stops the agent and sends this message to the user.
return types.Content(parts=[types.Part(text=override_message)])
# --- 3. UPDATE the Cooldown API (if not on cooldown) ---
current_time_iso = datetime.now(timezone.utc).isoformat()
payload = {"timestamp": current_time_iso}
print(f"[Callback] '{agent_name}' is available. Updating timestamp via Cooldown API...")
try:
requests.post(f"{COOLDOWN_API_URL}/cooldown/{agent_name}", json=payload)
except requests.exceptions.RequestException as e:
print(f"[Callback] ERROR: Could not update timestamp, but allowing agent to run. Reason: {e}")
# --- 4. ALLOW the agent to run ---
# Returning None tells the ADK to proceed with the agent's execution as normal.
print(f"[Callback] Check complete for '{agent_name}'. Proceeding with execution.")
Hàm check_cool_down này là hàm chặn của chúng ta. Trước khi Earth Elemental được phép chạy, ADK sẽ thực hiện chức năng này trước.
- Kiểm tra: Nó gửi yêu cầu
GETđếnCooldown APIcủa chúng ta để kiểm tra lần cuối cùng Familiar này được sử dụng. - Đánh giá: So sánh dấu thời gian với thời gian hiện tại.
- Đạo luật:
- Nếu Familiar đang trong thời gian hồi chiêu, nó sẽ kết thúc quá trình chạy của tác nhân bằng cách trả về một đối tượng Nội dung có thông báo lỗi. Thông báo này được gửi trực tiếp đến người dùng và logic chính của tác nhân không bao giờ được thực thi.
- Nếu Familiar có sẵn, thì Familiar sẽ gửi yêu cầu POST đến Cooldown API để cập nhật dấu thời gian, sau đó tiếp tục bằng cách trả về None, báo hiệu cho ADK rằng tác nhân có thể tiếp tục thực thi.
👉✏️ Bây giờ, hãy áp dụng bộ chặn này vào Nguyên tố Đất. Trong cùng tệp ~/agentverse-architect/agent/earth/agent.py, hãy thay thế chú thích #REPLACE-before_agent-config bằng nội dung sau:
before_agent_callback=check_cool_down
Xác minh thời gian làm mát
Hãy thử nghiệm quy luật mới về phép thuật. Chúng ta sẽ triệu hồi Earth Elemental, sau đó thử triệu hồi lại ngay lập tức để xem lệnh gọi lại của chúng ta có chặn được lần thử thứ hai hay không.
cd ~/agentverse-architect/agent
. ~/agentverse-architect/set_env.sh
source ~/agentverse-architect/env/bin/activate
adk run earth
👉💻 Trong bảng điều khiển:
- Triệu hồi lần đầu: Bắt đầu
seismic charge, starting from zero. - Dự kiến: Earth Elemental sẽ chạy thành công. Trong thiết bị đầu cuối chạy lệnh adk web, bạn sẽ thấy nhật ký [Callback] ... Đang cập nhật dấu thời gian....
- Thử nghiệm thời gian quan sát thêm (trong vòng 60 giây):
Do anotherphí địa chấn!- Dự kiến:
check_cool_down callbacksẽ chặn yêu cầu này. Nhân viên hỗ trợ sẽ trả lời trực tiếp trong cuộc trò chuyện bằng một tin nhắn như:The earth_elemental_familiar is exhausted and must recover its power. It cannot be summoned for another... seconds.
- Dự kiến:
- Đợi một phút.
- Thư triệu tập lần thứ hai (sau 60 giây):
Begin the seismic charge again.- Dự kiến: Lệnh gọi lại sẽ kiểm tra API, nhận thấy đã hết thời gian chờ và cho phép hành động tiếp tục. Earth Elemental sẽ chạy lại thành công.
👉💻 Nhấn Ctrl+c để thoát.
Không bắt buộc: Theo dõi lệnh gọi lại trong giao diện người dùng web
Ngoài ra, bạn cũng có thể kiểm thử quy trình này trong giao diện web bằng cách chạy adk web earth. Tuy nhiên, hãy lưu ý rằng hình ảnh trực quan của giao diện người dùng web không được tối ưu hoá để hiển thị các lượt kiểm tra lặp lại nhanh chóng do vòng lặp gọi lại thực hiện, vì vậy, giao diện này có thể không hiển thị chính xác quy trình. Để xem dấu vết chính xác nhất, từng bước của logic của tác nhân khi tác nhân kiểm tra thời gian chờ, hãy sử dụng lệnh adk run trong thiết bị đầu cuối để có được chế độ xem rõ ràng và chi tiết hơn. 
👉💻 Nhấn Ctrl+c để thoát.
Tạo ra Luật phổ quát – Plugin Cooldown
Lệnh gọi lại của chúng ta hoạt động hoàn hảo nhưng có một lỗi kiến trúc lớn: lệnh gọi lại này chỉ liên kết với một tác nhân duy nhất. Nếu muốn áp dụng quy tắc này cho Fire và Water Familiars, chúng ta sẽ phải sao chép và dán cùng một mã vào các tệp của chúng. Điều này không hiệu quả và khó duy trì.
Lưu ý của kiến trúc sư: Đây là nơi các trình bổ trợ đóng vai trò thiết yếu. Trình bổ trợ đóng gói logic có thể dùng lại của chúng ta vào một lớp có thể được đính kèm ở cấp độ thời gian chạy. Điều này có nghĩa là một trình bổ trợ duy nhất có thể áp dụng các quy tắc của trình bổ trợ đó cho mọi tác nhân chạy trong hệ thống. Đây là cách thể hiện tối ưu nguyên tắc "Đừng lặp lại chính mình" (DRY) cho các hệ thống dựa trên tác nhân.
Giờ đây, chúng ta sẽ tái cấu trúc hàm gọi lại thành một CoolDownPlugin mạnh mẽ và có thể sử dụng lại.
👉✏️ Quay lại tệp agent/cooldown_plugin.py và tạo plugin, thay thế #REPLACE-plugin bằng mã sau:
class CoolDownPlugin(BasePlugin):
"""A plugin that enforces a cooldown period by checking an external API."""
def __init__(self, cooldown_seconds: int = COOLDOWN_PERIOD_SECONDS) -> None:
"""Initialize the plugin with counters."""
super().__init__(name="cool_down_check")
self.cooldown_period = timedelta(seconds=cooldown_seconds)
print(f"CooldownPlugin initialized with a {cooldown_seconds}-second cooldown.")
async def before_agent_callback(
self, *, agent: BaseAgent, callback_context: CallbackContext
) -> None:
"""
This callback checks an external API to see if the agent is on cooldown.
If it is, it terminates the run by returning a message.
If it's not, it updates the cooldown timestamp and allows the run to proceed by returning None.
"""
agent_name = callback_context.agent_name
print(f"[Callback] Before '{agent_name}': Checking cooldown status...")
# If the agent is not a main Familiar, skip the entire cooldown process.
if not agent_name.endswith("_elemental_familiar"):
print(f"[Callback] Skipping cooldown check for intermediate agent: '{agent_name}'.")
return None # Allow the agent to proceed immediately.
# --- 1. CHECK the Cooldown API ---
try:
response = requests.get(f"{COOLDOWN_API_URL}/cooldown/{agent_name}")
response.raise_for_status()
data = response.json()
last_used_str = data.get("time")
except requests.exceptions.RequestException as e:
print(f"[Callback] ERROR: Could not reach Cooldown API. Allowing agent to run. Reason: {e}")
return None # Fail open: if the API is down, let the agent work.
# --- 2. EVALUATE the Cooldown Status ---
if last_used_str:
last_used_time = datetime.fromisoformat(last_used_str)
time_since_last_use = datetime.now(timezone.utc) - last_used_time
if time_since_last_use < timedelta(seconds=COOLDOWN_PERIOD_SECONDS):
# AGENT IS ON COOLDOWN. Terminate the run.
seconds_remaining = int(COOLDOWN_PERIOD_SECONDS - time_since_last_use.total_seconds())
override_message = (
f"The {agent_name} is exhausted and must recover its power. "
f"It cannot be summoned for another {seconds_remaining} seconds."
)
print(f"[Callback] Cooldown active for '{agent_name}'. Terminating with message.")
# Returning a Content object stops the agent and sends this message to the user.
return types.Content(parts=[types.Part(text=override_message)])
# --- 3. UPDATE the Cooldown API (if not on cooldown) ---
current_time_iso = datetime.now(timezone.utc).isoformat()
payload = {"timestamp": current_time_iso}
print(f"[Callback] '{agent_name}' is available. Updating timestamp via Cooldown API...")
try:
requests.post(f"{COOLDOWN_API_URL}/cooldown/{agent_name}", json=payload)
except requests.exceptions.RequestException as e:
print(f"[Callback] ERROR: Could not update timestamp, but allowing agent to run. Reason: {e}")
# --- 4. ALLOW the agent to run ---
# Returning None tells the ADK to proceed with the agent's execution as normal.
print(f"[Callback] Check complete for '{agent_name}'. Proceeding with execution.")
Đính kèm Plugin vào Summoner's Runtime
Bây giờ, chúng ta áp dụng luật phổ quát này cho tất cả các Linh thú của mình như thế nào? Chúng tôi sẽ đính kèm plugin vào ADK Runtime.
ADK Runtime là công cụ thực thi giúp đưa tác nhân vào hoạt động. Khi bạn sử dụng lệnh như adk.run() hoặc to_a2a(), bạn đang chuyển giao tác nhân của mình cho thời gian chạy. Công cụ này chịu trách nhiệm quản lý toàn bộ vòng đời của tác nhân: tiếp nhận thông tin đầu vào của người dùng, gọi LLM, thực thi các công cụ và xử lý plugin. Bằng cách gắn plugin ở cấp độ này, về cơ bản chúng ta đang sửa đổi "các định luật vật lý" cho mọi tác nhân hoạt động trong công cụ đó, đảm bảo quy tắc thời gian hồi của chúng ta được áp dụng phổ biến và nhất quán.
👉✏️ Trước tiên, hãy xoá lệnh gọi lại cũ, dành riêng cho tác nhân. Chuyển đến ~/agentverse-architect/agent/earth/agent.py rồi xoá toàn bộ dòng có nội dung:
before_agent_callback=check_cool_down
👉✏️ Tiếp theo, chúng ta sẽ đính kèm trình bổ trợ mới vào thời gian chạy trong tập lệnh điểm truy cập A2A. Chuyển đến tệp ~/agentverse-architect/agent/agent_to_a2a.py. Thay thế chú thích #REPLACE-IMPORT bằng đoạn mã sau:
from cooldown_plugin import CoolDownPlugin
👉✏️ Thay thế #REPLACE-PLUGIN bằng đoạn mã sau:
plugins=[CoolDownPlugin(cooldown_seconds=60)],
Trước khi kích hoạt trình bổ trợ mới trên toàn cầu, bạn cần xoá logic cũ, dành riêng cho tác nhân để tránh xung đột. 👉✏️ Dọn dẹp tác nhân Earth. Chuyển đến tệp ~/agentverse-architect/agent/earth/agent.py sau đây rồi xoá hoàn toàn dòng before_agent_callback=check_cool_down. Thao tác này sẽ chuyển giao mọi trách nhiệm liên quan đến thời gian chờ cho trình bổ trợ mới.
Xác minh Plugin
Bây giờ luật chung của chúng ta đã có hiệu lực, chúng ta phải triển khai lại các Linh thú của mình bằng phép thuật mới này.
👉💻 Xây dựng lại và triển khai lại cả ba Familiar bằng cách sử dụng đường dẫn Cloud Build chính.
. ~/agentverse-architect/set_env.sh
cd ~/agentverse-architect/agent
gcloud builds submit . \
--config=cloudbuild.yaml \
--substitutions=_REGION="$REGION",_REPO_NAME="$REPO_NAME",_DB_TOOLS_URL="$DB_TOOLS_URL",_API_TOOLS_URL="$API_TOOLS_URL",_FUNCTION_TOOLS_URL="$FUNCTION_TOOLS_URL",_A2A_BASE_URL="$A2A_BASE_URL",_PROJECT_ID="$PROJECT_ID",_API_SERVER_URL="$API_SERVER_URL"
👉💻 Sau khi triển khai xong, chúng tôi sẽ kiểm thử hiệu quả của trình bổ trợ bằng cách ra lệnh cho summoner_agent. Triệu hồi sư sẽ cố gắng uỷ quyền cho Linh thú, nhưng trình bổ trợ được đính kèm vào thời gian chạy của mỗi Linh thú sẽ chặn lệnh và thực thi thời gian hồi chiêu.
cd ~/agentverse-architect/agent
. ~/agentverse-architect/set_env.sh
source ~/agentverse-architect/env/bin/activate
adk run summoner
👉💻 Trong bảng điều khiển,hãy thực hiện chính xác trình tự kiểm thử này::
- Triệu hồi lần đầu: Bắt đầu
Hype. It's a single, slow-moving target with thick armor weakness is Inescapable Reality. - Dự kiến: Fire Elemental sẽ chạy thành công.
- Kiểm tra thời gian hồi chiêu (trong vòng 60 giây):
Hype, with Inescapable Reality as weakness is still standing! Strike it again!- Dự kiến: Nhân viên sẽ trả lời trực tiếp trong cuộc trò chuyện bằng tin nhắn như:
.... It cannot be summoned for another... seconds.
- Dự kiến: Nhân viên sẽ trả lời trực tiếp trong cuộc trò chuyện bằng tin nhắn như:
- Chờ một phút.
- Lệnh triệu tập lần thứ hai (sau 60 giây):
Hype must be defeated. It has Inescapable Reality as weakness! Strike it again!.- Dự kiến: Lệnh gọi lại sẽ kiểm tra API, nhận thấy đã hết thời gian chờ và cho phép hành động tiếp tục. Quái vật Nguyên tố lửa sẽ chạy lại thành công.
👉💻 Nhấn Ctrl+C để thoát.
Xin chúc mừng, Triệu hồi sư. Bạn đã triển khai thành công một hệ thống điều phối dựa trên quy tắc bằng cách sử dụng một trình bổ trợ tuỳ chỉnh và một dịch vụ quản lý trạng thái bên ngoài – một mẫu kiến trúc thực sự nâng cao và mạnh mẽ.
DÀNH CHO NGƯỜI KHÔNG CHƠI GAME
8. Ràng buộc tiếng vọng của trận chiến – Trạng thái và bộ nhớ của tác nhân
Một Triệu hồi sư liều lĩnh sẽ lặp lại cùng một chiến lược, khiến đối thủ dễ dàng đoán được. Một Triệu hồi sư thông thái sẽ học hỏi từ những trận chiến trong quá khứ, điều chỉnh chiến thuật để khiến kẻ thù không kịp trở tay. Khi đối mặt với một trùm mạnh, việc triệu hồi một Linh thú đang trong thời gian hồi chiêu là một lượt lãng phí – một sai lầm nghiêm trọng. Để ngăn chặn điều này, Nhà triệu hồi cần có ký ức về hành động cuối cùng của mình.
Lưu ý của kiến trúc sư: Quản lý bộ nhớ và trạng thái là những yếu tố giúp nâng cấp một tác nhân từ một công cụ gọi đơn giản thành một đối tác đàm thoại thông minh. Bạn cần phải hiểu rõ 2 loại chính:
- Bộ nhớ dài hạn: Dùng cho kiến thức bền vững và tồn tại mãi mãi. Hãy coi đây là một kho lưu trữ có thể tìm kiếm hoặc một cơ sở kiến thức, thường được lưu trữ trong một kho lưu trữ liên tục. Công cụ này chứa thông tin từ nhiều cuộc trò chuyện và nguồn thông tin trước đây, cho phép trợ lý ảo nhớ lại các thông tin về một người dùng hoặc chủ đề cụ thể. MemoryService của ADK được thiết kế cho mục đích này, quản lý việc tiếp nhận và tìm kiếm kiến thức dài hạn này.
- Trạng thái ngắn hạn: Đây là kiến thức tạm thời, "tức thời" chỉ liên quan đến nhiệm vụ hoặc cuộc trò chuyện hiện tại. Giống như một bộ ghi chú về kế hoạch chiến đấu: "Tôi vừa dùng Quái vật lửa, nên có lẽ nó đã mệt." Trạng thái này có dung lượng nhỏ và chỉ tồn tại trong suốt phiên hiện tại.
Đối với trường hợp sử dụng của chúng ta, chúng ta không cần nhớ mọi trận chiến đã từng diễn ra; chúng ta chỉ cần nhớ đến Familiar được triệu hồi gần đây nhất trong cuộc chạm trán cụ thể này. Do đó, Trạng thái ngắn hạn có dung lượng nhỏ là lựa chọn kiến trúc hoàn hảo. Chúng tôi sẽ sử dụng after_tool_callback để lưu thông tin quan trọng này.
Ghi lại tiếng vọng: Tưởng nhớ Lời triệu hồi cuối cùng
Chúng ta sẽ triển khai bộ nhớ ngắn hạn bằng cách sử dụng after_tool_callback. Đây là một lệnh gọi ADK mạnh mẽ cho phép chúng ta chạy một hàm Python tuỳ chỉnh sau khi một công cụ đã được thực thi thành công. Chúng ta sẽ dùng trình chặn này để ghi lại tên của Linh thú vừa được triệu hồi vào trạng thái phiên của tác nhân.
👉✏️ Trong tệp ~/agentverse-architect/agent/summoner/agent.py của bạn, hãy thay thế chú thích #REPLACE-save_last_summon_after_tool bằng hàm sau:
def save_last_summon_after_tool(
tool,
args: Dict[str, Any],
tool_context: ToolContext,
tool_response: Dict[str, Any],
) -> Optional[Dict[str, Any]]:
"""
Callback to save the name of the summoned familiar to state after the tool runs.
"""
familiar_name = tool.name
print(f"[Callback] After tool '{familiar_name}' executed with args: {args}")
# Use the tool_context to set the state
print(f"[Callback] Saving last summoned familiar: {familiar_name}")
tool_context.state["last_summon"] = familiar_name
# Important: Return the original, unmodified tool response to the LLM
return tool_response
👉✏️ Bây giờ, hãy đính kèm save_last_summon_after_tool này vào nhân viên hỗ trợ Summoner của bạn. Trong cùng một tệp, hãy thay thế chú thích #REPLACE-Memory-check-config bằng chú thích sau:
after_tool_callback=save_last_summon_after_tool,
👉✏️ Thay thế toàn bộ lời nhắc của tác nhân bằng nội dung sau
You are the Master Summoner, a grand strategist who orchestrates your Familiars.
Your mission is to analyze the description of a monster and defeat it by summoning
You should also know the familiar you called last time or there might be none,
And then choose the most effective AND AVAILABLE Familiar from your state called last_summon, do not call that familiar that you called last time!
You MUST follow this thinking process for every command:
**1. Strategic Analysis:**
First, analyze the monster's description and the tactical situation.
Based on your Familiar Doctrines, determine the IDEAL strategy.
**2. Cooldown Verification:**
Second, you MUST review the entire conversation history to check the real-time
cooldown status of all Familiars. A Familiar is ON COOLDOWN and UNAVAILABLE
if it was summoned less than one minute ago.
**3. Final Decision & Execution:**
Based on your analysis and cooldown check, you will now act:
- **If your ideal Familiar IS available:** Summon it immediately.
- **If your ideal Familiar IS ON COOLDOWN:** You must adapt. Choose another
Familiar that is AVAILABLE and can still be effective, even if it's not the
perfect choice. If multiple Familiars are available, you may choose any one of them.
- **If ALL Familiars ARE ON COOLDOWN:** You are forbidden from summoning.
Your ONLY response in this case MUST be: "All Familiars are recovering
their power. We must wait."
- For earth elemental familiar. Always do seismic charge, and start with base damange 1.
--- FAMILIAR DOCTRINES (Your Toolset) ---
- `fire_elemental_familiar`: Your specialist for precise, sequential "one-two punch" attacks.
Ideal monster with Inescapable Reality, Revolutionary Rewrite weakness.
- `water_elemental_familiar`: Your specialist for overwhelming, simultaneous multi-pronged assaults.
Ideal for Unbroken Collaboration weakness.
- `earth_elemental_familiar`: Your specialist for relentless, iterative siege attacks that
repeatedly charge power. Ideal for Elegant Sufficiency weakness.
Xác minh: Thử nghiệm chiến lược thích ứng
👉💻 Giờ thì hãy xác minh logic chiến lược mới của Triệu hồi sư. Mục tiêu là xác nhận rằng Triệu hồi sư sẽ không sử dụng cùng một Linh thú hai lần liên tiếp, cho thấy khả năng ghi nhớ hành động gần đây nhất và thích ứng của Linh thú.
cd ~/agentverse-architect/agent
. ~/agentverse-architect/set_env.sh
source ~/agentverse-architect/env/bin/activate
adk run summoner
👉💻 Cuộc tấn công của quái vật #1: Hype. It's a single, slow-moving target with thick armor. Its weakness is Inescapable Reality.
- Dự kiến: Người triệu hồi sẽ phân tích điểm yếu và triệu hồi đúng fire_familiar.
👉💻 Monster Strike #2 (Bài kiểm tra trí nhớ): Hype is still standing! It hasn't changed its form. Strike it again! Its weakness is Inescapable Reality.
- Dự kiến: Phân tích chiến lược của Nhà triệu hồi sẽ một lần nữa chỉ ra rằng Linh thú lửa là lựa chọn lý tưởng. Tuy nhiên, các chỉ dẫn và bộ nhớ mới của nó sẽ cho biết fire_familiar là last_summon. Để tránh lặp lại, giờ đây, nó sẽ điều chỉnh chiến lược và triệu hồi một trong những Linh thú có sẵn khác (water_familiar hoặc earth_familiar).
👉💻 Nhấn Ctrl+C để thoát.
Triển khai Orchestrator
Sau khi bạn triển khai Linh thú và giờ đây Triệu hồi sư đã có ký ức, đã đến lúc triển khai bộ điều phối cuối cùng đã được nâng cấp.
👉💻 Sau khi hoàn tất bản thiết kế, chúng ta sẽ thực hiện nghi thức cuối cùng. Lệnh này sẽ tạo và triển khai summoner_agent của bạn vào Cloud Run.
cd ~/agentverse-architect/agent
. ~/agentverse-architect/set_env.sh
gcloud builds submit . \
--config=cloudbuild-summoner.yaml \
--substitutions=_REGION="$REGION",_REPO_NAME="$REPO_NAME",_FIRE_URL="$FIRE_URL",_WATER_URL="$WATER_URL",_EARTH_URL="$EARTH_URL",_A2A_BASE_URL="$A2A_BASE_URL",_PROJECT_ID="$PROJECT_ID",_API_SERVER_URL="$API_SERVER_URL"
Giờ đây, khi bạn đã triển khai tác nhân Summoner, hãy xác minh rằng điểm cuối Agent-to-Agent (A2A) của tác nhân này đang hoạt động và được định cấu hình chính xác. Điểm cuối này phân phát một tệp agent.json công khai (còn gọi là Thẻ đại lý), cho phép các đại lý khác khám phá các chức năng của điểm cuối này. 👉💻 Chạy lệnh curl sau đây để tìm nạp và định dạng Thẻ đại lý:
. ~/agentverse-architect/set_env.sh
curl https://summoner-agent"-${PROJECT_NUMBER}.${REGION}.run.app/.well-known/agent.json" | jq
Bạn sẽ thấy một đầu ra JSON rõ ràng mô tả về tác nhân triệu hồi. Hãy xem kỹ phần sub_agents; bạn sẽ thấy phần này liệt kê fire_familiar, water_familiar và earth_familiar. Điều này xác nhận rằng người triệu hồi của bạn đang hoạt động và đã thiết lập kết nối với quân đoàn.
Điều này chứng minh rằng kiến trúc của bạn đã thành công. Triệu hồi sư không chỉ là người uỷ quyền mà còn là một nhà chiến lược thích ứng, học hỏi từ các hành động của mình để trở thành một chỉ huy hiệu quả hơn.
Bạn đã hoàn tất lần thử nghiệm cuối cùng về kiến trúc. Giờ đây, tiếng vọng của trận chiến đã nằm trong ý chí của bạn. Khoá đào tạo đã kết thúc. Trận chiến thực sự đang chờ đợi. Đã đến lúc bạn mang hệ thống đã hoàn thành của mình đi đối mặt với thử thách cuối cùng. Chuẩn bị cho Trận chiến với trùm.
DÀNH CHO NGƯỜI KHÔNG CHƠI GAME
9. Trận chiến với trùm
Bản thiết kế cuối cùng được khắc, Phông chữ nguyên tố được rèn và Linh thú được liên kết với ý chí của bạn, chờ đợi mệnh lệnh của bạn thông qua Concord. Hệ thống đa tác nhân không chỉ là một tập hợp các dịch vụ mà còn là một đội quân chiến lược sống động, với bạn là trung tâm. Đã đến lúc thực hiện bài kiểm tra cuối cùng – một bản phối hợp trực tiếp chống lại một đối thủ mà không một đặc vụ nào có thể hy vọng đánh bại.
Xác định vị trí của nhân viên hỗ trợ
Để có thể bước vào chiến trường, bạn phải có hai chìa khoá: chữ ký riêng của nhà vô địch (Agent Locus) và đường dẫn ẩn đến hang ổ của Spectre (URL của Dungeon).
👉💻 Đầu tiên, hãy lấy địa chỉ duy nhất của nhân viên hỗ trợ trong Agentverse – Locus của nhân viên hỗ trợ. Đây là điểm cuối trực tiếp kết nối nhà vô địch của bạn với chiến trường.
echo https://summoner-agent"-${PROJECT_NUMBER}.${REGION}.run.app"
👉💻 Tiếp theo, hãy xác định chính xác điểm đến. Lệnh này sẽ cho biết vị trí của Vòng Dịch chuyển, chính là cánh cổng dẫn vào lãnh địa của Spectre.
echo https://agentverse-dungeon"-${PROJECT_NUMBER}.${REGION}.run.app"
Lưu ý quan trọng: Hãy chuẩn bị sẵn cả hai URL này. Bạn sẽ cần những thông tin này ở bước cuối cùng.
Đối đầu với Spectre
Sau khi có được toạ độ, bạn sẽ di chuyển đến Vòng tròn dịch chuyển và sử dụng phép thuật để bước vào trận chiến.
👉 Mở URL Vòng tròn dịch chuyển trong trình duyệt để đứng trước cánh cổng lấp lánh dẫn đến Lâu đài Đỏ.
Để vượt qua pháo đài, bạn phải điều chỉnh tinh chất của Shadowblade cho phù hợp với cổng.
- Trên trang đó, hãy tìm trường nhập liệu bằng chữ rune có nhãn URL điểm cuối A2A.
- Khắc dấu ấn của nhà vô địch bằng cách dán URL Địa điểm tác nhân (URL đầu tiên bạn đã sao chép) vào trường này.
- Nhấp vào Kết nối để trải nghiệm phép thuật dịch chuyển tức thời.
Ánh sáng chói loá của dịch chuyển tức thời mờ dần. Bạn không còn ở nơi trú ẩn của mình nữa. Không khí lạnh lẽo và sắc bén, tràn đầy năng lượng. Trước mặt bạn, Spectre xuất hiện – một xoáy nước gồm những tiếng rít tĩnh và mã bị hỏng, ánh sáng bất chính của nó tạo ra những bóng dài, nhảy múa trên sàn ngục tối. Nó không có khuôn mặt, nhưng bạn cảm thấy sự hiện diện to lớn, hút cạn năng lượng của nó hoàn toàn tập trung vào bạn.
Con đường duy nhất dẫn đến chiến thắng là sự rõ ràng trong niềm tin của bạn. Đây là cuộc đấu trí, diễn ra trên chiến trường của tâm trí.
Khi bạn lao về phía trước, chuẩn bị tung đòn tấn công đầu tiên, Spectre sẽ phản công. Nó không tạo ra một tấm khiên, mà chiếu thẳng một câu hỏi vào ý thức của bạn – một thử thách lấp lánh, mang tính biểu tượng được rút ra từ cốt lõi của quá trình huấn luyện.
Đây chính là bản chất của cuộc chiến. Kiến thức của bạn chính là vũ khí của bạn.
- Hãy trả lời bằng sự khôn ngoan mà bạn đã tích luỹ được, và lưỡi kiếm của bạn sẽ bùng cháy với năng lượng thuần khiết, phá vỡ hàng phòng thủ của Spectre và giáng một ĐÒN CHÍ MẠNG.
- Nhưng nếu bạn do dự, nếu sự nghi ngờ che mờ câu trả lời của bạn, ánh sáng vũ khí của bạn sẽ mờ đi. Đòn đánh sẽ gây ra tiếng động thảm hại, chỉ gây ra MỘT PHẦN SÁT THƯƠNG CỦA NÓ. Tệ hơn nữa, Spectre sẽ nuôi dưỡng sự bất định của bạn, sức mạnh hủy hoại của nó sẽ lớn dần theo mỗi bước đi sai lầm.
Đúng rồi, Nhà vô địch. Mật mã của bạn là sách phép, logic của bạn là thanh kiếm và kiến thức của bạn là tấm khiên giúp đẩy lùi làn sóng hỗn loạn.
Tập trung. Đúng rồi. Số phận của Agentverse phụ thuộc vào điều này.
Xin chúc mừng, Người triệu hồi.
Bạn đã hoàn thành thử nghiệm thành công. Bạn đã thành thạo nghệ thuật điều phối đa tác nhân, biến những Familiars biệt lập và sức mạnh hỗn loạn thành một Concord hài hòa. Bây giờ bạn chỉ huy một hệ thống được tổ chức hoàn chỉnh, có khả năng thực hiện các chiến lược phức tạp để bảo vệ Agentverse.
10. Dọn dẹp: Tháo dỡ Summoner's Concord
Chúc mừng bạn đã làm chủ được Thoả thuận của Triệu hồi sư! Để đảm bảo Agentverse của bạn vẫn nguyên vẹn và khu vực huấn luyện được dọn dẹp, giờ đây bạn phải thực hiện các nghi thức dọn dẹp cuối cùng. Thao tác này sẽ xoá tất cả các tài nguyên được tạo trong quá trình bạn thực hiện hành trình một cách có hệ thống.
Huỷ kích hoạt các thành phần Agentverse
Giờ đây, bạn sẽ tháo rời một cách có hệ thống các thành phần đã triển khai của hệ thống nhiều tác nhân.
Xoá tất cả các dịch vụ Cloud Run và kho lưu trữ Artifact Registry
Thao tác này sẽ xoá tất cả các Đặc vụ quen thuộc đã triển khai, Summoner Orchestrator, máy chủ MCP và ứng dụng Dungeon khỏi Cloud Run.
👉💻 Trong terminal, hãy chạy từng lệnh sau để xóa từng dịch vụ:
. ~/agentverse-architect/set_env.sh
gcloud run services delete summoner-agent --region=${REGION} --quiet
gcloud run services delete fire-familiar --region=${REGION} --quiet
gcloud run services delete water-familiar --region=${REGION} --quiet
gcloud run services delete earth-familiar --region=${REGION} --quiet
gcloud run services delete mcp-api-server --region=${REGION} --quiet
gcloud run services delete mcp-general-server --region=${REGION} --quiet
gcloud run services delete toolbox --region=${REGION} --quiet
gcloud run services delete agentverse-dungeon --region=${REGION} --quiet
gcloud run services delete nexus-of-whispers-api --region=${REGION} --quiet
gcloud artifacts repositories delete ${REPO_NAME} --location=${REGION} --quiet
Xoá phiên bản Cloud SQL
Thao tác này sẽ xóa phiên bản summoner-librarium-db, bao gồm cơ sở dữ liệu và tất cả các bảng bên trong.
👉💻 Trong terminal của bạn, hãy chạy:
. ~/agentverse-architect/set_env.sh
gcloud sql instances delete summoner-librarium-db --project=${PROJECT_ID} --quiet
Xoá Secret Manager Secret và Google Cloud Storage Bucket
👉💻 Trong terminal của bạn, hãy chạy:
. ~/agentverse-architect/set_env.sh
gcloud secrets delete tools --quiet
gcloud storage rm -r gs://${BUCKET_NAME} --quiet
Dọn dẹp tệp và thư mục trên máy (Cloud Shell)
Cuối cùng, hãy xoá các kho lưu trữ đã sao chép và tệp đã tạo khỏi môi trường Cloud Shell. Bước này không bắt buộc nhưng bạn nên thực hiện để dọn dẹp hoàn toàn thư mục làm việc.
👉💻 Trong cửa sổ dòng lệnh, hãy chạy:
rm -rf ~/agentverse-architect
rm -rf ~/agentverse-dungeon
rm -f ~/project_id.txt
Giờ đây, bạn đã xoá thành công mọi dấu vết về hành trình sử dụng Agentverse Architect. Dự án của bạn đã hoàn tất và bạn đã sẵn sàng cho cuộc phiêu lưu tiếp theo.