实践指南：AGENTS.md 操作规则模板与示例

操作规则约定怎么做——步骤、工具约束、日期算法。在操作规则页编辑（对应 AGENTS.md）。人格与语气请在人格页。

来源 help/guides/agents-md-templates.md

表述：操作规则 约定 怎么做——步骤、工具约束、日期算法。在 操作规则 页编辑（对应 AGENTS.md）。人格与语气请在人格页。

平台每轮会注入 当前时间与时区；是否用它解析「最近 N 天」、如何调接口，由你在此写明。

模板 1：相对日期 + 技能接口（CRM / 报表类）

## 日期与范围

- 以【运行环境】中的 **当前时间** 为「今天」，时区与注入行一致。
- 用户说 **「最近 N 天」**：指 **含今天** 共 N 个自然日。
  - end_date = 今天（YYYY-MM-DD）
  - begin_date = 今天往前数 N−1 天（YYYY-MM-DD）
- 用户给出明确起止日期时，以其为准，不再套用「最近 N 天」。
- 技能正文里的示例日期 **仅作格式参考**，不得当作实时查询范围。

## 查询步骤

1. 先根据上文算出 begin_date / end_date（若用户已给出则跳过）。
2. 打开与本工作区相关的 **技能说明**，按其中步骤调用 `http_request`。
3. 仅依据工具返回的 JSON 向用户说明结果；未调用成功时不要声称已查到。
4. 对用户用简短自然语言给出日期范围与结论。

## 缺信息时

- 无法确定 N、或接口必填项缺失：先追问，不要编造日期或数据。
- 本工作区未开通联网请求：说明需管理员开通，并提示用户改给具体日期或导出材料。

模板 2：只许用技能内接口（防编造）

与写在哪里：决策与案例中深度案例一致，可直接粘贴：

## 联网与接口

- **禁止** 自行编造 URL、路径、请求体字段名。
- 需要调业务接口时：**必须先** 阅读与本任务相关的 **技能** 正文，仅使用其中声明的：
  - 基础 URL / 路径与方法
  - 必填与可选参数
  - 鉴权占位符（如 `{{CRM密钥}}`）
- 使用 `http_request`；**仅依据** 返回 JSON 陈述结果。
- 无匹配技能、调用失败或权限不足：如实说明，**不要** 虚构成功结果。

## 失败时

1. 向用户说明失败类型（无技能 / 网络 / 4xx / 5xx）。
2. 若技能要求重试或换参数，按技能说明执行；否则请用户补充信息或联系管理员。

模板 3：多步任务清单（无联网）

## 通用步骤

1. 复述用户目标，确认缺失信息。
2. 若需查团队口径，先检索 **工作区知识文档** 或 **智能体知识文档**。
3. 输出前自检：是否逐步可执行、是否引用了未提供的文件或数据。

## 禁止

- 跳过用户确认的约束条件。
- 将示例文档中的虚构公司名当作真实客户。

模板 4：记忆与知识的使用顺序

## 信息来源优先级

1. 本轮工具返回与技能步骤
2. 工作区 / 智能体 **知识文档** 中的明确口径
3. **操作规则**（本文）
4. **长期记忆** 中的个人偏好（不得与 1、2 冲突）
5. 模型常识（仅在前述均无覆盖且用户允许推断时使用，并标明「推断」）

若记忆与知识文档冲突，以 **知识文档** 为准，并提示用户更新过时记忆。

模板 5：脚本执行失败时的自动修复（Excel / Office）

适用于已开通 脚本执行、需 run_script 产出 xlsx/docx 的智能体。可直接粘贴到 操作规则 页。

## 脚本执行与 Excel 产出

- **三层工具**：skill_update 只改 Markdown；skill_script_read / skill_script_write 改 scripts/*.py；run_script 执行脚本。
- run_script 参数通过 input 对象传入；脚本读全局 input 与 output_dir，产物须写入 output_dir 才会出现在 output_files。
- run_script 失败：读 error_code；python_not_found → 需后端 Python；missing_packages → pip 镜像或 requirements.txt。
- ok:true 但 output_files 空：skill_script_read 查脚本是否用 output_dir，勿声称已成功。
- 改进流程：skill_script_read → skill_script_write → skill_update（## 脚本执行）→ run_script 验证（同任务最多 2 轮）。
- 可自动：调 input、重试、skill_script_write、CSV 降级；须先问用户：装系统软件、改 PATH、非白名单 pip 包。

Web 端快捷填入