Agents - Neotask by Neotask Documentation | Neotask

代理

什么是代理？

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

代理隔离

每个代理拥有：

工作空间 -- 用于文件、笔记和代理特定数据的专用目录

会话 -- 独立的对话历史和记录

配置 -- 模型选择、工具权限、支出限额

身份 -- 在代理的 AGENTS.md 文件中定义的唯一角色

认证配置 -- 按代理的 API key 和认证配置

代理角色

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

多代理路由

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

频道绑定 -- 将来自某个平台的所有消息路由（例如，所有 Telegram 消息路由到 personal 代理）

服务器/工作区绑定 -- 将特定的 Discord 服务器或 Slack 工作区路由到专用代理

聊天类型绑定 -- 将私信路由到一个代理，群消息路由到另一个代理

联系人/对等绑定 -- 将来自特定联系人的消息路由到特定代理

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

子代理与委托

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

任务委托 -- 将复杂任务分解并将部分委托给专门的子代理

隔离执行 -- 子代理在自己的会话上下文中运行

乒乓对话 -- 代理之间可以进行来回交流（最多 5 轮）以协作

结果公告 -- 子代理的结果可以发布回原始频道

团队与编排

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

并行执行 -- 同时在任务的不同方面运行多个代理

顺序流水线 -- 链式代理，每个代理在前一个输出的基础上构建

混合模式 -- 结合并行和顺序执行

任务跟踪 -- 监控每个代理的工作状态（排队中、运行中、已完成、错误、已取消）

工具配置

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

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

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

安全模式

安全模式提供执行沙箱：

主开关 -- 全局启用或禁用

按代理控制 -- 为受信任的代理禁用，为其他代理保持开启

执行审批 -- 敏感操作需要明确的用户批准

策略同步 -- 设置在所有连接的客户端之间实时同步

代理记忆

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

MEMORY.md -- 跨会话持久保存的笔记和重要信息

记忆文件 -- memory/ 中的额外结构化知识

向量搜索 -- 使用自然语言查询搜索记忆

详见会话与记忆。

View full documentation