这一页先解释 DEEIX Chat 为什么要把模型能力、参数透传、官方原生工具和工具计费拆开管理，再说明管理员应该到哪里配置、怎么配置、怎么验证。
它解决什么问题#
模型供应商会不断增加新能力、新参数和新工具。如果平台只能等固定版本适配，管理员就很难及时开放新模型能力；如果直接让用户随便写高级参数，又容易绕过模型、路由、工具、安全和计费策略。
DEEIX Chat 的做法是把能力开放拆成多层控制：管理员声明模型支持什么，决定用户能调整什么，选择哪些官方工具可以用，并为工具配置独立计费。用户可以使用被允许的能力，但危险字段、未知工具和未授权工具不会因为手写配置而绕过平台治理。
四层关系#
| 层级 | 管理位置 | 作用 |
|---|---|---|
| 模型能力 | 模型管理 | 声明平台模型支持哪些输入、输出、默认参数、参数控件和原生能力。 |
| 参数透传 | 会话配置 | 控制用户自定义模型参数哪些可以进入上游调用。 |
| 官方原生工具 | 模型管理 | 控制某个模型允许使用哪些供应商官方工具。 |
| 工具计费 | 使用计费 | 控制官方原生工具是否按次单独计费。 |
这四层相互独立又相互约束。能力开启不等于所有参数都会通过；参数控件显示不等于参数一定生效；工具存在不等于用户可以使用；工具可用也不等于一定单独计费。
能力透传是什么#
能力透传不是把用户输入原样交给上游，而是在管理员允许的范围内，把必要的模型参数和官方能力传递给真实模型。
例如，管理员可以为某个模型开放温度、输出长度、服务等级等低风险参数，让用户在聊天参数面板中调整；同时继续拦截模型选择、路由、工具注入、安全相关字段等高风险内容。这样既保留高级模型的灵活性，又不会把平台控制权交给用户输入。
官方原生工具是什么#
官方原生工具是供应商模型内置或托管的工具能力，例如网页搜索、代码执行、图像生成、URL 上下文等。它和 MCP 工具不同：MCP 是平台连接的外部工具服务，官方原生工具是供应商模型自己支持的工具能力。
DEEIX Chat 会把官方原生工具放在模型能力中单独管理。只有管理员为某个模型启用的官方工具，才会进入用户侧可用范围。用户手写工具配置时，也只会保留管理员允许的官方工具，未知工具和未授权工具会被过滤。
什么时候需要配置#
| 场景 | 应该配置什么 |
|---|---|
| 想让模型默认使用某些参数 | 在模型能力里配置“默认值”。如果不希望用户调整，可以不添加用户可见控件。 |
| 新增一个支持特殊参数的模型 | 在模型能力里配置默认参数和参数控件；需要用户可调时，再到参数透传里放行对应路径。 |
| 用户需要在聊天页调整参数 | 在模型能力里添加用户可见控件，并确认参数透传允许这些路径。 |
| 供应商新增官方工具 | 在模型能力的官方工具中启用目录工具，或新增自定义官方工具。 |
| 工具有单独供应商成本 | 在使用计费的工具定价中开启原生工具计费并设置价格。 |
| 担心用户高级配置绕过策略 | 使用白名单透传，并依赖系统危险字段拦截和官方工具过滤。 |
配置入口总览#
| 要配置的内容 | 后台入口 | 主要用途 |
|---|---|---|
| 模型默认参数和参数面板 | 模型管理 > 新增或编辑模型 > 模型能力 | 给模型设置默认参数，并决定用户侧参数面板显示哪些控件。 |
| 官方原生工具 | 模型管理 > 新增或编辑模型 > 模型能力 > 官方工具 | 决定某个模型允许使用哪些供应商官方工具。 |
| 参数透传策略 | 会话配置 > 参数透传 | 决定用户配置的模型参数最终哪些可以进入上游调用。 |
| 官方工具计费 | 使用计费 > 工具定价 | 决定官方原生工具是否按次单独计费。 |
建议按这个顺序配置：先在模型里声明能力和工具，再到会话配置里放行参数，最后到计费里确认工具价格。
第一步：打开模型能力配置#
进入管理端，打开“模型管理”，新增模型或编辑已有模型。在模型表单中找到“模型能力”。
优先点击“可视化配置（推荐）”。这里会打开“模型能力配置”，可以用表单配置参数和官方工具。只有在需要粘贴完整配置、批量调整或处理特殊结构时，再使用“高级 JSON”。
如果模型涉及图片生成并且上游支持边生成边返回，还可以开启“图像流式调用”。这个开关只表示平台允许该模型走图像流式流程，仍然需要上游来源和模型能力真实支持。
第二步：配置参数控件和默认值#
在“模型能力配置”里进入“参数”页。这里配置的是用户在聊天参数面板中能看到的控件，以及模型的默认参数。
| 字段 | 怎么填 | 作用 |
|---|---|---|
| 参数 | 填真实参数路径，嵌套参数用点号连接。 | 决定默认值写入哪里，也决定控件对应哪个参数。 |
| 默认值 | 填该参数默认值。 | 用户没有单独保存参数时，模型会使用这里的默认值。 |
| 名称 | 填用户能看懂的显示名。 | 展示在聊天参数面板中。 |
| 说明 | 简短解释参数用途和影响。 | 帮助用户理解什么时候调整。 |
| 类型 | 选择 text、select、number 或 boolean。 | 决定用户侧控件样式。 |
| 选项 | select 类型填写可选值，用逗号分隔。 | 限制用户只能从指定值里选择。 |
默认值会写入模型默认参数。只想让模型固定带上某些默认参数时，填写默认值即可，不一定要给用户添加可见控件。参数控件会写入用户侧参数面板；控件显示不等于参数一定会进入上游调用，最终是否通过还要看“会话配置 > 参数透传”的策略。
第三步：配置官方原生工具#
回到“模型管理”，编辑目标模型，打开“模型能力”，进入“官方工具”页。
如果列表里已有供应商官方工具，可以直接选择并开启。当前内置目录覆盖常见供应商工具，例如 OpenAI 网页搜索、图像生成、代码解释器，Anthropic 搜索、抓取和代码执行，xAI 搜索和代码解释器，Google 搜索、代码执行和 URL 上下文等。
如果供应商新增了官方工具，选择“自定义官方工具”新增。配置时重点确认这些字段：
| 字段 | 怎么填 | 作用 |
|---|---|---|
| 工具 Key | 填工具唯一标识。 | 用来识别用户选择的是哪个官方工具。 |
| 适用协议 | 选择该工具适用的协议。 | 同一个工具支持多个协议时，可以放在同一条配置里。 |
| 类型 | 填工具类型。 | 用于组织工具展示和上游工具结构。 |
| Payload JSON | 填供应商要求的工具配置对象。 | 保存工具的具体配置内容。 |
| 默认开启 | 按需开启。 | 开启后会自动进入用户默认参数。 |
| 配置 | 展开后调整工具细节。 | 适合补充或修改工具 payload。 |
如果页面提示“当前路由协议未适配”，表示该工具可能不适用于当前模型来源协议。仍然强制开启时，平台会按管理员配置透传，但上线前必须实际测试。
用户侧手写工具配置时，平台只保留管理员在这里允许的官方工具。未知工具、未允许工具，以及 MCP/function 类工具注入不会通过这套官方工具配置进入上游。
第四步：配置参数透传#
进入管理端，打开“会话配置”，找到“参数透传”。这里决定用户在聊天参数面板或高级配置中设置的参数，哪些可以真正进入上游调用。
“参数透传策略”有三种：
| 策略 | 行为 | 推荐场景 |
|---|---|---|
| 白名单 | 只允许白名单里的路径通过，其余过滤。 | 生产环境默认推荐。 |
| 黑名单 | 默认允许，命中黑名单或系统拦截的路径会过滤。 | 可信内部用户或调试场景。 |
| 禁止透传 | 用户自定义参数不进入上游。 | 强管控、成本敏感或合规场景。 |
生产环境建议从“白名单”开始。把第二步中希望开放给用户的参数路径写入“模型参数白名单”。如果某些路径只适用于特定协议，可以按协议单独追加；不区分协议时放到 default。
保存前查看“实时预览”。预览会显示哪些路径不过滤、哪些路径被过滤，以及原因，例如命中白名单、命中黑名单或系统拦截。系统危险字段始终拦截，不能通过白名单放行。
第五步：配置官方工具计费#
进入管理端，打开“使用计费”，找到“工具定价”。
开启“原生工具计费”后，管理员启用的官方原生工具会按下方价格计入账单。自用模式下仍然只记录用量，不向用户扣费。
工具价格按次配置。填 0 表示该工具不单独计费；工具返回内容带来的模型输入输出，仍然按模型定价计算。部分工具如果上游没有返回调用次数，就不会生成单独的工具账单项。
建议先为搜索、代码执行、图像相关等有明确供应商成本的工具配置价格，再用真实对话检查用量记录。
第六步：在对话中使用模型配置#
后台完成默认参数、参数控件和透传规则后，用户在对话页选择该模型，打开“模型配置”。页面会同时提供 JSON 配置和可视化配置。
可视化配置会展示管理员在模型能力中配置的参数控件。带有“会透传”标记的参数，表示当前透传策略允许它进入上游调用；没有放行的参数即使用户填写，也不会真正生效。
管理员上线前应使用普通用户身份打开这里，确认默认值、控件名称、说明、选项和透传标记都符合预期。
第七步：测试和验证#
配置完成后，不要只看后台表单。建议按下面顺序验证：
- 在模型管理里运行模型测试，确认平台模型和上游来源可用。
- 用普通用户身份新建对话，选择该模型，打开参数面板，确认控件显示正确。
- 调整一个已放行参数发起对话，确认效果符合预期。
- 打开“模型配置”，确认默认值、控件和“会透传”标记正确。
- 开启一个官方工具发起对话，确认工具可以被模型实际使用。
- 到日志和使用计费里检查模型用量、工具用量和费用记录。
如果要上线给团队使用，建议先只开放少量低风险参数和少量工具。确认稳定后，再逐步增加。
常见问题#
| 现象 | 通常原因 | 处理方式 |
|---|---|---|
| 用户看不到某个参数 | 模型能力里没有配置参数控件，或模型没有对用户开放。 | 回到模型能力的“参数”页补充控件，并确认模型状态和可用范围。 |
| 用户能看到参数，但调整后没有效果 | 参数路径没有被“参数透传”放行。 | 到会话配置的白名单或黑名单里检查路径，并用实时预览确认。 |
| 官方工具没有出现在用户侧 | 模型能力里没有启用该工具，默认开启未打开，或协议不匹配。 | 回到“官方工具”页确认工具、适用协议和默认开启状态。 |
| 官方工具能用但没有单独计费 | 原生工具计费未开启、价格为 0，或上游没有返回调用次数。 | 到“工具定价”开启计费并设置价格，再检查用量记录。 |
| 用户手写的工具配置被忽略 | 该工具不是管理员允许的官方工具，或属于 MCP/function 类注入。 | 在模型能力里明确启用官方工具；外部工具应走 MCP 工具配置。 |
使用建议#
生产环境优先使用白名单透传。参数控件只开放用户真正需要理解和调整的项；官方工具先开放低风险、可解释、成本可控的能力。把“模型是否支持”“用户是否允许使用”“是否进入计费”分开配置，后续新增供应商能力时会更稳定。