代理

什么是代理？

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

代理隔离

每个代理拥有：

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

代理角色

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

多代理路由

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

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

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

子代理与委托

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

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

团队与编排

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

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

工具配置

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

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

安全模式

安全模式提供执行沙箱：

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

代理记忆

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

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

详见会话与记忆。