For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /features/models.md.
外观 ◐
让站点跟随你的 ChatKit打开主题工作台 →

模型与推理强度

让用户为当前会话选择后端可用的模型与推理强度,设置随每一轮发送。模型列表由后端提供,ChatKit 不提供模型托管。

选择模型与推理强度,发送后检查 settingsMock 演示全屏 ↗
正在加载真实示例…

接入 SOP

  1. 在适配器上提供 listModels,返回 { models, defaultModel? };每个模型包含稳定 id,可提供 label 和 efforts。
  2. 配置 features.model: {}。只提供后端函数或只写开关都不足以启用选择器。
  3. 受控场景用 value 与 onChange 保存每个会话的设置;不受控时由界面按会话保存,defaultValue 只作为初值。
  4. 确认适配器把 ChatInput.settings 映射到后端的模型与推理参数。支持值以返回的目录为准。

验证结果

选“均衡模型”,切换推理强度后发送;顶部应显示本轮 settings。切到不支持推理强度的“快速模型”,原来的不适用强度应被移除。

常见调整

  • effort: false 隐藏推理强度。
  • slot 调整受支持的位置;slot: false 后由宿主使用公开的模型上下文自行展示。
  • 模型支持的输入模态只提供信息,不能代替附件服务与后端校验。

排错

选择器未出现:核对 features.model 与 listModels。选择后模型没有变化:检查真实请求映射。切换会话后选错模型:检查受控状态是否按 sessionId 区分。

完整示例与 API

示例中的模型与通知是本地演示。下载完整文件后替换实际后端逻辑,配置见配置参考,接口见适配器 API。