Skip to content
This repository was archived by the owner on Mar 11, 2026. It is now read-only.

Commit f05db53

Browse files
author
astrbot-docs-agent[bot]
committed
docs: update for AstrBotDevs/AstrBot#5579
1 parent 2964dfc commit f05db53

File tree

2 files changed

+23
-5
lines changed

2 files changed

+23
-5
lines changed

en/use/subagent.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,15 @@ Click the "Add SubAgent" button:
4242
- **Assign Tools**: Select the tools this SubAgent can invoke.
4343
- **Provider Override (Optional)**: You can specify different model providers for specific SubAgents. For example, the Main Agent could use GPT-4o, while a simple query SubAgent uses GPT-4o-mini to save costs.
4444

45+
## Multimodal Image Passing
46+
47+
When the Main Agent delegates a task to a SubAgent, images can be passed as references:
48+
49+
- **Automatic Passing**: Images sent by the user to the Main Agent are automatically passed to the SubAgent, ensuring the SubAgent can see the reference images uploaded by the user.
50+
- **Manual Specification**: The Main Agent can explicitly pass image URLs via the `image_urls` parameter (supports HTTP/HTTPS public URLs or local file paths).
51+
52+
Supported image formats include: png, jpg, jpeg, gif, webp, bmp, tif, tiff, svg, heic.
53+
4554
## Best Practices
4655

4756
- **Single Responsibility**: Each SubAgent should handle one category of related tasks (e.g., search, file processing, smart home control).
@@ -53,4 +62,4 @@ Click the "Add SubAgent" button:
5362
SubAgent orchestration is currently an **experimental feature** and not yet stable.
5463

5564
1. Skills of personas cannot be isolated at this time.
56-
2. SubAgent conversation histories are not currently saved.
65+
2. SubAgent conversation histories are not currently saved.

zh/use/subagent.md

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -30,18 +30,27 @@ SubAgent 编排是 AstrBot 提供的一种高级 Agent 组织方式。它允许
3030

3131
### 1. 启用 SubAgent 模式
3232

33-
在页面顶部开启启用 SubAgent 编排
33+
在页面顶部开启"启用 SubAgent 编排"
3434

3535
### 2. 创建 SubAgent
3636

37-
点击新增 SubAgent按钮:
37+
点击"新增 SubAgent"按钮:
3838

3939
- **Agent 名称**:用于生成委派工具名(如 `transfer_to_weather`)。建议使用英文小写和下划线。
40-
- **选择 Persona**:选择一个预设的 Persona,即人格,作为该子 Agent 的基础性格、行为指导和可以使用的 Tools 集合。你可以在人格设定页面创建和管理 Persona。
40+
- **选择 Persona**:选择一个预设的 Persona,即人格,作为该子 Agent 的基础性格、行为指导和可以使用的 Tools 集合。你可以在"人格设定"页面创建和管理 Persona。
4141
- **对主 LLM 的描述**:这段描述会告诉主 Agent 这个子 Agent 擅长做什么,以便主 Agent 准确委派。
4242
- **分配工具**:选择该子 Agent 可以调用的工具。
4343
- **Provider 覆盖(可选)**:你可以为特定的子 Agent 指定不同的模型提供商。例如,主 Agent 使用 GPT-4o,而负责简单查询的子 Agent 使用 GPT-4o-mini 以节省成本。
4444

45+
## 多模态图片传递
46+
47+
当主 Agent 将任务委派给子 Agent 时,支持传递图片作为参考:
48+
49+
- **自动传递**:用户发送给主 Agent 的图片会自动传递给子 Agent,确保子 Agent 能够看到用户上传的参考图。
50+
- **手动指定**:主 Agent 可以通过 `image_urls` 参数显式传递图片 URL(支持 HTTP/HTTPS 公网 URL 或本地文件路径)。
51+
52+
支持的图片格式包括:png、jpg、jpeg、gif、webp、bmp、tif、tiff、svg、heic。
53+
4554
## 最佳实践
4655

4756
- **职责单一**:每个 SubAgent 应该只负责一类相关的任务(如:搜索、文件处理、智能家居控制)。
@@ -53,4 +62,4 @@ SubAgent 编排是 AstrBot 提供的一种高级 Agent 组织方式。它允许
5362
SubAgent 系统目前是**实验性功能**,未稳定。
5463

5564
1. 目前无法隔离人格的 Skills。
56-
2. 子 Agent 的对话历史暂时不会被保存。
65+
2. 子 Agent 的对话历史暂时不会被保存。

0 commit comments

Comments
 (0)