AI 机器人
应用详情的“AI 机器人”用于创建和管理机器人、查看回复统计,以及把机器人添加给用户。机器人怎样工作、怎样接入你的模型,见 AI 对话。
平台不调用模型,也不保存模型密钥:用户给机器人发消息后,平台回调你的服务,你的服务调用模型并用服务端 SDK 把回复流式写回。页面顶部的“接入方式”和“规则”卡片概括了这些要点。
权限
| 操作 | developer | admin / owner |
|---|---|---|
| 查看机器人列表、详情、统计和最近的回复 | 可用 | 可用 |
| 创建、修改、启用 / 停用、删除机器人,添加给用户 | 不可用 | 可用 |
添加给用户会以机器人的身份建立好友关系,需要再次验证身份。
创建机器人
点“创建机器人”,填写:
| 项目 | 说明 |
|---|---|
| 用户名 | 机器人的 IM 用户名,不能与已有用户重复,创建后不能修改 |
| 昵称 | 用户看到的名字,如“智能客服”;以后在“IM 用户”页修改 |
| 回调地址 | 用户给机器人发消息时回调的地址;不指定时使用订阅了 ai.message_received 的地址。地址在回调配置中管理 |
| 备注 | 只在控制台显示 |
| 高级设置 | 附带的上下文(0~50 条,默认 10)、无内容超时(10~300 秒,默认 60)、同时生成的回复上限(默认 1000) |
机器人创建后就是应用中的一个 IM 用户:可以被加好友、被拉黑,不能登录,不能入群,只在单聊中回复。加好友方式为“直接通过”。每个应用最多 100 个机器人。
机器人列表
列表显示每个机器人的状态、回调地址、今日回复数和正在生成的回复数,可以按昵称或用户名搜索。顶部汇总机器人数(启用和停用各多少)。
- 停用:用户仍能给它发消息,但平台不再回调你的服务,也不能开始新的回复;停用前正在生成的回复不受影响。可以随时启用。
- 删除:机器人的 IM 用户一并删除,正在生成的回复以“生成中断”结束,已有的消息保留。删除后不能恢复。
机器人详情
点机器人进入详情,有三个标签:
- 统计:近 7 天或近 30 天每天收到的消息和回复数,按已完成、已停止、生成中断分开,以及平均首字延迟、平均生成时长、生成中断率;可以切换图表和表格。按 UTC 日期统计,只用于展示,不参与计费。
- 最近的回复:最近 100 条回复的用户、开始时间、状态、首字延迟、时长、结束原因和模型,可以按状态筛选;记录保留 30 天,内容以消息为准。
- 配置:修改回调地址、备注和高级设置;昵称和头像在“IM 用户”页修改。
添加给用户
用户要先和机器人成为好友、或者主动给它发消息,机器人才会出现在会话列表中。在详情页点“添加给用户”,每行填一个用户名,一次最多 1000 个:
- 直接成为双方好友,不需要用户同意;
- 可以勾选“同时发一条欢迎语”,以机器人的身份发送,机器人会出现在用户的会话列表中;
- 结果显示添加成功和失败的数量。
要移除好友或拉黑,到“IM 用户”页操作。也可以在你的服务端用添加好友的接口批量添加。
