Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
astrbot-doc-agent wants to merge 1 commit into
base: v4
Choose a base branch
from
Open

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

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 10 additions & 1 deletion en/use/subagent.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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).
Expand All @@ -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.
17 changes: 13 additions & 4 deletions zh/use/subagent.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 应该只负责一类相关的任务（如：搜索、文件处理、智能家居控制）。
Expand All @@ -53,4 +62,4 @@ SubAgent 编排是 AstrBot 提供的一种高级 Agent 组织方式。它允许
SubAgent 系统目前是**实验性功能**，未稳定。

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