企业自定义模型怎么接：部署、启用与可见范围
本篇涵盖的知识重点
- 当前后台中该能力位于企业设置下的模型设置，页面名为模型部署管理
- 列表中展示企业下所有模型：内置官方模型与企业自添加的模型
- 新增自定义模型需要向模型服务商获取 API_KEY 与模型部署地址
- 保存前可先测试模型配置是否通过，通过后再单击保存并启用
- 启用后稍等片刻，即可在 VS Code、JetBrains IDEs 等插件端看到该模型
- 仅自定义部署的模型可启用、关闭、编辑、删除，内置模型不支持操作，删除不可逆
- 编辑模型可设置用户可见范围：允许所有、白名单、黑名单、禁止所有用户
部署与启用路径
模型接入要点解读
作用先分清哪些是平台内置的、哪些是企业自有的，才能判断后续能操作哪些。
操作登录企业管理后台，在左侧导航栏企业设置中选择模型设置。列表中会展示企业下的所有模型，包括腾讯云代码助手内置的官方模型和企业自添加的模型。
注意内置模型不支持启用、关闭、编辑、删除等任何操作，只有自定义部署的模型才可被管理。
- 内置官方模型：腾讯云代码助手内置，随平台提供，企业端不可修改或删除
- 企业自添加的模型：由管理员自行部署，是后续启用、编辑、删除等操作的唯一对象
作用接入自有模型是实现差异化能力和成本控制的前提。
操作单击「新增自定义模型」，填写模型信息，例如部署 hunyuan 模型时填写对应的模型名称、API_KEY 与模型部署地址等字段。API_KEY 和模型部署地址需要去模型服务商获取，例如部署混元大模型可去腾讯混元大模型官网平台进行采购。
注意API_KEY 是访问第三方模型账号的关键凭据，请妥善保管，避免在共享环境中填写或导出；具体需填写哪些字段以页面实际展示为准。
作用测试能提前暴露地址或密钥填错的问题，避免启用了却用不了的尴尬。
操作信息填写完成后，先单击测试，确认模型配置是否通过。若出现配置未通过的弹窗，说明配置有问题，需回到上一步核对。测试通过后，单击保存并启用完成配置。
注意看到未通过的弹窗时不要反复重试，先核对模型部署地址是否可被企业网络访问、API_KEY 是否有效且未过期。
作用部署的最终目的是让开发者用起来，插件端能看到才算真正生效。
操作模型启用后稍微静待一会，即可在 VS Code、JetBrains IDEs 等 IDE 插件端看到部署的模型，切换到自定义部署的模型即可开始使用。
注意若插件端长时间未出现该模型，先确认模型处于启用状态而非仅保存，并确认当前登录账号在模型的可见范围内。
作用可见范围决定了谁能添加和使用这个模型，是成本与合规的闸门。
操作在企业管理后台对自定义模型进行启用或关闭、编辑、删除操作。编辑时可调整用户可见范围与模型部署地址等设置。
注意删除操作不可逆，请谨慎操作；自定义模型产生的全部费用（Token、订阅等）由企业向第三方支付，使用前建议先了解计费方式。
- 允许所有用户：默认策略，所有成员均可自行添加个人模型，适合团队规模小、模型成本低的场景
- 白名单模式：仅名单中的用户或部门允许添加，其余禁止，适合把付费模型收敛到特定团队
- 黑名单模式：名单中的用户或部门禁止添加，其余允许，适合只排除少数人群的场景
- 禁止所有用户：所有成员均不可自行添加个人模型，适合成本与安全要求最严格的阶段
作用自定义模型意味着对话内容会流向第三方，数据与成本边界必须提前说清。
操作接入前先与模型服务商确认计费方式与数据处理规则：本地读写的内容是 workbuddy/models.json 这一模型配置文件；对话内容由 WorkBuddy 转发至自定义模型，由该模型按其规则处理。
注意使用过程中可能持续触发模型调用，建议在第三方账户侧设置费用关注与告警；若接入存在违法违规风险，依据用户协议 §8.3.2，WorkBuddy 可能中止、限制或禁止该模型的接入。
- 费用归属：自定义模型产生的全部费用（Token、订阅等）由企业向第三方支付
- 内容流向：输入内容直达第三方模型，WorkBuddy 仅作通信链路，具体处理规则按企业与第三方的协议执行
- 服务状态：自定义模型由第三方独立运营，其可用性、稳定性、安全性、合规性与生成结果需关注该第三方的服务状态与公告
费用与合规提示
- 仅支持对自定义部署的模型进行启用、关闭、编辑、删除操作，内置的模型不支持操作；其中删除操作不可逆，请谨慎操作。
- API key 是访问第三方模型账号的关键凭据，请妥善保管，避免在共享环境中填写或导出。
- 请确保模型来源合法，接入前建议先阅读该模型服务方的协议与隐私政策。
- 使用过程中可能持续触发模型调用，建议密切关注第三方账户费用，避免出现超出预期的支出。
- 自定义模型产生的全部费用（Token、订阅等）由企业向第三方支付，不随平台积分体系结算。
- 若接入存在违法违规风险，依据用户协议 §8.3.2，WorkBuddy 可能中止、限制或禁止该模型的接入。
接入前准备训练
```markdown
我们要在企业管理后台接入一个自定义模型，请帮我产出一份《接入前置准备清单》。
必须依据的真实事实（不要增删功能或限制）：
- 入口为登录企业管理后台后，在左侧导航栏企业设置中选择模型设置；
- 列表展示腾讯云代码助手内置的官方模型和企业自添加的模型；
- 单击新增自定义模型后需填写模型信息；
- API_KEY 和模型部署地址需要去模型服务商获取；
- 填写完成后可以先测试模型配置是否通过，再单击保存并启用；
- 模型启用后稍等一会，即可在 VS Code、JetBrains IDEs 等 IDE 插件端看到并切换使用；
- 仅支持对自定义部署的模型进行启用/关闭、编辑、删除操作，内置模型不支持操作，删除不可逆；
- 自定义模型产生的全部费用（Token、订阅等）由企业向第三方支付；
- API key 是访问第三方模型账号的关键凭据，请妥善保管，避免在共享环境中填写或导出。
请输出：1）一张准备清单表（项目 / 谁负责 / 如何验证就绪 / 风险）；2）一段「密钥保管与使用」规范（不超过 150 字）；3）一张上线前检查表，至少 6 项。
```得到一张准备清单表、密钥保管规范和上线前检查表，事实描述与给定信息一致，且明确提示了删除不可逆与第三方计费。
```markdown
我要为不同团队配置自定义模型的可见范围，请帮我设计方案。
可选的四种策略（请严格按此设计，不要新增策略）：
- 允许所有用户：默认策略，所有成员均可自行添加个人模型；
- 白名单模式：仅名单中的用户或部门允许添加，其余禁止；
- 黑名单模式：名单中的用户或部门禁止添加，其余允许；
- 禁止所有用户：所有成员均不可自行添加个人模型。
约束事实：仅支持对自定义部署的模型进行启用/关闭、编辑、删除操作，内置模型不支持操作；删除不可逆。
我的场景：200 人研发团队，其中外包人员 30 人不需要访问付费模型；核心算法组 15 人需要专用模型；其余成员按需自选。
请输出：1）一张策略选型表（团队 / 推荐策略 / 配置方式 / 为什么）；2）一段策略组合建议，说明当同一人同时属于两个团队时该如何处理，以及不确定时应如何验证；3）一段季度复核清单（不超过 150 字）。
```得到一张策略选型表、组合建议和复核清单，四种策略的定义与适用判断准确，未编造新策略。
```markdown
我在企业管理后台部署了一个自定义模型并单击了保存并启用，但有同事说在 IDE 插件端看不到这个模型。
已知事实（请严格按此组织，不要新增不存在的排查项）：
- 模型启用后，需要稍微静待一会，才会在 VS Code、JetBrains IDEs 等 IDE 插件端出现；
- 仅支持对自定义部署的模型进行启用/关闭、编辑、删除操作，内置模型不支持操作；
- 编辑模型时可设置用户可见范围，包括允许所有用户、白名单模式、黑名单模式、禁止所有用户；
- 信息填写完成后可以先测试模型配置是否通过，未通过会出现提示弹窗；
- API_KEY 和模型部署地址需要向模型服务商获取；
- 自定义模型由第三方独立运营，其可用性、稳定性、安全性、合规性与生成结果需关注该第三方的服务状态与公告。
请输出：1）一棵排查决策树（用缩进列表），每步写清判断什么、是与否分别做什么；2）一张「排查项 / 需要找谁 / 需要什么信息」的协作表；3）一段给同事的回复话术（不超过 120 字），说明需要等待生效并确认其是否在可见范围内。
```得到一棵排查决策树、一张协作表和一段回复话术，所有排查依据均来自给定事实，未编造新的菜单或配置项。
本文基于官方文档再创作，具体以官方文档站实际展示为准。