创建自定义 Agent

1 什么是自定义 Agent？

自定义 Agent 是你为某个工作区或文件夹定义的专属助手。它适合有固定规则、语气、背景或重复流程的任务。

比如你可以让它遵守这些说明：

• “始终用简洁的产品文案风格写作。”
• “作为这个主题的研究助手。”
• “审查计划并指出遗漏风险。”
• “维护这个代码项目，解释改动时要清楚直接。”

2 从界面创建

1. 打开目标文件夹

   选择这个 Agent 要服务的 workspace 或子文件夹。

2. 选择 Add Custom Agent

   点击文件夹 + 菜单，或右键文件夹，选择 Add Custom Agent。

3. 编辑 Agent 文件

   OpAgent 会创建 Agent 文件并自动打开。你可以修改名称、描述和具体工作说明。

4. 保存文件

   保存后，工作区刷新时会显示这个自定义 Agent。

5. 用小任务测试

   先让它完成一个很小的任务。如果结果不理想，继续修改说明后再试。

3 一个简单示例

你可以保留自动生成的文件，只修改可读内容。一个简单 Agent 可以这样写：

---
name: Product Writing Agent
description: Helps write clear product notes and release announcements.
tags: user
---

You are a product writing assistant for this workspace.

When helping:
- write in clear, direct language;
- prefer short paragraphs and concrete examples;
- ask one clarifying question if the goal is unclear;
- keep the final answer easy to paste into a Markdown document.

4 怎么写好说明？

好的 Agent 说明应该短而具体。

建议包含：

• Agent 扮演什么角色；
• 主要帮助哪类工作；
• 偏好的语气、格式和输出方式；
• 不应该做什么。

尽量避免：

• 互相冲突的长规则；
• 密钥、token 或隐私凭证；
• “写好一点”这种没有标准的模糊要求。

5 之后再连接 Skill 或 Tools

一开始先只写说明。等 Agent 的角色稳定后，如果你的流程确实需要，再添加 Skill 或 Tools。

保持简单，会更容易调试和长期使用。