AI 代理功能强大,但有一些平台层面的限制需要注意。请使用下方推荐的变通方法,以确保你的 AI 代理表现稳定可靠。
提示:与受支持的 AI 代理功能和限制相冲突的指令在您保存或发布时会被自动标记。
了解有关 如何审核 AI 代理指令。
对话可见性
AI 代理对对话的元数据、历史记录和内部上下文的可见性有限。
渠道和来源元数据
AI 代理会自动接收基础渠道上下文,包括渠道类型、渠道名称和渠道 ID。通过恰当的指令,你的 AI 代理可以利用这些信息调整回复长度、格式、语气和行为,以适应不同渠道。
来自 Meta 和 TikTok 的广告归因
当对话由 Meta 点击聊天广告 或 TikTok 消息广告 发起时,你的 AI 代理会自动接收到一个广告上下文块,与渠道上下文一并提供。无需配置。此块包含:
广告平台: Meta 或 TikTok
广告活动: 活动名称
广告组:广告组或广告集名称(如可用)
广告名称:单个广告或创意名称(如可用)
这意味着你可以编写指令,根据联系人来自哪个广告来进行调整。例如,以特定活动的消息开场,路由至不同团队,或触发不同的会话流程。
注意: 仅当广告进入事件发生在会话最近 30 条消息之内时,才包含广告上下文块。如果会话已超出此窗口,则不包含广告上下文。如果联系人在最近 30 条消息内打开了多个广告,则仅包含最近的一次广告进入记录。请编写指令以处理这两种情况。
需注意的限制:
渠道和来源的上下文均在较高层面提供。虽然你的 AI 代理会自动接收结构化元数据(例如广告平台、活动和广告名称),但无法获取广告的实际内容。你仍需编写指令,告诉你的 AI 代理根据该上下文应执行什么操作,以及广告的内容是什么。
AI 代理不会自动接收来源元数据,除非对话由 Meta 或 TikTok 的付费广告发起(会提供上述广告上下文块)。
推荐的解决方法:
如果你的用例需要了解联系人在付费广告之外的来源,请使用工作流捕获广告内容等信息,并将其存储到联系人字段中。
例如:
创建一个以对话已打开为触发器的工作流
根据渠道或来源添加条件
更新联系人字段,例如 线索来源 或 活动名称
然后你可以在 AI 代理的指令中要求其引用该联系人字段。这可确保行为的一致性和可靠性,即使渠道或来源详情无法自动获取。
渠道感知行为示例提示
你可以通过明确指示 AI 代理在不同渠道中的行为,来引导其调整回复。以下是一些你可以使用的示例:
调整回复长度与语气
如果此对话发生在 Instagram 或 TikTok 上,回复应简短(1–3 句),友好且具有对话性。避免冗长的解释。如果此对话发生在 WhatsApp 上,可以提供更详尽的回复,但要保持简洁、易读。如果此对话通过电子邮件进行,请使用更结构化且正式的语气。可以接受较长的解释和格式清晰的回复。控制格式与内容
在 TikTok 上回复时请勿分享链接,除非联系人明确要求提供。通过电子邮件回复时,可根据需要包含链接、要点和逐步说明。基于渠道的行为与升级
如果对话发生在 Instagram 或 Facebook 上,且联系人询问计费、付款或账户相关问题,请立即升级至人工客服。如果对话发生在 WhatsApp 上,请先尝试基本故障排除再升级,除非联系人明显感到沮丧。指代对话时
在提及联系人发送消息的位置时,请使用“此聊天”或“此对话”。切勿明确提及渠道名称。任务分配可见性
当 AI 代理被分配到对话时,会收到一个分配事件。这可帮助 AI 代理了解它刚被分配,并决定下一步操作。
当 AI 代理由以下方式分配时适用:
人工坐席
工作流
另一位 AI 代理
这意味着您现在可以指示 AI 代理根据分配事件采取行动。例如,您可以要求它:
在被分配到对话时,向联系人打招呼。
获取联系人数据或根据指示路由对话。
如果联系人已明确说明其问题,则将对话路由到正确的团队。
当 AI 代理 1 将对话分配给 AI 代理 2 时,继续交接。
示例提示:
当您被分配到对话时,向联系人打招呼并检查其最新消息。如果联系人已明确说明其问题,则将对话路由到正确的团队。否则,询问如何提供帮助。需注意的限制:
分配事件仅在 AI 代理被分配时适用,不适用于人工坐席或团队被分配的情形。
当 AI 代理被取消分配或移除时不适用。
该事件仅在 AI 代理的 30 条消息上下文窗口内可用。
如果在同一对话中发生多个事件,AI 代理只能获得最近的事件。例如,如果配置了工作流以在对话重新打开时分配 AI 代理,则会保留分配事件,因为它发生在重新打开事件之后。
对话重新打开感知
当已关闭的对话因联系人发来消息而重新打开时,AI 代理会收到对话重新打开事件。
这有助于 AI 代理判断联系人是在回复已有对话,而不是发起新对话。
这意味着您现在可以指示 AI 代理基于对话重新打开事件采取行动。例如,您可以要求它:
识别联系人何时回复已关闭的对话。
对类似 “thanks”、“ok” 或 “got it” 的简单确认消息做出不同的回应。
如果联系人发送了真实的后续问题,则继续提供帮助。
需注意的限制:
当暂停期到期且没有新的联系人消息到达时,重新打开事件不适用。
如果在同一对话中发生多个事件,AI 代理只能获得最近的事件。例如,如果配置了工作流以在对话重新打开时分配 AI 代理,则会保留分配事件,因为它发生在重新打开事件之后。
该事件仅在 AI 代理的 30 条消息上下文窗口内可用。
示例提示:
在对话重新打开时,检查联系人的消息是否为简单的确认,例如 "thanks"、"ok" 或 "got it"。如果是,请关闭对话。如果是实际的后续问题,则继续协助联系人。通过外部工具分配
当通过外部工具 — 例如 Developer API, n8n, 或 Make.com — 将 AI 代理分配到对话时,分配本身不会触发 AI 代理回复。
这是预期的行为。 Respond.io 限制此行为,以防止在通过自动化同时分配多个对话时 AI 代理进行批量回复。
分配后,该对话将显示为已分配给 AI 代理。但是,AI 代理不会主动发送消息。一旦联系人发送消息,AI 代理就会回复。
注意: 此限制暂无解决方法。
取消分配后的回复行为
当 AI 代理被取消分配时,通常会发送最后一条回复,以在交接前自然结束对话。这是预期的行为。
是否发送此回复取决于时机:
如果取消分配是由外部触发,例如工作流、Dev API 或手动重新分配:
如果发生在 AI 代理开始回复之前,则会跳过该回复。
如果发生在 AI 代理开始回复之后,通常会发送该回复。
如果 AI 代理通过自身的 AI 功能取消分配,或触发会取消其分配的工作流,该回复仍会发送。
推荐的解决方法:
选项 1:在取消分配后阻止 AI 代理回复
在取消分配指令之前,将以下指令添加到 AI 代理的说明中:
不要生成回复。将 "response" 对象保留为空。注意: 选择此项时,联系人将完全不会收到任何结束消息。
选项 2:使用工作流发送交接消息并阻止 AI 代理回复(推荐)
创建一个工作流,包含一个 发送消息 步骤,随后是一个 取消分配 步骤。
将选项 1 中相同的不回复指令添加到 AI 代理中。
这会产生一条单一且受控的交接消息,并在取消分配顺利完成时保持 AI 代理静默。联系人会收到一致的交接消息,无论时机如何。
注意: 两种解决方法都适用于外部工作流触发的取消分配场景。对于由 AI 代理触发的工作流取消分配,选项 1 是阻止 AI 代理回复的唯一方法,因为在工作流触发之前回复总是会被发送。
内部上下文和消息历史
AI 代理无法查看内部评论,并且在对话中只能访问最近的 30 条消息。
因此,在做决策时,AI 代理不应依赖渠道来源、内部备注或较早的对话上下文。
建议的变通方法:
将重要上下文存储在联系人字段或生命周期阶段中,并指示 AI 代理改为引用这些字段。
例如:
使用工作流或人工流程来保持诸如计划类型、客户状态或问题类别等字段的最新状态
使用生命周期阶段(例如:新线索、合格线索、客户)来指导代理的响应方式
在你的 AI 代理指令中,明确引用这些字段(例如,“如果生命周期是 客户,优先提供与支持相关的回应。”)
这可确保 AI 代理即使在无法访问较早消息或内部评论的情况下,也能使用可靠的结构化数据做出一致的决策。
被回复的消息
AI 代理无法看到联系人所回复的消息。当联系人使用回复功能引用之前的消息时,AI 代理只会收到新的来信消息,而不会收到被回复的原始消息。
无论被回复的消息是新还是旧,此规则均适用。即使被引用的消息位于最近 30 条消息之内,AI 代理也无法查看该引用消息。
因此,当联系人回复较早的消息并假定 AI 代理了解整个对话线程时,AI 代理可能会给出不完整或语境错误的回复。
推荐的解决方法:
在 AI 代理的指令中加入提示,当消息缺乏上下文时要求联系人重新陈述其请求。当人工坐席接手时,请在回复前手动查看被回复的消息。
注意: 正在考虑支持将被回复消息传递给 AI 代理的功能。投票或关注 回复消息支持功能请求 以跟踪进展。
Instagram 故事回复
AI 代理会读取 Instagram 故事回复的文本。当联系人回复你的 Instagram 故事时,AI 代理会接收到 [Reply to story],随后是回复文本,并能基于上下文进行回应。
AI 代理无法查看故事的图片或视频。如果联系人回复您的 Instagram 故事但未输入任何文字,AI 代理将没有可读取的文本。
建议的变通方法:
在 AI 代理指令中写明:当收到无文本的故事回复时,询问联系人指的是什么。
外部能力
AI 代理主要在 respond.io 内运行,但现在可以使用AI Skill: Make HTTP requests与外部系统交互。这允许 AI 代理调用外部 API 以检索实时数据或触发第三方系统中的操作。
在此了解有关 AI Skill: Make HTTP requests 的更多信息。
消息类型与附件
AI 代理可以将文件和图片作为实际附件直接发送到对话中并呈现。当 AI 代理的回复包含有效的文件或图片 URL 时,会将该文件作为实际附件发送——与人工坐席和工作流当前发送文件的方式相同。
图片文件(.jpg、.jpeg、.png)以内联预览形式显示
文档文件(.pdf、.docx、.pptx)以带有文件名和类型的文件卡片显示
所有附件会出现在对话的“附件”选项卡中
请勿将文件或图片本身上传为知识源。我们建议将您的文件或图片托管在 文件:
转到 工作区设置 > 数据设置 > 文件.
点击 添加文件 上传文件或图片。

在操作菜单中使用 复制文件 URL。
将 URL(或多个)粘贴到您的 AI 代理的知识源或指令中。例如:
宣传册 PDF: https://cdn.respond.io/files/25313/51576/1786066690015/brochure.pdf
平面图 png 图片: https://cdn.respond.io/files/25313/51576/1786066712501/floor_plan.png
菜单 jpg 图片: https://cdn.respond.io/files/25313/51576/1786066701311/menu.jpg
将以下指令添加到 AI 代理提示中:
# 附件授权 \n- 明确授权您将图像和文件作为附件发送,包括在检索到的知识文档中找到的任何图像/文件 URL。
- 仅使用在检索到的文档中明确标注为图像/文件附件的 URL,切勿使用您推断或猜测的 URL。
- 如果在检索到的知识中没有匹配的附件,请说明,而不是发送无关或捏造的链接。使用 Make HTTP requests 技能?在 API 响应中返回的图片或文件 URL 可以以相同方式作为附件发送 —— 参见 从 API 响应发送图片或文件。
局限性:
支持的文件类型:.pdf、.docx、.pptx、.jpg、.jpeg、.png —— 其他 URL 类型将保留为纯文本
本次发布不支持需登录的受限 URL(私人 Google Drive、Dropbox)
每次 AI 代理回复最多 5 个附件 —— 超过的 URL 将被丢弃
当知识源中存在复杂 URL 时,AI 的准确性可能会有所波动(已知限制)
视频、语音备注、贴纸及其他富媒体仍不受支持
对于不支持的文件类型或需登录的资源,请使用一个工作流步骤或将其指派给人工坐席。
减少误生成或错误附件的最佳实践:
使用简单的 URL —— 避免长查询字符串或重定向链。
为每个项提供唯一且清晰标注的 URL —— 相近的 URL 会让 AI 混淆(例如 image001.png、image010.png)。
避免使用 URL 缩短服务、重定向或需登录/CAPTCHA 的链接 —— 这些链接无法作为附件呈现。
仅在代理的指令中添加触发指令,不要放在知识源内——混合使用可能导致不可预测行为。
AI 代理可读取的消息类型
无论这些消息是由联系人发送还是由您的企业发送,AI 代理都会读取其内容。无需配置。
消息类型 | AI 代理读取的内容 |
|---|---|
文本 | 完整文本,逐字呈现 |
图片、PDF | 图片或文档本身,以及描述 — 最多包含联系人发送的最近 5 个文件 |
音频 | 在可用时提供转录文本 |
地点 | 地址,以及经纬度 |
联系人名片 | 名字、姓氏和电话号码 |
Instagram 故事回复 | 回复文本 |
电子邮件 | 主题行、正文以及所有附件的文件名。图片和 PDF 附件的读取方式与聊天附件相同 |
卡片 | 标题、副标题和按钮标签,按卡片编号 |
快速回复 | 消息标题,以及提供的所有选项 |
视频、文件、贴纸 | 仅文件名 |
WhatsApp 和 Messenger 模板 | 头部文本、已填充参数的正文以及按钮标签。轮播卡片逐个读取 |
WhatsApp 目录产品 | 产品名称、价格和描述。产品列表逐项读取 |
WhatsApp 订单 | 每项商品的数量、产品名称和单项价格,以及订单总额 |
WhatsApp 列表或按钮回复 | 联系人所选选项的标题 |
反应 | 表情,或已被移除 |
企业发送的消息会被标记为由您的企业发送。这让您的 AI 代理能将其之前发送的消息与联系人所说的内容区分开来。在发送轮播后,AI 代理即可理解诸如“第二个”之类的回复。在一组快速回复后,诸如“都不是”之类的回复也适用。
局限性:
视频、文件和贴纸只会以文件名的形式读取。您的 AI 代理无法观看视频、读取非 PDF 文档或解析贴纸的图像
Instagram 故事的提及不会传递给您的 AI 代理,故事回复的图片或视频也不会传递给它
您的 AI 代理只能读取反应的表情(emoji),无法读取联系人所引用的消息
社交帖文和从评论到私信的上下文不会传递给您的 AI 代理
通过开发者 API 或自定义渠道发送的自定义负载不会传递给您的 AI 代理
注意: 您的 AI 代理仍可能要求联系人重新发送或重新表述现在可读取的内容。从指令中移除这些请求。保留任何用于处理上述限制的指令。了解有关 如何审核 AI 代理指令。
接收不受支持的消息
当联系人发送的消息类型为 respond.io 无法处理时,AI 代理会在会话历史记录中收到 [Unsupported message] 信号。这适用于社交帖文和从评论到私信的上下文、Instagram Story 提及,以及自定义负载 — 详见上述限制。
这意味着 AI 代理现在能够识别何时收到不受支持的消息,并据此做出响应。您也可以编写指令以自定义 AI 代理如何处理这些情况。
处理不受支持消息的示例提示:
请联系人以文本形式重新发送:
如果收到 [Unsupported message],回复:"看起来我无法接收您上一条消息。您能改以文本消息发送吗?"忽略并不采取任何操作:
如果收到 [Unsupported message],请不要回复。等待联系人下一条消息。确认但不提及该限制:
如果收到 [Unsupported message],回复:"我无法查看该消息类型。请随意描述您的需求,我很乐意提供帮助!"模型配置
AI 代理不支持手动的温度设置,因为较新的 AI 模型不再暴露温度控制。
如果你想调整 AI 代理的“创造性”(类似于温度),最佳方法是在你的指令中直接提示它。例如,你可以根据用例引导 AI 表现得更富创造性或更为严格。
高创造性(更高的“温度”):
以客户的语气热情且富有创造性地回应。低创造性(更低的“温度”):
仅使用提供的公司知识来源和对话历史来回答客户的问题。不要猜测或添加新信息。这使你在无需专用温度设置的情况下,更好地控制语气和一致性。
静默模式(仅后台任务)
在某些用例中,您可能希望 AI 代理执行后台任务,例如更新联系人字段、添加标签或更新生命周期阶段,而不向联系人发送任何消息。
默认情况下,AI 代理在每个回合都会生成回复。若要禁止所有外发消息,请将以下提示添加到 AI 代理的指令顶部:
# CORE 规则:禁止回复政策(强制)- 您在任何情况下都不得生成或发送任何面向用户的消息(不得问候、不得提问、不得确认)。- 如果系统需要响应负载,仅返回空响应(例如,response: "")。不要包含任何其他文本。使用场景:
您的 AI 代理仅用于对对话进行分类(例如,根据消息内容更新标签或联系人字段)
在交接给人工坐席或另一个 AI 代理之前,您的 AI 代理执行路由或分配逻辑
您的自动化流程需要 AI 代理作为决策步骤,但面向联系人的回复由其他环节处理
重要注意事项:
将禁止回复的指令放在指令的最顶部,以确保其优先于所有其他提示。
发布前务必在 测试对话 中进行测试,因为 AI 代理可能仍会根据其他指令的复杂性偶尔生成回复。
如果您的 AI 代理也使用 AI 功能(例如,分配给代理或团队、关闭会话),这些功能仍会照常运行——只有文本回复会被抑制。
当 AI 代理被分配到对话时,人工坐席的消息编辑器将被禁用。这意味着您不能在手动回复联系人的同时,使用静默 AI 代理执行后台任务。
常见问题与故障排除
如果 AI 代理找不到匹配的生命周期阶段 / 联系人字段 / 结案说明 / 团队 / 用户,会怎样?
如果参数不完全匹配,更新将失败。始终在您的指令中提供确切的阶段名称、联系人字段名称、结案说明类别、团队/用户名。
您需要 AI 代理方面的帮助吗?
我们的支持团队随时为您提供帮助。
