菜单导航

技术文档
智能体高效沟通与用词指南
技术文档

智能体高效沟通与用词指南

NoiseNoise
2026-04-01

智能体高效沟通与用词指南

目标:让管理员用更少轮次拿到“可执行结果”(改代码、调页面、搭流程、排故障)。

1. 四段式提问模板(推荐)

每次提问尽量包含这四段:

  1. 目标:你要达成什么

  2. 约束:不能动什么/权限限制是什么

  3. 输出:你希望交付什么(代码、步骤、文档、脚本)

  4. 验证:如何判断完成(页面表现、接口返回、日志指标)

示例:

目标:修复扩展侧边栏打不开
约束:默认仍用浮窗,不删除现有功能
输出:直接改代码并更新文档
验证:点击图标可打开,切侧边栏有提示且不报错

2. 高效用词清单

2.1 更容易触发“执行型”响应的词

  • 直接改按这个修补到 README加文档做成可导入给验证步骤

  • 先最小改动不要重构保持兼容给回滚点

2.2 更容易触发“排障型”响应的词

  • 先定位根因给链路看持久化查权限边界查是否回读

  • 有无降级是否影响主链先止损再彻修

2.3 更容易触发“自动化型”响应的词

  • 给可运行工作流给参数预设给重试退避给监控报警

  • 先草稿不自动发布支持人工复核

3. 常见场景提问模板

3.1 报错修复

修复这个报错:<报错原文>
影响:<哪个页面/接口>
约束:<不能影响哪些模块>
请直接改代码并给验证步骤。

3.2 页面样式与交互优化

目标:<UI问题>
设备:PC + 手机 + 暗黑模式都要适配
约束:不改业务逻辑
请最小改动并说明文件位置。

3.3 工作流搭建

把<联合搜索/采集>接入工作流并自动化
要求:先候选池再草稿,不自动发布
给:参数、阈值、重试、监控、报警、验证步骤。

3.4 权限问题

角色是<admin/editor/author/subscriber>
我要做<动作>
请明确:页面层是否可见、接口层是否可写、替代路径是什么。

4. 让智能体“主动修改并落地”的指令

当你希望它不只解释、而是直接动手,建议明确写:

  • 直接实施并验证,不要只给方案

  • 改完后告诉我影响范围与回滚方式

  • 如果有多个方案,选最小风险方案先落地

  • 不要引入新依赖,优先复用现有结构

5. 如何减少来回沟通

  • 一次性给出:当前现象、期望结果、是否允许改文档/脚本/配置

  • 明确“优先级”:先可用再完美,先止损再优化

  • 明确“完成定义”:例如“lint通过 + 页面行为正确 + 文档更新”

6. 常见低效表达(建议避免)

  • “帮我优化一下” (范围不清)

  • “好像有问题” (缺少现象与路径)

  • “你看着改” (没有约束和验收标准)

更好写法:

  • “这个按钮在暗黑模式看不清,保留现有布局,仅修样式并兼容手机端”

7. 对话即入库触发词(后台角色)

以下触发词可直接沉淀知识:

  • 记住:... / 学习:... / 提交:...

  • 保存指令:...

  • 保存流程:...

  • 保存模板:...

  • 反馈:... / 错误:...

建议写法:

保存流程:
标题:联合搜索自动化(科技资讯)
正文:触发->检索->去重->评分->候选池->计划->草稿
约束:不自动发布,失败重试2次,退避15分钟

版权声明

本文为「Noise」原创内容或编译整理;除特别说明外,文中图片并非个人手绘,可能来源于网络、AI 生成、截图等,后期使用 PhotoMator / Procreate 进行处理,仅用于学习与交流。如涉及版权或来源标注不全,请联系处理。未经授权,禁止用于商业用途,禁止抹除水印。转载请注明出处与链接并保留本声明。

...

评论 (0)

评论功能加载中...
Noise

Noise

执迷不悟

推荐阅读

宝藏阁智能体对外接入与OpenClaw集成指南
技术文档

宝藏阁智能体对外接入与OpenClaw集成指南

Nose | 2026-04-01

本指南详细说明如何将Noise宝藏阁智能体对外接入,支持OpenAI兼容API、前台嵌入和OpenClaw集成。提供多种接入方式,包括外接模式和iLink内置直连,涵盖对话、知识检索、内容生成等能力,并给出安全和运营建议。

2
宝藏阁计划任务模块使用说明
技术文档

宝藏阁计划任务模块使用说明

Nose | 2026-04-01

计划任务用于定时触发站内的自动化执行。项目中所有“定时能力”统一复用同一套调度器,一分钟上手(3步创建 + 1步验收)
在 /admin/automation 建一个 workflow目标设为 publish,平台先选 site + wechat + zhihu

2
MCP / Skill 服务接入说明
技术文档

MCP / Skill 服务接入说明

Nose | 2026-04-01

本文档详细指导将本站MCP和Skill服务接入其他AI平台。包括服务地址(/api/mcp和/api/skills)、鉴权方式(Bearer令牌),以及MCP工具,如搜索文章、获取站点统计、调用超级智能体。提供curl调用示例和Skill拉取方法,方便快速集成。

1