写给 Agent Builder 的提示词模式与实战示例
为什么要讲提示词
Agent Builder 的输出质量在很大程度上取决于你怎么描述需求。官方文档里给出了三个被反复验证能显著提升结果的提示词模式：
模式一：陈述业务规则，不止是说动作
| ❌ 差的写法 | ✅ 好的写法 |
|---|---|
| "加一个退款 Flow" | "加一个退款 Flow，30 天窗口，只允许原支付渠道退款" |
| "改一下预订 Flow" | "预订 Flow 里，周六周日只开放 18:00 之后的时间" |
业务规则给 AI 提供了边界条件。它不会问你"退款窗口几天？"——因为你已经告诉它了。这样它生成的配置更接近可以直接用的状态，你只需要 review 细节而不是从零改。
模式二：一次一个单元的工作
每次请求只做一件事——一个 Flow、一组相关 Topics、一个集成配置。这有三个好处：
- 更容易 review：改动集中在一个区域，出了问题一眼就能定位
- 更容易回滚：如果这一组改动有问题，只需要回滚这一个 Branch
- AI 理解更准确：范围小了，AI 的推理链更集中，不容易遗漏或混淆细节
如果需求比较大（比如"把整个预订流程重写一遍"），可以拆成几次请求："先加一个预订 Flow 骨架" → "加一个改期 Flow" → "加一个取消 Flow" → "把三个 Flow 串起来"。
模式三：明确说要保留什么
对于改写和清理操作，显式点名"这些东西别动"。比如：
"把现有 FAQ 话题里关于退款的内容合并成一个话题，其他所有话题保持不变。"
"把预订 Flow 里从第 3 步开始的所有步骤重构，但保留第 1、2 步的逻辑完全不变。"
如果你不说，AI 可能会在"优化"过程中顺手改掉一些你不希望改的东西。点名保留项是一个好习惯。
实战提示词模板
新建 Flow
Build a dental-clinic appointment booking Flow. Greet, collect new vs existing patient, preferred date/time, confirm availability. If fully booked, suggest nearest alternative. Route urgent concerns to staff. Don't quote prices.改写话题
Update the "Store hours" topic to reflect new summer hours: Mon-Fri 9:00-19:00, Sat-Sun 10:00-17:00. Keep all other topics unchanged.写测试用例
Add 5 simulation test cases for the existing billing Flow. Cover: full payment, partial payment, wrong card, expired card, and dispute initiation.分析模式（Ask）
Analyze the conversation logs from yesterday. What are the top 3 topics that users asked about but my agent couldn't answer well?常见坑
- 用模糊的形容词："让智能体更友好" → AI 不知道具体改什么。换成"在欢迎语里加上'我是今天的语音助手 Emma'"。
- 一次塞太多事："加退款 Flow、改欢迎语、更新所有 FAQ、加 3 个集成" → 输出质量会大幅下降。
- 忘了业务参数："加一个预订 Flow" → AI 会问你一堆问题（几个人？营业时间？最大预订人数？）。提前告诉你就省了来回。