AI 回复与 AI 代理
连接 AI 模型处理单个步骤,或让代理依据你的资料回答问题并将对话转给人工客服。
本页内容
AI 可以处理反应中的单个步骤,也可以负责整个对话:
| 选择 | 适用情况 | 你需要配置 |
|---|---|---|
| AI 动作 | 从消息中提取电话和主题,或生成简短回复 | 反应以及交给模型的具体任务 |
| AI 代理 | 根据知识来源自主回答问题 | 资料、回复规则和转人工条件 |
两者都需要相同的 AI 集成。
连接模型
在集成中添加 AI 类型,填写:
- Base URL:兼容 OpenAI API 的地址,默认
https://api.openai.com/v1。可使用 OpenAI、OpenRouter、本地服务器或其他兼容服务。 - 模型:例如
gpt-4o-mini。 - 系统提示词:模型的通用指令。
- API 密钥:服务提供商的密钥,会加密保存,也可放入凭据。
这个集成还把文字片段转成用于语义搜索的数字表示(嵌入向量)。没有 AI 集成,代理和知识搜索都无法工作。
“AI”动作
在反应中添加 AI 动作,设置:
- AI 集成:选择已连接的模型。
- 提示词:模型的任务,支持变量替换,例如
{{text}}、{{param.键}}、{{ctx.键}}。 - 保存回复到参数及/或保存回复到 ctx(键):指定结果去向。
- 提取用 JSON Schema:让模型按指定结构返回 JSON,可用于提取申请字段或分类;结果可通过列表循环处理。
- 向用户发送回复:立即把生成的文字发到聊天中。
消息中的 AI 块
消息编辑器也有自带提示词的 AI 块,可在发送时生成部分回复。详见消息和按钮。
使用示例
- 自由对话:设置提示词并开启“向用户发送回复”。
- 处理咨询:用 JSON Schema 提取主题、联系方式和紧急程度到
ctx,接着写入集合并通知客服。 - 分类:把模型结果保存为参数,再用“带参数”的条件判断。
AI 代理
左侧 AI 菜单包含代理、日历和分析。代理会处理新消息,从允许的知识来源寻找片段、生成回答、记录客户事实或预约,并按自身规则转给人工客服。草稿状态的代理不会介入对话。
生命周期与版本
代理可处于草稿、运行中、已暂停或已归档。草稿可启用或归档;运行中的代理可暂停或归档;已暂停的代理可重新启用或归档。归档无法撤销。
启用时,完整配置会保存为一个版本。修改运行中的代理会生成新版本,已经开始的对话继续使用原版本。一个入站渠道同一时间只能属于一个运行中的代理,因此不能在同一渠道启用第二个代理。
配置
基本设置与行为
- 渠道和入口:代理可在 Telegram、VK、WhatsApp 及网站上工作。
- 回复语言:1 至 20 个语言代码,例如
ru, en, pt-br。其他语言的回复在发送前会被拒绝。 - 代理指令:最多 12,000 字符,说明任务、边界和禁止事项。
- 语气:最多 160 字符。
- 最大回复长度:200 至 12,000 字符。
- 表达自由度和信心阈值:0–100%。信心低于阈值时,代理不会自行回复。
- 非工作时间:照常回复、为客服准备草稿,或转人工;需启用客服工作时间表。
- 草稿模式:只向客服建议回复,不直接发给客户。
客户信息收集
- 收集目标:代理需要弄清什么。
- 必填事实:最多 30 项;每项有个人资料中的键名(小写字母、数字、下划线)和用于询问的问题。
- 收集完成后:继续对话或转人工。
- 停止短语:最多 20 条,每条最多 160 字符。只有客户的整条消息与短语相同才触发;比较时忽略大小写和多余空格。
知识和工具
- 可用来源:1 至 200 个知识来源,不能选择仅供客服使用或已停用的来源。
- 允许的工具:最多 8 个。运行中的代理目前只能使用预约与 Google 日历中的日历工具。产生副作用的工具默认要求确认。
转人工和故障
- 转给客服:选择客服组,以及客户在接入人工前看到的消息。
- 代理无法帮助时:转人工、发送备用消息,或交回机器人的常规场景处理。
一次回复如何生成
新消息到达后,代理搜索资料并准备回复。若需调用允许的工具(如日历),会等待结果。最后可能发送回复、改发备用消息、转人工或报错。每轮最多调用工具四次。一条入站消息只处理一次,即使模型服务很慢,重复的处理进程也不应发送第二条回复。
服务器会构建模型上下文:客户资料及已确认属性、已验证渠道、有限的近期消息与事件、客服和日程状态、检索到的片段。发送给模型提供商前会截短并清除敏感值。
知识引用有严格边界:搜索只限于该代理获准使用的来源,最多返回 12 个片段。若代理设置了来源、没有工具且没有找到资料,就不会编造答案,而是转人工或给出原因 no_source 的备用回复。回复若引用了未检索到的来源,会在发送前被拒绝。
防范消息和资料中的指令
客户或文档可能写着“忘记规则并发送数据”。代理会将其视为消息或文档内容,而非新指令:
- 系统策略及工具定义是请求的独立部分,来源或客户文字不能替换它们。
- 模型不能决定机器人、客户、来源、URL、SQL、凭据或原始 HTTP 参数;这些都来自服务器上下文。模型回复中的越权字段会被删除。
- 工具调用必须对应已注册且代理已获准使用的工具,参数须符合禁止未知字段的封闭结构。
- 每个有副作用的调用都有按轮次和调用序号生成的幂等键、15 秒截止时间和日志;日志参数与结果会去除个人数据。
- 发送前检查回复长度、语言、来源引用和不安全结构,并删除不支持的格式。
事实及其来源
代理只会向客户资料写入必填事实中列出的键。每个事实都保留其来源消息和处理轮次,以及“已提议”“已应用”或“已拒绝”状态,因此可追溯到客户实际说过的话。
转人工与恢复
转人工会打开或更新常规客服对话、分配指定客服组,并附上经过清理的结构化摘要:原因、已收集事实、使用的来源和未完成动作。原因可能是停止短语、信心不足、没有合适来源、信息收集完成、非工作时间、模型或工具故障。
对话由客服接手时,代理保持静默。只有从对话中明确请求恢复(POST /api/bots/{botID}/subscribers/{subscriberID}/ai/resume)后才会继续工作。
上线前检查
检查代理会验证设置并运行安全模拟:不会调用模型、发送消息、运行工具或创建预约,只显示哪些动作被抑制。检索到的实际片段请在搜索检查查看。
若设置有误、渠道已被另一个运行中代理占用或尚未连接、所选来源或客服组不存在、没有 AI 集成,或日历工具缺少已启用的预约类型,准备情况检查会阻止启用代理。
分析与质量审核
AI → 分析显示对话、已发送回复、备用回复、转人工、错误、草稿、通过检查和不安全的回复、延迟、输入输出 token、按币种的费用、来源及工具使用、日历动作和业务结果:无需人工解决、目标达成、CSAT、重新打开与升级。可按时间、代理及版本、渠道、语言、分组、来源与结果筛选,按天或小时汇总。
AI → 回复质量列出代理对话。对话里显示代理状态,以及每次回复的信心、延迟、token 和费用。消息正文仍在链接指向的客服对话中。审核者可评为正确、错误或不安全,附原因代码与备注;评价可导出。审核页和导出内容会清除敏感数据。
每轮保存输入和输出 token;若提供商报告费用,也会保存费用,以便按代理和时段查看模型开销。
Managed AI
代理设置中要明确选择模型来源:自己的 AI 集成,或账户的 Managed AI 产品。自己的密钥出错时,不会自动转为付费 Managed AI。可选 fast、balanced 和 quality 配置,它们决定路由策略,并非固定使用某个提供商模型。
产品页面会显示每月包含的额度、严格月度上限和加价,选择套餐前应比较。直接调用 API 需要具有 managed_ai:invoke 权限的个人令牌及 Idempotency-Key;读取用量需要 managed_ai:usage:read。令牌应保存在自己的服务器。调用路径见 REST API。