fix picture bugs

Author: yaozheng-fang

docs/content/1.introduction/4.troubleshooting.md

@@ -34,5 +34,6 @@ navigation:
 2. **安装依赖失败，显示依赖安装空间不足**
    - VeFaaS 最大依赖安装大小默认为 250 MB，若需更大空间，请联系 VeFaaS 产品团队扩容。
 
-3. **显示`[apig_gateway][][get_info][Error] ExceededQuota`
+3. **显示`[apig_gateway][][get_info][Error] ExceededQuota`**
+   - ![网关超额报错](/images/troubleshooting-03.jpeg)
    - 火山引擎 APIG 中，Serveless 类型的网关实例最多只能有1个。需要指定唯一的网关实例。

docs/content/3.agent/1.agent.md

@@ -93,55 +93,7 @@ print(response) # 北京天气晴朗，气温25°C。
 
 下面提供了不同类型工作流智能体的定义方法：
 
-#### 顺序类 `SequentialAgent`
-
-#### 循环类 `LoopAgent`
-
-```python [loop_agent.py]
-
-```
-
-#### 并行类 `ParallelAgent`
-
-```python [parallel_agent.py]
-
-```
-
-### 选项
-
-工作流 Agent 采用统一的参数：
-
-::field-group
-  ::field{name="name" type="string"}
-  智能体的名称
-  ::
-
-  ::field{name="description" type="string"}
-  默认为 `DEFAULT_DESCRIPTION` - 智能体的描述，在 A2A 场景下会有帮助
-  ::
-
-  ::field{name="instruction" type="string"}
-  默认为 `DEFAULT_INSTRUCTION` - 智能体的指令，例如函数调用的原则
-  ::
-
-  ::field{name="sub_agents" type="list[BaseAgent]"}
-  默认为 `[]` - 提供给该智能体的子智能体列表
-  ::
-
-  ::field{name="tracers" type="list[BaseTracer]"}
-  默认为 `[]` - 提供给该智能体的 tracer
-  ::
-::
-
-::note
-更多兼容字段请参考 [Google ADK Agents 定义](https://github.com/google/adk-python/blob/main/src/google/adk/agents/)。
-::
-
-## 多智能体协作
-
-使用 VeADK 可以构建多 Agent 协作， 主 Agent 通过 `sub_agents` 机制协调多个子 Agent 完成复杂任务。
-
-### 自主决策 Agent
+#### LLM 模式
 
 利用能够自主决策的 Agent 来定义一个生活提醒智能体，分别定义了三个智能体：
 
@@ -182,9 +134,9 @@ print(response)
 # It's a comfortable and warm day. You can choose light and breathable clothes. For example, a short - sleeved T - shirt or a thin shirt paired with casual pants or a skirt would be great. Since it's sunny, don't forget to wear a hat and sunglasses to protect yourself from the sun. Also, you can carry a light jacket in case the temperature drops in the evening, but it might not be necessary. Enjoy your day in Beijing!
 ```
 
-### `SequentialAgent`
+#### 顺序类 `SequentialAgent`
 
-```python [sequential_agent.py]
+```python[seq_agent.py]
 import asyncio
 
 from veadk import Agent, Runner
@@ -210,14 +162,106 @@ response = asyncio.run(runner.run("你好"))
 print(response)
 ```
 
-### `LoopAgent`
+#### 循环类 `LoopAgent`
 
 ```python [loop_agent.py]
+import asyncio
+from veadk import Agent, Runner
+from veadk.agents.loop_agent import LoopAgent
+from google.adk.tools.tool_context import ToolContext
+
+def exit_loop(tool_context: ToolContext):
+  print(f"  [Tool Call] exit_loop triggered by {tool_context.agent_name}")
+  tool_context.actions.escalate = True
+  return {}
+
+planner_agent = Agent(
+    name="planner_agent",
+    description="Decomposes a complex task into smaller actionable steps.",
+    instruction=(
+        "Given the user's goal and current progress, decide the NEXT step to take. You don't need to execute the step, just describe it clearly. "
+        "If all steps are done, respond with 'TASK COMPLETE'."
+    ),
+)
 
+executor_agent = Agent(
+    name="executor_agent",
+    description="Executes a given step and returns the result.",
+    instruction="Execute the provided step and describe what was done or what result was obtained. If you received 'TASK COMPLETE', you must call the 'exit_loop' function. Do not output any text.",
+    tools=[exit_loop],
+)
+
+root_agent = LoopAgent(
+    sub_agents=[planner_agent, executor_agent],
+    max_iterations=3,  # Limit the number of loops to prevent infinite loops
+)
+
+runner = Runner(root_agent)
+
+response = asyncio.run(runner.run("帮我写一首三行的小诗，主题是秋天"))
+
+print(response)
 ```
 
-### `ParallelAgent`
+#### 并行类 `ParallelAgent`
 
 ```python [parallel_agent.py]
+import asyncio
+
+from veadk import Agent, Runner
+from veadk.agents.parallel_agent import ParallelAgent
+
+pros_agent = Agent(
+    name="pros_agent",
+    description="An expert that identifies the advantages of a topic.",
+    instruction="List and explain the positive aspects or advantages of the given topic.",
+)
 
+cons_agent = Agent(
+    name="cons_agent",
+    description="An expert that identifies the disadvantages of a topic.",
+    instruction="List and explain the negative aspects or disadvantages of the given topic.",
+)
+
+root_agent = ParallelAgent(sub_agents=[pros_agent, cons_agent])
+
+runner = Runner(root_agent)
+
+response = asyncio.run(runner.run("请分析 LLM-as-a-Judge 这种评测模式的优劣"))
+
+print(response)
 ```
+
+### 选项
+
+工作流 Agent 采用统一的参数：
+
+::field-group
+  ::field{name="name" type="string"}
+  智能体的名称
+  ::
+
+  ::field{name="description" type="string"}
+  默认为 `DEFAULT_DESCRIPTION` - 智能体的描述，在 A2A 场景下会有帮助
+  ::
+
+  ::field{name="instruction" type="string"}
+  默认为 `DEFAULT_INSTRUCTION` - 智能体的指令，例如函数调用的原则
+  ::
+
+  ::field{name="sub_agents" type="list[BaseAgent]"}
+  默认为 `[]` - 提供给该智能体的子智能体列表
+  ::
+
+  ::field{name="tracers" type="list[BaseTracer]"}
+  默认为 `[]` - 提供给该智能体的 tracer
+  ::
+::
+
+::note
+更多兼容字段请参考 [Google ADK Agents 定义](https://github.com/google/adk-python/blob/main/src/google/adk/agents/)。
+::
+
+## 多智能体协作
+
+使用 VeADK 可以构建多 Agent 协作， 主 Agent 通过 `sub_agents` 机制协调多个子 Agent 完成复杂任务。

docs/nuxt.config.js

@@ -3,5 +3,8 @@ export default {
   extends: ['docus'],
   app: {
     baseURL: '/veadk-python/'
+  },
+  image: {
+    provider: 'none' // 禁用 IPX 图片优化
   }
 }