write-operations.md 2.6 KB

写操作工具(mcp__gateway__fwhops__*)

只在勾选了 fwhops 服务的配置中提供。每次调用都会弹出审批卡片,由用户确认后才执行;被拒绝时停止该操作,按用户给出的原因调整,不要换个方式绕过。

工具以服务账号身份执行,业务系统中记录的操作人是“AI 助手”,不是当前用户。

工具 用途 规则
feedback_create 在 Plane 创建问题反馈 / 需求 调用前先向用户摘要标题、类型(bug / feature)、优先级和描述;描述中写清背景、复现步骤或期望效果
tou_template_save 新增或更新测试服 TOU 模版 只支持测试服;先按 tou-template.md 的规则构建并自检(时段覆盖整天、日类型成对、数值类型正确),向用户摘要“新增/更新、模版名、地区、策略与关键时段”,保存后用 mcp__gateway__fwh__tou_template_get(env=test)回读核对
site_info_refresh 触发站点信息表从 FWH 平台重新同步 见下方“站点信息同步”

站点信息同步

同步在主服务后台执行,约 1 小时,可能超过 1.5 小时。site_info_refresh 以长任务方式执行:工具会先检查同步状态再决定是否触发,不会重复触发。

  1. 用户要求同步:直接调用 site_info_refresh(不带 force)。
    • 触发了新同步,或已有同步在进行(改为跟踪它):工具立即返回“已转为后台执行”。告诉用户已提交、需要较长时间、完成后 site_search 才会更新,然后结束这一轮。同步结束后平台会把结果作为新消息发给你(完成时间、站点数、耗时,或失败原因),收到后向用户汇报。不要轮询。
    • 未触发:最近 24 小时内已成功同步(skipped_fresh),或上次同步超过 6 小时未完成、疑似中断(skipped_stale)。把原因和数据截至的时间告诉用户;用户确认仍要同步时,再调用 site_info_refresh 并设置 force=true。
  2. 用户只问数据是否最新、同步进度如何:用只读工具 mcp__gateway__fwh__site_info_sync_status(无需审批),按 advice 回答,不触发同步。
  3. 结果为失败:说明失败原因,询问用户是否稍后重新同步;不要自动重试。

通用规则:

  1. 调用前在回复中说明将要写入什么、写到哪个环境,再调用工具(审批卡片会同时显示参数)。
  2. 写操作失败时把错误原样告诉用户,不要自动重试。
  3. 没有这些工具时,告诉用户当前配置不支持修改数据,可以到 ToolBox 对应页面操作。