FAQ
调用返回 [echo] 开头的回答?
说明该对话落到了平台兜底适配器:租户/平台默认渠道尚未配置真实模型商 Key,
或上游全部失败后兜底接管。处理:控制台 LLM 渠道 → 建渠道(选厂商、填真实 Key)
→ 平台池渠道「设为默认」或将其绑定到智能体。回复带 [echo] 前缀便于识别,
计费口径中 echo 不计 tokens。
402 quota exceeded?
两种情况:①开放 API 返回 402 = 本月 tokens 配额用尽(网关按 (租户×渠道×模型) 实测用量累计, 次月自动恢复);②控制台创建资源返回 402 = 设备/渠道等资源配额满。 都在控制台「套餐与配额」看进度条,平台管理员可在「租户管理」调套餐即时生效。
多轮对话怎么保持上下文?
开放 API:请求带 session_id(任意字符串),同一 ID 自动注入最近 6 轮历史
(滑窗,服务端保存);不传则无状态。设备语音链路天然按设备会话保持,
环境变量 OA_HISTORY_TURNS 可调轮数(0 关闭)。
开放 API 401,但密钥明明没吊销?
确认三点:用的是 key_secret(不是 key_id);请求头名是 X-API-Key;
密钥属于目标租户。签发时的 secret 只显示一次——丢失就在控制台吊销重签。
租户自配的模型 Key 什么时候生效?
即时。渠道保存后,绑定该渠道的智能体下一句对话就走新 Key(网关渠道注册表 30 秒内刷新)。 无需重启任何服务。
一个设备可以换绑智能体吗?换绑后立刻生效吗?
可以。控制台「设备」行内改绑定即保存;解析缓存 60 秒内切换,之后的新会话按新智能体执行 (提示词/知识库/模型渠道同步切换)。
答案里的引用(citations)是什么口径?
知识库检索命中的文档切片:{citation:"[1]", doc:"文件名", page:页码/小节}。
检索无命中或未绑知识库时 citations 为空数组,回答为纯 LLM 生成。
安全策略会拦截什么?
两层:输入命中注入特征(正则,平台可配)→ 拒答并转人工(审计记 refusal+handoff); 输出命中敏感词 → 打码后返回。对话全量落审计(问题/回答/类型),可在控制台「对话审计」检索。
协议会破坏性升级吗?
v1 冻结后只允许追加可选字段(向后兼容);破坏性变更升 v2 并双轨运行。 三副本 Schema(协议/SDK/网关)一致性由审计脚本持续校验。
数据在哪儿,如何备份?
控制台/商业数据在 console.db,知识库在 rag.db(SQLite,按租户行级隔离); 备份即文件拷贝。企业版提供 PG 模型(RLS)与私有化交付。