Agent 创建与编辑

Agent 是 Cell 内的次级隔离单元，拥有独立的认知配置。你可以为不同场景创建专属 Agent，定制它们的行为、工具和知识范围。

什么是 Agent

在 wesclaw 中，一个 Cell（对应你的账号/工作区）可以包含多个 Agent。每个 Agent 共享 Cell 的物理资源（记忆、知识库、Provider），但拥有独立的：

• 系统提示词（Prompt）
• 工具白名单（可使用哪些工具）
• 技能过滤（启用哪些 Skill）
• 模型偏好

创建 Agent

在联系人页面点击"新建 Agent"，填写以下关键配置：

基础信息

• 名称：Agent 的显示名称，如"写作助手""代码审查员"
• 描述：简短说明 Agent 的用途
• 头像色调：用于在界面中区分不同 Agent

系统提示词

系统提示词定义了 Agent 的角色和行为准则。建议包含：

• Agent 的角色定位（"你是一位专业的法律顾问"）
• 回答风格偏好（"使用简洁的要点式回答"）
• 领域约束（"只回答与合同审查相关的问题"）

提示词在会话生命周期内保持稳定，不会被中途修改（保护 Prompt Cache）。

工具配置

• Skills 白名单：nil 表示可使用全部技能，空数组 [] 表示不使用任何技能
• 双层过滤：Cell 级 DisabledEngineSkills × Agent 级 Skills 白名单，AND 生效

编辑已有 Agent

在联系人页面选择目标 Agent，进入详情页可修改所有配置。修改在下次新会话中生效。

注意：修改 Agent 配置不会影响已有的活跃会话。为保护 Prompt Cache，当前会话的系统提示词在整个生命周期内保持不变。

Agent 的记忆隔离

每个 Agent 在记忆层中拥有独立的命名空间（agent://agent-id/*）：

• Agent 记忆归属于 agent_memory 层
• 不同 Agent 的记忆互不可见（除了共享通道）
• Cell 级的共享记忆（environment、consensus、about_me）对所有 Agent 可见

预装 Agent

wesclaw 默认提供一个通用助手 Agent，适合日常对话。你可以：

• 直接使用默认 Agent 开始聊天
• 创建专业领域的 Agent（写作、翻译、分析等）
• 为不同工作场景配置不同 Agent

最佳实践

1. 职责单一：每个 Agent 专注一个领域，而不是创建一个"万能"Agent
2. 提示词精练：避免过长的系统提示词，聚焦核心指令
3. 工具最小化：只授权 Agent 需要的工具，减少不必要的干扰
4. 善用记忆：让 Agent 通过记忆工具积累领域知识，而不是把所有知识写进提示词

相关文档

• 技能管理 → skills.md
• 记忆层模型 → memory-layers.md
• Provider 配置 → provider-setup.md
• 对话技巧 → conversation-tips.md