# 代理

## 什么是代理？

代理是隔离的 AI 助手，能够推理问题、执行任务并跨多个平台进行通信。每个代理拥有自己的工作空间、会话历史、模型配置和频道绑定。

## 代理隔离

每个代理拥有：

- **工作空间** -- 用于文件、笔记和代理特定数据的专用目录
- **会话** -- 独立的对话历史和记录
- **配置** -- 模型选择、工具权限、支出限额
- **身份** -- 在代理的 `AGENTS.md` 文件中定义的唯一角色
- **认证配置** -- 按代理的 API key 和认证配置

## 代理角色

每个代理的工作空间包含一个 `AGENTS.md` 文件，定义了个性、指令和行为准则。这个持久的系统提示决定了代理如何响应 -- 语调、领域专长、格式、工具使用和安全策略。

## 多代理路由

运行多个代理时，入站消息根据**绑定**自动路由：

- **频道绑定** -- 将来自某个平台的所有消息路由（例如，所有 Telegram 消息路由到 `personal` 代理）
- **服务器/工作区绑定** -- 将特定的 Discord 服务器或 Slack 工作区路由到专用代理
- **聊天类型绑定** -- 将私信路由到一个代理，群消息路由到另一个代理
- **联系人/对等绑定** -- 将来自特定联系人的消息路由到特定代理

绑定按优先级顺序评估。第一个匹配项获胜。未匹配的消息发送到默认代理。

## 子代理与委托

代理可以为专门任务生成子代理：

- **任务委托** -- 将复杂任务分解并将部分委托给专门的子代理
- **隔离执行** -- 子代理在自己的会话上下文中运行
- **乒乓对话** -- 代理之间可以进行来回交流（最多 5 轮）以协作
- **结果公告** -- 子代理的结果可以发布回原始频道

## 团队与编排

多代理团队支持协调工作流：

- **并行执行** -- 同时在任务的不同方面运行多个代理
- **顺序流水线** -- 链式代理，每个代理在前一个输出的基础上构建
- **混合模式** -- 结合并行和顺序执行
- **任务跟踪** -- 监控每个代理的工作状态（排队中、运行中、已完成、错误、已取消）

## 工具配置

控制每个代理可以做什么：

| 配置 | 可用工具 |
|---------|----------------|
| **minimal** | 仅会话状态 |
| **coding** | 文件 I/O、执行、会话、内存、图像 |
| **messaging** | 消息发送、会话历史 |
| **full** | 所有工具（默认） |

可以为每个代理和每个模型提供商设置自定义允许/拒绝列表。

## 安全模式

安全模式提供执行沙箱：

- **主开关** -- 全局启用或禁用
- **按代理控制** -- 为受信任的代理禁用，为其他代理保持开启
- **执行审批** -- 敏感操作需要明确的用户批准
- **策略同步** -- 设置在所有连接的客户端之间实时同步

## 代理记忆

每个代理都有访问记忆系统的权限：

- **MEMORY.md** -- 跨会话持久保存的笔记和重要信息
- **记忆文件** -- `memory/` 中的额外结构化知识
- **向量搜索** -- 使用自然语言查询搜索记忆

详见[会话与记忆](sessions-memory.md)。