文档：新增子 Agent 多模态图片传递章节

[astrbot-doc-agent]

Generated automatically by astrbot-docs-agent-server.

• Upstream PR: fix:修正子agent无法正确接收本地图片(参考图)路径的问题 AstrBot#5579
• Trigger: PR merged

---

AI change summary:

• 在 zh/use/subagent.md 新增「多模态图片传递」章节，说明图片自动传递机制、image_urls 参数用法及支持的格式。
• 同步更新英文文档 en/use/subagent.md。

Please review manually before merging.

---

Experimental bot notice:

• This output is generated by AstrBot-Doc-Agent for review only.
• It does not represent the final documentation form.

[dosubot]

Related Documentation

1 document(s) may need updating based on files changed in this PR:

AstrBotTeam's Space

pr4697的改动

View Suggested Changes

@@ -9,7 +9,7 @@
 主代理可以通过 `transfer_to_<subagent>` 工具将任务转交给指定子代理。该工具支持以下参数：
 
 - `input`: 转交给子代理的输入内容，应为清晰简洁的请求或任务描述。
-- `image_urls`（可选，[PR #5348](https://github.com/AstrBotDevs/AstrBot/pull/5348)）: 字符串数组，包含图片源（公开 HTTP URL 或本地文件路径），用作多模态任务（如视频生成）的参考图片。对话中的图片会自动传递（[PR #5579](https://github.com/AstrBotDevs/AstrBot/pull/5579)），无需手动指定。
+- `image_urls`（可选，[PR #5348](https://github.com/AstrBotDevs/AstrBot/pull/5348)）: 字符串数组，包含图片源（HTTP/HTTPS 公网 URL 或本地文件路径），用作多模态任务（如图像分析、视频生成）的参考图片。[PR #5579](https://github.com/AstrBotDevs/AstrBot/pull/5579) 新增了自动图片传递机制，用户发送给主代理的图片会自动传递给子代理，无需手动指定。支持的图片格式包括：png、jpg、jpeg、gif、webp、bmp、tif、tiff、svg、heic。更多详情请参阅官方 SubAgent 文档的[多模态图片传递](https://docs.astrbot.app/zh/use/subagent.html#多模态图片传递)章节。
 - `background_task`: 若设置为 `true`，任务将以后台模式异步执行，主代理会立即返回任务 ID，任务完成后通过后台任务唤醒机制通知用户结果。适用于长时间或非紧急任务。
 
 > **参考文档**: 关于委派工具参数的完整说明，请参阅官方 SubAgent 文档（[中文版](https://docs.astrbot.app/zh/use/subagent.html#委派工具参数) / [English](https://docs.astrbot.app/en/use/subagent.html#delegation-tool-parameters)），该文档已在 [PR #138](https://github.com/AstrBotDevs/AstrBot-docs/pull/138) 中完成更新。
@@ -37,12 +37,12 @@
 
 transfer_to_* 工具现支持以下参数：
 - `input`：转交给子代理的任务输入（必填）
-- `image_urls`（可选）：图片 URL 或本地路径数组，用于多模态任务
+- `image_urls`（可选）：图片 URL 或本地路径数组，用于多模态任务。用户发送给主代理的图片会自动传递给子代理，也可以手动指定 HTTP/HTTPS 公网 URL 或本地文件路径。支持的图片格式包括：png、jpg、jpeg、gif、webp、bmp、tif、tiff、svg、heic。
 - `background_task`：设置任务执行模式
   - 若为 `true`，任务将以后台模式异步执行，主代理立即返回任务 ID，完成后通过后台任务唤醒机制通知用户
   - 若未设置或为 `false`，则为同步模式，主代理等待子代理完成任务
 
-更详细的参数说明和使用示例，请参阅官方 SubAgent 文档的[委派工具参数](https://docs.astrbot.app/zh/use/subagent.html#委派工具参数)章节。
+更详细的参数说明和使用示例，请参阅官方 SubAgent 文档的[委派工具参数](https://docs.astrbot.app/zh/use/subagent.html#委派工具参数)和[多模态图片传递](https://docs.astrbot.app/zh/use/subagent.html#多模态图片传递)章节。
 
 主代理在未启用 SubAgent 编排时，可直接挂载自身工具集（按 persona 规则，默认全部），并直接调用工具。
 

[Accept] [Decline]

Note: You must be authenticated to accept/decline updates.

^{How did I do? Any feedback?}