feat: day 3 (#1)

Author: HotThoughts

agents/my_agent/agent.py

@@ -0,0 +1,45 @@
+from google.adk.agents.config_agent_utils import load_agent_from_config
+from google.adk.runners import Runner
+from google.adk.sessions import InMemorySessionService
+from google.genai import types
+import asyncio
+from pathlib import Path
+
+# CONFIGURATION
+APP_NAME = "simple_search_agent"
+USER_ID = "user_default"
+SESSION_ID = "session_01"
+
+# AGENT DEFINITION - Load from YAML using ADK's built-in method
+yaml_path = Path(__file__).parent / 'root_agent.yaml'
+root_agent = load_agent_from_config(str(yaml_path))
+
+
+# Session and Runner
+async def setup_session_and_runner():
+    session_service = InMemorySessionService()
+    session = await session_service.create_session(
+        app_name=APP_NAME, user_id=USER_ID, session_id=SESSION_ID
+    )
+    runner = Runner(
+        agent=root_agent, app_name=APP_NAME, session_service=session_service
+    )
+    return session, runner
+
+
+# Agent Interaction
+async def call_agent_async(query):
+    content = types.Content(role="user", parts=[types.Part(text=query)])
+    session, runner = await setup_session_and_runner()
+    events = runner.run_async(
+        user_id=USER_ID, session_id=SESSION_ID, new_message=content
+    )
+
+    async for event in events:
+        if event.is_final_response():
+            final_response = event.content.parts[0].text
+            print("Agent Response: ", final_response)
+
+
+if __name__ == "__main__":
+    asyncio.run(call_agent_async("what's the latest ai news?"))

agents/my_agent/root_agent.yaml

@@ -1,5 +1,11 @@
 # yaml-language-server: $schema=https://raw.githubusercontent.com/google/adk-python/refs/heads/main/src/google/adk/agents/config_schemas/AgentConfig.json
-name: root_agent
-description: A helpful assistant for user questions.
-instruction: Answer user questions to the best of your knowledge
+name: search_agent
+description: A helpful assistant that can search Google.
+instruction: |
+  You are a helpful assistant with access to Google Search.
+
+  If the user asks a question that requires current information or facts, use the 'google_search' tool.
+  Always cite your sources implicitly by providing the answer clearly based on the search results.
 model: gemini-2.5-flash
+tools:
+  - name: google_search

figs/day-03.png

@@ -0,0 +1,29 @@
+# Day 03 - 在 Python 代码中加载 YAML 配置的智能体
+
+**挑战链接**: [Advent of Agents - Day 03](https://adventofagents.com/day/03)
+
+![Day 03 Screenshot](figs/day-03.png)
+
+## 关键学习
+
+- Google ADK 提供了内置方法 `load_agent_from_config()` 来从 YAML 文件加载智能体配置
+- YAML 配置文件可以包含完整的智能体定义，包括名称、描述、指令、模型和工具
+- 工具可以在 YAML 文件中通过 `tools` 部分定义，例如 `google_search`
+- ADK Web Developer UI 可以自动检测并加载 Python 代码中定义的智能体
+- 使用 `Path(__file__).parent` 可以获取相对于当前脚本文件的路径，方便加载同目录下的 YAML 文件
+
+## 面临的挑战
+
+- 最初尝试手动解析 YAML 文件，但发现 ADK 有更优雅的内置方法
+- 需要了解 `Agent` 类和 `LlmAgent` 类的区别，以及何时使用 `load_agent_from_config`
+- 确保 YAML 文件中的工具名称与 ADK 提供的工具名称匹配
+
+## 资源
+
+- [ADK Config Agent Documentation](http://google.github.io/adk-docs/agent/config/) - 使用 YAML 配置构建智能体的官方文档
+- [ADK Agents API Reference](http://google.github.io/adk-docs/agents/) - 智能体 API 参考文档
+- [Google ADK Python Documentation](http://google.github.io/adk-docs/) - ADK Python 完整文档
+
+## 问题 / 开放话题
+
+- 不是必须要用 Gemini Pro 3，在 YAML 配置里把 model 模型改成 free tier 里提供的即可