加载中…

系统设置

系统设置集中管理企业级的偏好与企业信息,影响整个企业的使用体验。

进入 系统管理 → 系统设置。

对话、绩效考核、知识学习、培训等各自使用不同模型,请到 模型接入 查看当前来源;对话默认模型在该页对具体模型点「设为活跃」。

偏好设置

流式输出 (Streaming)

  • 开启:AI 逐字回复(打字机效果);
  • 关闭:一次性返回全部内容。

智能对话历史条数

载入多轮上下文时,最多使用最近 N 条用户 / 助手消息(各占一条)。可调范围 1~50,默认 20。

对以下场景均生效:

  • 控制台「智能对话」
  • 网页组件
  • 开放 API

开启追问

开启后,每轮对话会二次请求生成「追问信息」与信息完整百分比提示。

展开后可配置:

  • 补充信息阶段 · System 提示词:二次请求发给模型的 system 全文(角色、语气与 JSON 输出规则);
  • 与「智能体模板 · 补充信息阶段 User 模板」分工:system 定规则,user 拼摘要 / 问题 / 主答复。

仅关键词命中时生成补充信息

  • 关闭:每轮都跑第二阶段(追问 JSON);
  • 开启:仅当用户问题含指定关键词之一才跑第二阶段(省 Token)。

关键词每行一个或逗号分隔,最多 30 个,每个不超过 64 字;匹配不区分英文大小写。开启过滤但列表为空时,视为未配置,仍会每轮追问。

非工作时段人工客服自动回复

开启后,客户在设定的「非工作时段」(北京时间)触发人工客服时,会自动收到预设话术:

  • 不影响正常转人工:人工若在线仍可继续回复;
  • 全渠道生效:网页组件、公众号、开放 API 等均生效;
  • 按会话节流:同一会话在间隔时间内不重复发送。

可配置:

项 说明
起始 / 结束时间 支持跨零点(如 23:00 → 07:00)
节流间隔(分钟) 同会话重复触发的最小间隔
自动回复话术 最长 1000 字

允许推送时段

外部业务系统通过开放 API 下发的通知(如合作到期提醒),只在这些时段内发到客户群,时间按北京时间解释。

  • 默认时段:09:00–11:00、14:00–17:00;点「恢复默认」可回到这两段,保存后生效;
  • 时段外提交:通知不会丢,会排到下一个时段内的随机时刻发出;
  • 紧急通知:标记为「紧急」的通知不受时段限制;
  • 不设任何时段:删除全部时段并保存,表示通知随时可发(包括深夜)。

配置规则:

规则 说明
时间粒度 起止时间只能选整点或半点
不能跨零点 每段的结束时间须晚于起始时间;如需覆盖夜间,请拆成两段
不能重叠或首尾相连 例如 09:00–11:00 与 11:00–12:00 首尾相连,不能保存,请合并成一段 09:00–12:00
修改即时生效 保存后,已排队但尚未发出的通知也按新时段执行

仅企业管理员可保存本配置。

停用推送:本配置只管「什么时候发」,不管「能不能发」。如需停用推送通知,请到下方「开放 API 权限」关闭「推送通知」。停用后,业务系统无法再下发通知,已排队但尚未发出的通知也会停止发送,重新启用后不会自动恢复。

开放 API 权限

用于按能力类细粒度控制开放 API(/api/v1/*)与 MCP 服务(/mcp)的调用范围,避免「只要有一个有效 API Key,就能调用全部开放接口」的安全风险。

不受本配置管控:网页组件(/api/widget/:token/*)、企微 H5 嵌入等走 widget_token / 企微会话鉴权,与开放 API 白名单无关;组件虽可关联 API Key 用于统计与转人工,但访客对话不依赖 v1 鉴权,也无需把该 Key 加入下方白名单。

进入 系统设置 → 开放 API 权限,对以下六类能力分别配置:

能力类 覆盖接口
AI 会话 POST /api/v1/chat、GET /api/v1/human-replies
知识库写入 POST /api/v1/knowledge/entries、PUT /api/v1/knowledge/entries/:id
服务绩效议题 GET /api/v1/wework/qa/issues(列表与详情)
合作客商写入 POST /api/v1/wework/partner-companies/import
推送通知 GET /api/v1/rooms、POST /api/v1/notifications、GET /api/v1/notifications/{biz_msg_id}
MCP 接入 允许该 Key 经 MCP 服务(POST /mcp)调用工具;各工具的开关在 MCP管理 中按 Key 设置

配置方式

  1. 打开对应能力类的启用开关;
  2. 在下方多选允许调用该能力的 API Key(须为开放 API / API 设置中激活中的密钥);
  3. 点击 保存开放 API 权限。

每一类能力独立配置:例如可只给「内部 H5」Key 开放 AI 会话,给「数据同步」Key 开放服务绩效议题,互不影响。

校验规则

保存后,调用方除通过常规 x-api-key + x-customer-code 鉴权外,还须满足:

  • 该能力类已启用;
  • 当前 API Key 已被选入该能力类的授权列表。

否则请求将被拒绝(HTTP 403),例如:当前 API Key 未被授权调用「AI 会话」接口。

兼容模式

若当前企业从未保存过本配置,系统仍按兼容模式运行,页面会显示黄色提示。兼容模式下:

  • AI 会话、知识库写入、服务绩效议题三类照旧放行:任意有效 API Key 均可调用(与历史行为一致);
  • 合作客商写入、推送通知、MCP 接入三类默认拒绝:须在本页启用该能力并选择 API Key、保存后方可调用。

首次保存后即按上述规则严格校验;若某能力类已启用但未选任何 Key,该类接口将全部不可用。

兼容模式下打开本页时,页面已按兼容放行范围为 AI 会话、知识库写入、服务绩效议题三类预先勾选全部有效 Key。只开通「MCP 接入」后直接保存,这三类接口的原有调用方不受影响。

MCP 接入与写入类工具

  • MCP 接入只决定哪些 Key 能连上 MCP 服务。每个工具还要求该 Key 同时具备工具对应的能力类:「知识检索」「智能体问答」需「AI 会话」,「新增知识」需「知识库写入」,「可推送群列表」「推送通知」需「推送通知」。工具开关在 MCP管理 中按 Key 设置。
  • 保存时若某个 Key 被移出「MCP 接入」「知识库写入」或「推送通知」(取消勾选或整类关闭),该 Key 已开启的相关写入类工具(「新增知识」「推送通知」)会被自动关闭。保存前页面会弹出确认框,逐个列出受影响的 Key 与工具,确认后才保存;之后重新授权不会自动恢复,需到 MCP管理 重新开启。
  • API Key 被停用时,它的写入类工具同样会被自动关闭,重新启用后不自动恢复。

删除 API Key

在 API设置 删除某个 Key 时,系统会自动把它从全部能力类(含 MCP 接入)的授权列表中移除,并清除它在 MCP管理 中的工具开关;某能力类因此不再有任何 Key 时,该能力类会被同时关闭(避免下次保存时提示「已启用但未选 Key」)。之后新建的 Key 不会继承被删 Key 的任何授权,需要重新勾选。被删 Key 的 MCP 调用记录会保留,仍可在 MCP管理「调用记录」中查看。从未保存过本配置的企业不受影响,仍按兼容模式运行。

说明

  • 本配置为企业级,仅约束 /api/v1/ 开放 API 与 /mcp MCP 服务的调用;
  • 网页组件、企微 H5 嵌入等渠道不在管控范围内(见上文说明);
  • 仅列出激活中的 API Key 供选择;已暂停或已注销的 Key 无法被授权;
  • 售前线索接口 POST /api/v1/wework/sales-lead 另有 IP 白名单限制,不在上述六类能力范围内。

单号查询设置

供企微群 / QQ 群的「单号查询」取数用,两个渠道共享同一份配置,不必分渠道各配一遍。渠道侧的开关分别在企微机器人的「API 配置」弹窗和 QQ 机器人的实例编辑弹窗里。

立刻云服务地址

必填。立刻云分「云服务版」与「私有化版」两种部署形态,地址格式不同:

部署形态 需要填
云服务版 无需填写,按贵司公司代码自动拼接
私有化版 服务器 IP 与端口(默认 8085)

选错形态或私有化地址填错,查单号与取单证会一直查不到数据,且不会有明显报错。不确定时请与立刻云对接人确认。页面底部会显示「当前生效地址」,可据此核对。

单证类型清单

维护贵司立刻云账户里实际配置的单证类型,每行一个,也可用逗号或顿号分隔。

  • 提单、报关单、放行通知书、签收单已内置,无需重复填写;这里只补充贵司自有的类型,例如「设备单」「核注清单」「过磅单」;
  • 客户在群里说到清单里的词,机器人就会去取对应单证;
  • 别填「单」「文件」这类过于宽泛的词——是子串匹配,会让任何带单号的提问都被当成要文件;
  • 留空不影响功能,机器人仍会按内置类型识别。

企业基本信息

字段 说明
公司代码 只读,系统分配的唯一标识
公司全称 必填。改完后点本区块的「保存公司全称」。只改公司名称,不会改对话默认模型(在模型接入设为活跃)
企业 Logo 可选。上传后,带公司代码参数的登录页、控制台左上角、员工培训门户左上角优先显示此图;未上传则显示平台 Logo。无参数的登录页始终显示平台 Logo。
品牌名称 可选,显示在 Logo 旁边(最多 40 字)。留空则显示「立刻智能体」。点「保存品牌名称」单独生效,与「保存公司全称」互不影响。

配置建议

  1. 改动前确认影响范围:系统设置是企业级的,影响所有成员与渠道;
  2. 重要改动留痕:相关操作会进入操作日志;
  3. 追问与关键词:生产环境开启追问前,建议先在智能对话验证效果与 Token 消耗。
  4. 开放 API 权限:对外接入前,建议按系统/用途拆分 API Key,并在本页明确授权范围,避免 Key 泄露后波及全部接口。

相关阅读