# AI 服务商管理是什么？

> Cube Agent 2.2.0 正式版（构建 2002007）使用说明。
> 分类：模型与 AI 能力。内容基准：2026-11-07。
> 网页：https://cubeagent.app/docs/provider_ai_management/

## 它能做什么

打开 **设置 → 模型与用量 → 服务商管理**，点击列表顶部常驻的 **让 AI 帮我配置**。检查配置、测试连接、获取模型，也能比较服务商和套餐；右上角的彩色 AI 图标是同一个入口。

## 如何识别这个入口和模式

首次进入服务商管理页时，应用会展示一次 AI 管理介绍，可直接点击 **选择管理模型** 开始体验；关闭后不会反复自动弹出。顶部的 **让 AI 帮我配置** 会一直保留，不需要记住隐藏入口。

进入后，标题栏会固定显示 **AI 服务商管理** 和 **专用管理模式**，因此不会与普通聊天混淆；保存配置等实际变更前仍会请你确认。管理会话会自动保留：配置到一半随时可以退出，下次从服务商管理页顶部的 **继续上次 AI 配置** 一键回到原会话继续；全部历史可在服务商管理页或管理会话标题栏菜单的 **AI 会话历史** 中查看、继续或删除。管理会话的标题栏菜单还提供消息导航和 **清空当前对话**：清空会删除当前会话的全部消息及历史版本，已保存的配置不受影响。管理会话只保留在本机（并随备份同步），不会出现在任何助手的会话列表里。

可以直接让 AI：

- 检查配置、测试连接，并整理服务商与模型。
- 根据最新官方资料比较服务商、套餐与模型。
- 从标准接口发现模型列表。
- 联网查询服务商文档、接口格式和模型能力线索。
- 新建、编辑服务商，停用服务商，或修改模型能力。
- 把你从网页复制的真实模型列表解析、去重并合并到指定服务商。

配置变更仍由你掌控，执行前会再次确认；联网脚本可临时使用现有密钥，执行前请核对。

## 先选择管理模型

每次从服务商页进入时，应用都会先列出当前已启用的文本聊天模型。顶部会优先推荐上次使用、默认聊天模型或已知支持工具调用的模型；这个选择只用于 AI 服务商管理，不会改动默认聊天模型和普通对话当前模型。

模型能力尚未确认时可以先选，首次发送会验证工具调用。若模型或接口不支持工具调用，或所选模型后来被停用，页面会明确提示并重新打开模型选择器。

## 读取与写入

查看配置、连接测试和发现模型属于只读操作。新建、编辑、删除服务商，以及增删模型或修改能力属于写操作，模型只能提出结构化变更，真正执行前会显示工具确认面板和关键参数。

删除服务商或移除模型会使用红色的强化确认，并提示操作不可从确认面板撤销。免费试用等由账号或云服务管理的内置服务商有底层保护，不能删除，不需要时可以停用；其他预置服务商可以删除，之后可从服务商目录重新添加。

## JavaScript 能力

管理模式可以使用本机 QuickJS 处理你粘贴的非标准列表、清洗 JSON、去重模型 ID，也可以直接访问网络。标准连接测试和模型发现优先使用应用原生服务；遇到非标准接口、自定义请求体或需要检查原始响应时，AI 会先展示 JavaScript 执行确认，再通过 `providerFetch` 自动附加服务商现有凭据并发起真实请求。测试新服务商时，先保存服务商配置，再申请代用其凭据。`getLocalSecret` 和 `getProviderCredential` 不再向脚本返回密钥；CUBEKEY 是管理模式保存密钥后生成的引用，不是助手环境变量名，也不能自行猜测编号。

## 隐私与密钥风险

AI 管理需要把你的管理对话，以及服务商名称、Base URL、API 路径、模型 ID、配置状态、测试结果等必要信息发送给所选管理模型。联网搜索时，查询词和访问目标也会交给对应的搜索或网页服务。不要在管理对话中放入不希望发送给这些服务的内部地址、客户信息或其他敏感内容。

服务商 API Key、多 Key 当前选中的有效 Key 及识别为敏感的认证 Header，不会通过服务商查询工具返回给模型。只有在你批准 JavaScript 后，它们才会临时注入本机 QuickJS，脚本随后可以把带凭据的请求发往代码中指定的网络地址。账号会话型内置服务商不会向脚本暴露 Session Token，仍使用原生连接测试。

脚本日志、返回值和错误中的原始凭据会再次脱敏，但自动识别并非绝对保护：脚本主动对密钥编码、拆分、变形，写入输出文件，或直接随另一网络请求转发时，可能绕过字符串脱敏。因此确认面板会展示脚本内容；批准前应核对服务商 ID、请求域名和代码用途，发现陌生域名、打印凭据、写文件或二次转发时应取消执行。新增或更换密钥时，推荐使用输入区「安全保存密钥」按钮——密钥只保存在本机，对话里仅出现 CUBEKEY 引用，可用于保存服务商配置，不能在脚本中读取原文；或在服务商详情原生表单填写。如果密钥已经明文粘贴进对话，可以让 AI 直接写入（写入前仍会弹确认面板，面板上的密钥会自动掩码）；此时密钥已随对话发送给管理模型的服务商，建议尽快在服务商后台吊销或重置，再把新密钥更新进来。

管理模式还会提供联网搜索和网页读取。用户说不清服务商规则、接口地址或能力字段时，AI 可以先查找公开资料和官方页面，再结合本机实际配置给出建议；搜索到的信息不会被当成本机配置直接写入，所有变更仍需确认。

## 推荐说法

- “检查当前服务商配置，告诉我哪里可能有问题。”
- “测试这个模型是否连通，只检查不要修改。”
- “这是服务商网页上的模型列表，帮我去重后写入对应服务商。”
- “把这个模型改成支持视觉和工具调用，其他能力保持不变。”

AI 会先读取真实配置再处理；写入完成后会重新读取核对。当前版本只管理服务商与模型，MCP、Skill 和助手仍在各自页面管理。