diff --git a/en/use/subagent.md b/en/use/subagent.md index da6e5a7..2aa9978 100644 --- a/en/use/subagent.md +++ b/en/use/subagent.md @@ -42,6 +42,15 @@ Click the "Add SubAgent" button: - **Assign Tools**: Select the tools this SubAgent can invoke. - **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. +## Multimodal Image Passing + +When the Main Agent delegates a task to a SubAgent, images can be passed as references: + +- **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. +- **Manual Specification**: The Main Agent can explicitly pass image URLs via the `image_urls` parameter (supports HTTP/HTTPS public URLs or local file paths). + +Supported image formats include: png, jpg, jpeg, gif, webp, bmp, tif, tiff, svg, heic. + ## Best Practices - **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: SubAgent orchestration is currently an **experimental feature** and not yet stable. 1. Skills of personas cannot be isolated at this time. -2. SubAgent conversation histories are not currently saved. +2. SubAgent conversation histories are not currently saved. \ No newline at end of file diff --git a/zh/use/subagent.md b/zh/use/subagent.md index 5c2a20d..fb2b73c 100644 --- a/zh/use/subagent.md +++ b/zh/use/subagent.md @@ -30,18 +30,27 @@ SubAgent 编排是 AstrBot 提供的一种高级 Agent 组织方式。它允许 ### 1. 启用 SubAgent 模式 -在页面顶部开启“启用 SubAgent 编排”。 +在页面顶部开启"启用 SubAgent 编排"。 ### 2. 创建 SubAgent -点击“新增 SubAgent”按钮: +点击"新增 SubAgent"按钮: - **Agent 名称**:用于生成委派工具名(如 `transfer_to_weather`)。建议使用英文小写和下划线。 -- **选择 Persona**:选择一个预设的 Persona,即人格,作为该子 Agent 的基础性格、行为指导和可以使用的 Tools 集合。你可以在“人格设定”页面创建和管理 Persona。 +- **选择 Persona**:选择一个预设的 Persona,即人格,作为该子 Agent 的基础性格、行为指导和可以使用的 Tools 集合。你可以在"人格设定"页面创建和管理 Persona。 - **对主 LLM 的描述**:这段描述会告诉主 Agent 这个子 Agent 擅长做什么,以便主 Agent 准确委派。 - **分配工具**:选择该子 Agent 可以调用的工具。 - **Provider 覆盖(可选)**:你可以为特定的子 Agent 指定不同的模型提供商。例如,主 Agent 使用 GPT-4o,而负责简单查询的子 Agent 使用 GPT-4o-mini 以节省成本。 +## 多模态图片传递 + +当主 Agent 将任务委派给子 Agent 时,支持传递图片作为参考: + +- **自动传递**:用户发送给主 Agent 的图片会自动传递给子 Agent,确保子 Agent 能够看到用户上传的参考图。 +- **手动指定**:主 Agent 可以通过 `image_urls` 参数显式传递图片 URL(支持 HTTP/HTTPS 公网 URL 或本地文件路径)。 + +支持的图片格式包括:png、jpg、jpeg、gif、webp、bmp、tif、tiff、svg、heic。 + ## 最佳实践 - **职责单一**:每个 SubAgent 应该只负责一类相关的任务(如:搜索、文件处理、智能家居控制)。 @@ -53,4 +62,4 @@ SubAgent 编排是 AstrBot 提供的一种高级 Agent 组织方式。它允许 SubAgent 系统目前是**实验性功能**,未稳定。 1. 目前无法隔离人格的 Skills。 -2. 子 Agent 的对话历史暂时不会被保存。 +2. 子 Agent 的对话历史暂时不会被保存。 \ No newline at end of file