Agent 配置

一句话总结：Agent 是「角色 + 工具白名单 + 模型偏好」的组合，决定它在会话中能做什么、看到什么、按什么风格回答。

什么时候新建一个 Agent

• 想创建一个专门做 Code Review / 巡检 / 文案的 Agent。
• 想限制某个 Agent 不能动 bash 或网络。
• 想给团队开放一个 Agent 但不暴露 system prompt。

新建一个最小可用 Agent

1. 设置 → Agent → 新建。
2. 填名称、描述、icon。
3. 写 system prompt（建议含「角色定位 / 工作目标 / 输出要求」三段）。
4. 选择启用工具（默认全选）。
5. 设置可见性（公开 / 私有）。
6. 保存即可在新会话中选择。

写 system prompt 的三段式

• 默认以「你是 …」开头，明确角色。
• 后接「核心目标」与「输出格式」。
• 避免在 prompt 中硬塞机器配置——交给 Memory 和 Skill。

工具白名单：默认全开还是收紧

内置工具集合包括但不限于：

• bash：执行 Shell 命令（支持 attached 桌面模式，详见 桌面端高级）
• write / read / edit：文件读写
• web_search：用户级搜索（参见 LLM 与凭据）
• todo_write：维护 Agent 自己的 todo
• memory_recall / memory_write / memory_update：访问长期记忆
• skill：加载 host-local Skill 的指令体
• ask_user_question / notify_user：交互式提问与通知

默认全选；按任务收紧白名单以降低误触。

增益提示（Agent Prompt Boost）

管理员在 Admin 后台维护「全局增益提示模板」，所有启用 Agent 共享。 用户也可定义自己的全局模板（叠加在管理员模板之后）。 每个 Agent 通过显式开关决定是否注入；默认开启。

公开 / 私有 / 内置可见性

• 公开：所有用户可见。
• 私有：仅自己可见。
• 内置：管理员创建，普通用户可使用但看不到 system prompt。

首屏 Agent 与个人标签

每位用户可为任意可见 Agent 维护个人标签、首屏开关。 聊天入口默认仅展示「首屏 Agent」，并支持一键切到「全部 Agent」。

风险与边界

相关

• LLM 与凭据
• Skill 速览
• 子代理编排