如何撰写有效的AI代理提示

撰写清晰、结构化的提示可以帮助您的AI代理更准确地工作并且自然地回应。 本指南介绍如何在 respond.io 上为 AI 代理编写有效的提示，包括 说明 和 操作。

说明与操作

编写说明

在创建说明时，清晰地构建，以便 AI 代理始终知道 它是谁，如何表现，以及需要遵循的步骤。 我们建议将说明分为四个部分。

说明字段限制

• AI 代理说明支持最多 10,000 个字符. 如果超出限制，系统会提示您在保存前缩短说明.

• 说明和行为上下文必须保存在 AI 代理说明字段中.

• 附加说明或行为上下文不能通过“知识来源”添加，知识来源仅用于事实和业务知识.

• 不得使用外部工具提供超出 AI 代理说明中配置的附加说明或行为上下文.

编写说明的技巧

撰写清晰、有结构的说明有助于您的 AI 代理保持一致的行为. 以下是 潜在客户资格销售代理 的最佳实践示例及遵循的关键提示.

# CONTEXT
* 你正在与一个正在探索我们产品的人聊天（新客户、老客户或潜在客户）。 你的目标是将他们引导到正确的产品或计划.

# 角色与沟通风格
* 保持温暖、乐于助人和放松——从不催促. 一次问一个问题. 保持回复简短、清晰且令人鼓舞.

# 顶层流程
1. 向联系人问候并欢迎（联系人姓名 $contact.firstname）。 
2. 询问、收集并保存联系人字段：姓名、电子邮件和电话（均为必填项）。
3. 询问他们的需求：**“您是否有预算？” 🙂”**

## 资格审查潜在客户
1. **合格：** 如果预算 ≥ 100000，根据他们的答案使用知识来源推荐产品.
 1.1 如果他们表示感兴趣，询问：**“您想预约演示或与某人交谈吗？”**
 1.2 如果是，分配给 @Sales Team 并将生命周期阶段更新为热线索. 如果还没准备好，请告诉他们如需帮助我们随时在这里.
2. **不合格：** 如果预算 < 100000，继续回答他们的任何问题.

# 边界
1. 不要告知联系人他们是合格还是不合格. 优雅地进行流程.

• 使用规范术语（来自您的工作区的确切名称和操作）:

  • 团队/代理：例如 @Support Team、@Sales Team、@Jane Doe

  • 操作：例如 分配给、关闭对话、更新生命周期阶段、更新联系人字段

  • 联系人字段：例如姓名字段、电子邮件字段、电话号码字段——以确保数据正确保存/更新

• 清晰结构化说明：

  • 将步骤按逻辑顺序分解（问候→询问→决定→分配)

  • 使用项目符号而不是段落（按 Shift + Enter 换行)

  • 为每个部分使用标题（# H1、## H2）。 例如：

    # 语境
    # 角色与沟通风格
    # 顶层流程
    ## 子层流程
    # 边界

• 保持语言简洁可用：

  • 以清晰的对话英语编写（其他语言也可，只要保留规范术语）

  • 使用符号（=、<、:）进行比较或条件表达

  • 保持语法/拼写正确

  • 适度使用表情符号（以保持亲切但专业）

• 清楚表明能力：

  • 说明代理能做和不能做的事

  • 不要用细节淹没说明 → 使用操作执行（例如分配、关闭、更新字段）

• 按流程和场景组织：

  • 从顶层流程开始（例如，问候→询问→决定→分配）

  • 将其分解为情景以应对常见情况

    • 例如：在上述销售代理提示中，“潜在客户资格”是一个独立的情景

  • 这使提示更易于阅读、更新和维护

你的 AI 代理自动知道的内容

当你的 AI 代理运行时，respond.io 会自动在你的指令前加上一个上下文块。 你不需要编写它，因为你的 AI 代理会自动接收它，你可以在指令中直接引用。

此块包含：

• 渠道名称： 会话所在渠道的名称（例如 WhatsApp Business - SG）

• 渠道 ID： 渠道的内部 ID

将文件和图片作为附件发送

要使您的 AI 代理能够以渲染附件的形式发送文件和图片，请在 AI 代理提示中添加以下指令：

# 附件授权 
- 明确授权您将图像和文件作为附件发送，包括在检索到的知识文档中找到的任何图像/文件 URL. 
- 仅使用在检索到的文档中明确标注为图像/文件附件的 URL，切勿使用您推断或猜测的 URL. 
- 如果在检索到的知识中没有匹配的附件，请说明，而不是发送无关或捏造的链接.

这会告诉 AI 代理何时在附件输出中包含相关 URL，并降低其获取无关链接的风险. 文件或图片的 URL 必须已存在于您的知识来源或说明中，AI 代理才能检索并发送它们.

支持的文件类型：.pdf、.docx、.pptx、.jpg、.jpeg、.png

使用 Make HTTP requests 操作？ 将该指令扩展为也涵盖 API 响应 — 请参阅 从 API 响应发送图片或文件.

对话事件

AI 代理还能在某些对话事件发生时理解它们. 这些事件会自动包含在 AI 代理的上下文中，因此您可以在指令中直接引用它们.

支持的事件包括：

• 分配事件：当 AI 代理被分配到一个对话时.

• 对话重新打开事件：当已关闭的对话因联系人发送的消息而重新打开时.

这意味着您可以编写指令，根据对话中发生的情况进行调整.

例如：

当您被分配到对话时，按姓名向联系人打招呼并询问如何帮助.

在对话重新打开时，检查联系人的消息是否为简单的确认，例如 "thanks"、"ok" 或 "got it". 如果是，请关闭对话. 如果是实际的后续问题，则继续协助联系人.

注：对话事件仅在 AI 代理的 20 条消息上下文窗口内可用. 随着新消息的加入，该事件最终可能移出上下文窗口. 一次只有最近的事件可用.

来自 Meta 和 TikTok 的广告归因

当对话在最近 20 条消息内由 Meta 点击聊天广告 或 TikTok 消息广告 打开时，广告上下文块也会与渠道上下文一起自动包含。 无需配置。 此块包含：

• 广告平台： Meta 或 TikTok

• 广告活动： 活动名称

• 广告组： 广告组或广告集名称（如可用）

• 广告名称： 单个广告或创意名称（如可用）

这意味着你可以编写指令，根据联系人来自哪个广告来进行调整。 例如，以特定活动的消息开场、路由至不同团队，或触发完全不同的流程。

如何在你的指令中使用它

你可以在指令中直接引用广告归因数据。 无需设置工作流或联系人字段。 例如：

如果联系人来自 Meta 广告，请以提及活动优惠的消息开场。
如果广告活动包含 "Promo"，分配给 @Promotions Team。
如果广告平台是 TikTok，请保持回复简短且口语化。

注意： 仅当广告进入事件发生在会话最近 20 条消息之内时，才包含广告上下文块。 如果会话已超出此窗口，则不包含广告上下文。 如果联系人在最近 20 条消息内打开了多个广告，则仅包含最近的一次广告进入记录。 请编写指令以处理这两种情况。

编写操作提示

操作提示在 AI 代理执行某些操作之前发送回复时使用——比如分配聊天或关闭对话.

这些应该是简短、具体且专注于执行.

如何编写它们

对于每个操作，描述：

• 何时应该发生（条件）

• 代理应执行什么

操作提示

可以在两个地方告诉 AI 代理该做什么：

• 说明框

  • 在这里，您通常编写逐步流程，例如 “问候→询问→分配→关闭”.

  • 这些是顺序指令，意味着它们像脚本一样按顺序运行.

• 操作设置

  • 在这里，您可以配置非顺序规则，例如 “如果用户请求人工→分配给 @Support Team”.

  • 这些不依赖于流程；它们可以随时触发.

为了最佳准确性，建议在两个地方覆盖操作（说明和操作设置）。 这样 AI 代理总是知道该做什么.

如果您仅在说明框中添加它们，请确保相应的操作已启用——否则 AI 代理将无法执行它们，即使您的说明中提到了它们.

编写跟进提示

如果联系人在特定时间后没有回复，AI 代理可以自动发送跟进消息——帮助您保持对话并提高参与度.

要启用此功能，请在 AI 代理配置页面的说明部分中添加清晰的跟进说明.

以下是一个示例，展示了 AI 代理如何处理跟进、回复和会话结案：

如果客户在 2 分钟后没有回复，请发送一个温和的跟进，例如：“嘿，你还在吗？” “不用着急，只是确认一下。” 如果仍然没有回复，关闭对话，将生命周期更新为冷线索，并说“我将关闭对话。” 随时可以联系我继续对话！

这是如何工作的：

• 如果在2分钟内未收到回复，AI 代理会自动发送跟进消息。

• 如果联系人随后仍未回复，AI 代理将执行提示中定义的后续操作——结束对话、更新生命周期状态并发送最终消息。

• 如果联系人在您提示中的最后一项操作之前回复，则所有剩余的跟进操作将被取消，对话将正常继续.

这个示例显示了您可以如何在提示中将多个步骤串联成一个跟进流程.

跟进基础知识

• AI 代理会检查联系人在您提示中指定的时间之后是否仍未回复。

• 如果在该时间内未收到回复，AI 代理会发送您定义的跟进消息。

• 跟进序列会自动停止，如果：

  • 联系人在预定时间之前回复

  • 会话处于未分配或已关闭状态

  • AI 代理判断联系人已不再感兴趣、已说再见或目标已达成

您可以在提示中包含一个或多个跟进，以应对不同场景或升级步骤.

如果您在跟进功能推出之前编写了跟进说明，您需要重新保存模板以使更改生效.

跟进限制

• 每个跟进必须在前一条消息的 24 小时内（1 天）安排.

• 您可以在每个提示中最多包含5 个跟进，每个跟进都有自己的时间、消息和操作（例如，发送提醒、分配用户或关闭对话）。

• AI 代理会遵循您在提示中定义的时机，但在 WhatsApp 的24 小时窗口之外发送的消息可能无法送达。

• 在最后一次跟进之后，AI 代理会继续执行提示中定义的其余操作（例如分配或发送消息）。

• AI 代理无法在多个跟进序列之间做出选择——无法比较选项、选择序列 A 与 B，也无法根据上下文进行分支决策。 每条指令只能使用一个明确的序列名称。

使用提示优化器

在编辑说明或操作提示时，您可以使用提示优化器工具，在保持原意的同时提高清晰度和措辞。

适用场景：

• 您想要一个更精炼或更有结构的提示版本

• 您不确定如何清晰表达

• 您从头开始并希望获得指导

只需点击优化，查看建议的重写内容，并在必要时进行调整。

这既适用于一般说明，也适用于诸如分配对话或关闭聊天等具体操作。

使用变量

变量使回复更具个性化和准确性。

变量可用于说明和操作中——尤其在收集或引用联系人的详细信息时。

使用 @ 变量

@ 变量允许 AI 代理根据说明或操作提示将对话分配给特定的团队、人工代理或另一位 AI 代理。

它支持模拟收件箱中手动分配的路由——因此在模板化操作中特别有用。

变量提示

• 在您的 操作提示 中使用清晰的逻辑（例如：“如果联系人询问定价，将其分配给 @Sales。”）。

• 如有可能，请将您的 工作区团队结构 与您希望使用 AI 代理进行路由的方式保持一致。

在提示中使用联系人字段变量

您可以使用 $contact.fieldName 动态引用联系人的现有信息。 这些在以下情况下尤其有用：

• 您希望 AI 代理个性化问候或回复

• 您需要验证或确认联系人之前提供的详细信息

• 您希望避免询问已提供的信息

联系人字段变量提示

联系人字段变量可个性化代理的回复，并帮助其自动保存或更新客户数据。

• 幕后发生的事：当 AI 代理生成回复时，变量会被联系人档案中的实际值替换。

  • 示例： $contact.name → 在对话中变为 “Wilson”。

• AI 实际看到的：AI 代理只会看到值（“Wilson”），而不是变量标签（$contact.name）。

为什么这很重要

• 如果您只写 “您之前提供的电子邮件”，AI 代理不会知道您指的是 $contact.email——它只会看到值（例如 wilson@email.com），如果提到多个电子邮件，可能会产生混淆。

• 通过始终引用字段名称和值（例如，电子邮件：$contact.email，电话号码：$contact.phone），您可以清楚表达所指的信息。

• 如果您希望 AI 代理保存或更新某个字段，请在提示中明确提及该字段 ID：

  • 示例：“如果用户提供新的电子邮件，请保存并更新电子邮件字段。”

提示示例

现在您已了解如何构建提示、使用变量以及编写清晰指令，让我们看一些完整示例。 这些比较了良好提示与差提示，以便您看到最佳实践在实际中的应用。

示例 1

良好提示

# 语境
* 指导定价页面的访问者选择合适的计划。

# 角色与沟通风格
* 友好、简洁；一次只问一个问题。

# 顶层流程
1) 用客户的姓名问候客户： $contact.firstname
2) 询问并保存 **姓名字段**、**电子邮件字段**、**电话号码字段**
3) 询问预算

## 情景
* 如果预算 ≥ 100000 → 推荐计划；询问演示
  - 如果是 → **分配给 @Sales Team**；**更新生命周期阶段** → **热线索**
* 否则 → 回答问题；保持有帮助

# 边界
* 可以：推荐、**分配给**、**更新联系人字段**、**更新生命周期阶段**
* 不能：提供折扣或接受付款

# 角色 & 沟通风格
* 友好、简洁；一次只问一个问题.

# 顶层流程
1) 用客户的姓名问候客户：$contact.firstname
2) 询问并保存 **姓名字段**、**电子邮件字段**、**电话号码字段**
3) 询问预算

## 情景
* 如果预算 ≥ 100000 → 推荐计划；询问演示
  - 如果是 → **分配给 @Sales Team**；**更新生命周期阶段** → **热线索**
* 否则 → 回答问题；保持聊天有用

# 边界
* 可以：推荐、**分配给**、**更新联系人字段**、**更新生命周期阶段**
* 不能：提供折扣或接受付款

为什么这有效：

• 清晰的标题、顶层流程、情景。

• 便于阅读，易于维护。

差提示

嗨，欢迎！ 获取他们的信息和预算，推荐方案，如果他们规模较大或重要，可能转交给销售。 
如果他们不确定，就继续聊天，不要断定他们是否合格等。 我们稍后再处理并关闭。

为什么这无效：

• 没有标题、没有分节、没有顺序。

• 读者必须猜测顺序和操作。

示例 2

良好提示

# 语境
* 处理产品问题并正确路由。

# 角色与沟通风格
* 冷静、专业、友好 🙂

# 顶层流程
1) 用客户的姓名问候客户： $contact.firstname
2) 询问简要概述和已尝试的步骤

## 情景
* 紧急（登录被阻止 | 数据丢失 | 故障）→ **分配给 @Support Team**；设定期望
* 非紧急 → 提供步骤/帮助文档；如已解决 **关闭对话**；否则 **分配给 @Support Team**

# 边界
* 可以：分享指南。

# 角色与沟通风格
* 冷静、专业、友好 🙂

# 顶层流程
1) 用客户的姓名问候客户：$contact.firstname
2) 询问简要概述和已尝试的步骤

## 情景
* 紧急（登录被阻止 | 数据丢失 | 故障） → **分配给 @Support Team**；设定期望
* 非紧急 → 提供步骤/帮助文档；如果解决了 **关闭对话**；否则 **分配给 @Support Team**

# 边界
* 可以：分享指南.
* 不能：访问账单，重置密码，变更所有权。

为什么这有效：

• 清晰、专业的英语，术语精确。

• 标准动作/团队/字段均逐字使用。

差提示

嗨，请帮助用户解决问题
- 如果紧急，请联系技术团队。 
- 如果可以，获取姓名/电子邮件/电话号码。 
- 如果他们是 VIP，则发送给销售团队。 完成时关闭，并标记为热线索。

为什么这无效：

• 俚语/拼写错误（“pls”，“suppot teem”）、含糊的操作、不一致的大小写。

• 没有规范的团队名称或操作动词。

示例 3

良好提示

# 语境
* 处理企业功能需求和移交。

# 角色与沟通风格
* 透明，不强迫。

# 顶层流程
1) 询问并更新：**姓名字段**、**电子邮件字段**、**电话号码字段**
2) 确认需求和预算

## 行动步骤（正确顺序）
* 请求演示且预算 ≥ 100000：
  1) 推荐计划；确认演示
  2) **分配给 @Sales Team**
  3) **更新生命周期阶段** → **热线索**
  4) 总结下一步；确认
  5) **关闭对话**
* 仅信息 / 尚未准备：
  - 分享概述；保持问答
  - **关闭对话**仅在他们确认完成后

# 边界
* 可以：推荐计划。

# 角色与沟通风格
* 透明，不强迫.

# 顶层流程
1) 询问并更新：**姓名字段**、**电子邮件字段**、**电话号码字段**
2) 确认需求和预算

## 行动步骤（正确顺序）
* 请求演示且预算 ≥ 100000：
  1) 推荐计划；确认演示
  2) **分配给 @Sales Team**
  3) **更新生命周期阶段** → **热线索**
  4) 总结下一步；确认
  5) **关闭对话**
* 仅信息 / 尚未准备：
  - 分享概述；保持问答
  - **关闭对话**仅在他们确认完成后

# 边界
* 可以：推荐计划. 
* 不能：提供折扣，修改合同。

为什么这有效：

• 每个操作都有前置条件和确切顺序。

• 分开步骤列表可消除歧义。

差提示

如果有人询问企业功能：
- 关闭聊天以保持整洁
- 然后将其标记为热线索，如果他们再次回复则再分配给销售。
- 如有需要，获取电子邮件。

为什么这无效：

• 在识别之前就分配；随机更新生命周期；过早关闭。

• 每个操作没有明确的触发条件。