模型、托管运行与服务导航

「模型供应商」、「托管运行」与「服务导航」是 Raise 运营与运维管理的核心模块。运营人员可以在这里配置模型供应商并同步到模型网关、查看各租户的模型用量与账单对账，查看平台托管的应用进程状态、执行重启与读取运行日志，以及实时探测底层依赖服务的健康状态。

谁能用复制本节链接

本模块的功能权限根据平台角色进行划分，分为运营人员与支持人员两种：

怎么打开复制本节链接

你可以通过以下路径进入对应的功能页面：

1. 模型供应商：在运营后台左侧导航点击「运营」→「模型供应商」。页面提供「供应商」、「用量与租户」、「账单」与「对账」4 个标签页。
2. 托管运行：在运营后台左侧导航点击「运维」→「托管运行」。
3. 服务导航：在运营后台左侧导航点击「运维」→「服务导航」。
4. 工作台联动进入：
   • 当工作台主栏出现「平台未就绪」待办时，点击条目右侧「查看服务」直接进入服务导航。
   • 当工作台右侧「平台状态」需要排查明细时，点击底部的「全部服务 →」进入服务导航。

界面一览复制本节链接

模型供应商复制本节链接

模型供应商页面顶部显示标题「模型供应商」。拥有写权限时，右上角提供「重新同步」与「添加供应商」按钮。

页面包含 4 个标签页：

添加 / 编辑模型供应商对话框复制本节链接

点击「添加供应商」或列表中的「编辑」打开对话框：

• 对话框标题：添加时显示「添加模型供应商」，编辑时显示对应供应商名称。
• 「类型」：单选「OpenAI 兼容」（说明「兼容 OpenAI 接口的服务，如 vLLM、Ollama。模型可从供应商读取。」）、「Anthropic」或「Google Gemini」（后两者说明「接口地址可留空；模型需手填。」）。创建后类型不能修改。
• 「ID」：必填，标识符，下方提示「创建后不能修改」。规则为 2–31 位小写字母、数字或连字符，以字母开头。不能以 byo- 为前缀（系统预留给租户自带密钥），不能使用网关保留名称（如 openai、anthropic、gemini 等，系统提示换用如 {id}-main 形式）。
• 「名称」：必填，供应商显示名称。
• 「接口地址」：OpenAI 兼容类型必填，说明「不带 /v1，如 https://api.deepseek.com；以版本号结尾的（如 …/api/v3）原样用」。必须为 https 地址（控制台允许 http 时除外），不能携带用户名和密码。Anthropic 与 Google Gemini 类型可留空。
• 「数据所在区域」：下拉选择区域（不限、中国境内、欧盟、美国）。
• 「API 密钥」：供应商凭据。已保存时显示「已保存」，输入框占位显示「（保持不变）」，说明「保存后不再显示。」。
• 「模型」：模型列表配置，说明「单位：每百万 tokens。成本价只用来算毛利。」。列包含启用开关、模型 ID、「租户 入」「租户 出」「成本 入」「成本 出」。提供「添加」按钮；对于 OpenAI 兼容类型，提供「从供应商读取」按钮。每家供应商必须「至少保留一个启用的模型，或者停用整个供应商」。
• 「测试连接」：已有供应商在对话框中提供该按钮，说明「向第一个启用的模型发一条短消息。」。连通显示模型与延迟毫秒数，未连通显示「没通：」及错误信息。
• 「启用」开关：位于底部，控制是否启用整个供应商。
• 「保存并同步」：提交按钮。保存成功提示「已保存并同步到网关」；若网关同步失败，提示「已保存，但没有同步成功：」并附带错误详情。

托管运行复制本节链接

托管运行页面用于监控平台托管的应用进程状态：

• 页眉：显示标题「托管运行」，右侧提供「刷新」按钮。
• 功能未启用提示：若部署时未启用托管运行，显示空态「托管运行未开启（部署时使用 --apps）」。
• 统计三卡：「托管的应用」总数、「运行中」数量与「异常」数量（异常时提示「见下表的“问题”一列」，正常时提示「没有异常」）。
• 「进程」表格：
  • 「应用」：托管应用的名称。
  • 「状态」：状态徽章，包含「运行中」「启动中」「启动失败」「已停止」「未找到进程」。
  • 「版本」：当前运行的版本号（平台只运行最新上架版本）。
  • 「镜像」：展示缩短后的容器镜像摘要。
  • 「状态自」：当前状态的持续起始时间。
  • 「问题」：异常诊断信息。
  • 操作列：具备写权限时提供「查看日志」与「重启」按钮。
• 刷新与审计：表格页脚注明「每 15 秒刷新」；查看日志对话框提示「最近 200 行。可能含租户数据，每次查看都记入平台审计。」。
• 空状态：无托管应用时提示「还没有托管的应用」与「应用声明 runtime 并上架后会出现在这里。」。

服务导航复制本节链接

服务导航页面用于监控底层依赖组件与基础服务健康：

• 页眉：显示标题「服务导航」，右侧提供「刷新」按钮。
• 状态四卡：展示「运行中」「异常」「未部署」「未探测」4 种状态的服务数量。
• 「全部服务」区域：
  • 刷新说明：注明「每 30 秒刷新」。
  • 筛选与搜索：提供「只看异常」开关与「搜索服务」输入框。
  • 服务卡片：按组件分组展示。卡片包含状态圆点、服务名称、状态徽章（运行中显示响应延迟毫秒数）。
    • 运行中服务：显示正常状态与延迟。
    • 异常服务：卡片标红，显示「没有正常响应」，并说明「会影响：」受影响的具体业务。
    • 未部署服务：展示对应安装命令参数提示（如 install.sh --{profile}）。
  • 卡片操作与信息：提供「打开」链接（配置了 URL 时展示，地址形如 {服务}.ops.{基础域名}:8443，属于管理网主机）；提供「怎么登录」操作（展开登录指引，实例域名显示为 {域名}）；展示底层依赖与文档路径。
• 空状态：无异常服务时提示「没有异常的服务」；搜索无结果时提示「没有匹配的服务」。
• 典型组件：包含 Grafana、Temporal、Langfuse、LLM 网关、OpenBao 等基础服务。

常用操作复制本节链接

添加模型供应商复制本节链接

1. 在左侧导航点击「运营」→「模型供应商」。
2. 点击右上角「添加供应商」，打开「添加模型供应商」对话框。
3. 填写基本信息与参数：

   字段	必填	说明
   「类型」	是	选择供应商接口类型，支持「OpenAI 兼容」（说明「兼容 OpenAI 接口的服务，如 vLLM、Ollama。模型可从供应商读取。」）、「Anthropic」或「Google Gemini」（说明「接口地址可留空；模型需手填。」）。创建后类型不能修改。
   「ID」	是	供应商唯一标识，说明「创建后不能修改」。格式为 2–31 位小写字母、数字或连字符，且必须以字母开头。不能使用 byo- 前缀（留给租户自带密钥），不能使用网关保留名称（如 openai、anthropic、gemini 等，若使用系统提示换用如 {id}-main 形式）。
   「名称」	是	填写供应商展示名称。
   「接口地址」	条件必填	OpenAI 兼容类型必填，说明「不带 /v1，如 https://api.deepseek.com；以版本号结尾的（如 …/api/v3）原样用」。必须为 https 地址（控制台允许 http 时除外），不能包含用户名和密码。Anthropic 与 Google Gemini 类型可留空。
   「数据所在区域」	否	下拉选择数据合规区域，可选不限、中国境内、欧盟或美国。
   「API 密钥」	是	输入访问该供应商的凭据密钥。保存后不再显示。
   「模型」	是	配置该供应商提供的模型列表，说明「单位：每百万 tokens。成本价只用来算毛利。」。可点击「添加」逐行填入，或若为 OpenAI 兼容类型可点击「从供应商读取」勾选添加。设置每行启用开关、模型 ID、「租户 入」「租户 出」「成本 入」「成本 出」价格。至少保留一个启用的模型，否则提示「至少保留一个启用的模型，或者停用整个供应商」。
   「启用」	否	底部开关，控制是否启用整个供应商。

4. 点击「保存并同步」按钮。
5. 保存成功后提示「已保存并同步到网关」。若网关同步失败，提示「已保存，但没有同步成功：」并附带错误详情。状态列显示为「已同步」或「同步失败」。

测试连接与编辑模型供应商复制本节链接

1. 在「模型供应商」列表中，找到目标供应商行，点击操作列的「编辑」。
2. 打开编辑对话框（标题显示编辑对应供应商名称）。类型与 ID 不可修改；密钥输入框占位显示「（保持不变）」，已保存显示「已保存」。
3. 点击「测试连接」按钮。系统「向第一个启用的模型发一条短消息。」进行连通性验证。
4. 若连接成功，显示第一个启用的模型 ID 与响应延迟毫秒数；若失败，提示「没通：」并展示错误详情。
5. 调整名称、接口地址、区域、密钥或模型定价，确认至少保留一个启用模型。
6. 点击「保存并同步」，更新配置并推送到模型网关。

从 OpenAI 兼容供应商读取模型复制本节链接

1. 在添加或编辑 OpenAI 兼容类型的供应商对话框中，确保已填入有效的「接口地址」与「API 密钥」。
2. 在「模型」配置区域，点击「从供应商读取」按钮。
3. 系统自动读取该端点返回的模型列表并呈现。
4. 在读取出的模型列表中，勾选需要启用的模型并添加到列表中。
5. 为新添加的模型配置「租户 入」「租户 出」「成本 入」「成本 出」价格（单位为每百万 tokens）。
6. 点击「保存并同步」完成配置。

删除模型供应商复制本节链接

1. 在「模型供应商」列表中，找到目标供应商行。
2. 点击操作列的「删除」按钮，弹出删除确认对话框。
3. 对话框提示删除该供应商后，「它的模型会从所有租户的可用列表消失，正在使用的租户需改用其他模型。」。
4. 确认删除操作。删除后该供应商及其模型从系统和网关中移除，操作自动记入平台审计。

重新同步网关与修复配置漂移复制本节链接

1. 在「模型供应商」页面顶部，查看「与网关的一致性」状态面板。
2. 若面板提示网关与这里的记录存在不一致，查看漂移类型列表（包括「网关缺少供应商」「网关多出供应商」「供应商的模型对不上」「租户在网关没有密钥」「网关里有多余的租户密钥」等）。
3. 点击面板中的「重新同步」按钮（或点击页眉右上角的「重新同步」按钮）。
4. 系统按本页面的记录将所有供应商和租户密钥策略重推至模型网关。
5. 重新同步成功后，弹出提示「已把网关恢复成这里的记录」或「已把所有租户的策略重新同步到网关」，一致性状态恢复为「网关与这里的记录一致」。

查看模型用量与租户明细复制本节链接

1. 在「模型供应商」页面，切换到「用量与租户」标签页。
2. 在周期选择器中切换统计时间跨度，可选「7 天」「30 天」或「90 天」。
3. 查看顶部概览卡片中的总请求数（包含失败次数）、Tokens 消耗（输入与输出）以及「按目录价格估算」的估算费用。
4. 查看经营指标卡片：「收入（向租户收取）」「成本（付给供应商）」「毛利」与「失败率」。
5. 在「按租户」表格中查看各租户的请求数、Tokens、失败率、平均响应延迟、收入、成本、常用模型与调用趋势，并核查来源为「自带」还是「平台」。
6. 在「按模型」表格中查看各模型的调用请求数、Tokens 消耗与估算费用。
7. 若所选周期内没有调用数据，表格区域显示「这段时间没有调用」。

查看月度账单并导出 CSV复制本节链接

1. 在「模型供应商」页面，切换到「账单」标签页。
2. 在月份选择下拉菜单中选择需要查看的自然月。
3. 查看当月的财务汇总信息，包括应收总金额、「成本」与「毛利」。
4. 在租户分表明细中，核对每个租户调用的模型、密钥来源、请求数、输入 Tokens、输出 Tokens、消费金额与成本。若当月无调用，显示「这个月没有调用」。
5. 点击右上角「下载 CSV」按钮。
6. 浏览器自动下载当月账单对账明细文件，文件名格式为 llm-statements-{月份}.csv（例如 llm-statements-2026-10.csv），可作为发票与财务核算的内部底稿。

检查网关 Token 对账与重新对账复制本节链接

1. 在「模型供应商」页面，切换到「对账」标签页。
2. 查看页面顶部的对账结果横幅：
   • 若全部一致，显示「对得上」与「kwork 与网关的 token 计数一致。」；
   • 若存在差异，显示不一致的租户数量，并提示「出入超过 5% 或 200 tokens。常见原因：密钥当天重建、有调用没经过网关。」；
   • 若网关不可用，显示网关不可达相关警告。
3. 查看对账明细表格，核对租户名称、kwork 计 tokens、网关计 tokens、差异数量、双方统计的请求数，以及状态徽章（「一致」「有出入」「网关没有密钥」或「网关不可达」）。表格底部注明「按当前自然月对比；请求数仅供参考。」。
4. 如需更新或重新核对两端计数，点击表格上方的「重新对账」按钮，系统重新比对两端数据并刷新列表。

重启托管应用进程复制本节链接

1. 在左侧导航点击「运维」→「托管运行」。
2. 查看顶部「托管的应用」「运行中」与「异常」统计卡片。若存在异常，卡片提示「见下表的“问题”一列」。
3. 在「进程」表格中找到需要维护的目标应用，核对当前「状态」（如「运行中」或「启动失败」）、「版本」与「镜像」摘要。
4. 点击该行右侧的「重启」按钮。
5. 弹出确认对话框，提示「重启期间所有租户对该应用的请求会短暂失败。」。
6. 确认重启操作。系统向进程管理器发送重启指令，完成后弹出提示「已重启」，表格状态刷新。
7. 若应用当前处于未运行状态，点击重启会提示「进程没有在运行，无法重启」。

查看托管应用进程日志复制本节链接

1. 在「托管运行」页面的「进程」表格中，找到目标应用行。
2. 点击该行右侧的「查看日志」按钮。
3. 弹出日志查看对话框，显示该应用进程的最近 200 行日志输出。对话框顶部明确提示「最近 200 行。可能含租户数据，每次查看都记入平台审计。」。
4. 若该应用进程当前未在运行，界面提示「进程没有在运行，没有日志可看。」；若进程尚无标准输出输出，内容区域显示「（没有输出）」。
5. 查看完毕后点击右上角关闭对话框。每次查看日志操作均自动记录至平台审计。

排查服务异常与查看登录指引复制本节链接

1. 在左侧导航点击「运维」→「服务导航」（或在工作台待办中点击「平台未就绪」进入）。
2. 在顶部卡片查看服务的健康分布（「运行中」「异常」「未部署」「未探测」）。
3. 若服务较多，可开启「只看异常」开关只展示异常卡片，或在「搜索服务」输入框中输入服务名称进行筛选。
4. 在服务卡片中定位标红的异常服务，卡片显示「没有正常响应」，并列出「会影响：」说明受影响的具体系统能力。
5. 若服务卡片提供了「打开」按钮，点击该按钮可打开该运维组件的 Web 管理页面（如 Grafana、Temporal、Langfuse、LLM 网关、OpenBao 等，地址形如 {服务}.ops.{基础域名}:8443）。
6. 点击卡片中的「怎么登录」按钮，展开登录方式与凭据指引（其中 {域名} 对应当前实例域名）。
7. 排查并修复底层故障后，可在页眉点击「刷新」按钮（页面每 30 秒也会自动刷新探测一次），确认服务状态恢复为「运行中」。

状态说明复制本节链接

模型供应商状态复制本节链接

网关一致性状态复制本节链接

平台记录 ───[ 重新同步 ]───> 推送配置 ───> 网关与这里的记录一致
   │
   └───[ 网关侧变动 / 未同步 ]───> 配置漂移（发现不一致处）

• 「网关与这里的记录一致」：模型网关中的供应商与所有租户密钥，与平台数据库中的记录完全一致。
• 配置漂移（发现不一致处）：网关记录与平台记录发生偏差。常见漂移类型包括：
  • 「网关缺少供应商」：平台已配置但网关尚未录入。
  • 「网关多出供应商」：网关存在平台未登记的供应商。
  • 「供应商的模型对不上」：模型列表或规格存在差异。
  • 「租户在网关没有密钥」：租户在平台已分配但网关缺少对应访问凭据。
  • 「网关里有多余的租户密钥」：网关存在已失效或多余的租户密钥记录。

托管应用进程状态复制本节链接

网关 Token 对账状态复制本节链接

服务导航健康状态复制本节链接

让助手帮你做复制本节链接

平台助手（Agent）未接入模型供应商、托管运行或服务导航的管理操作。出于平台系统级安全与运维控制要求，你不能通过助手添加供应商、修改模型定价、重新同步网关、重启托管应用或查看进程日志。

涉及模型配置与运维控制的操作，均须由具备 platform.ops 权限的人员在控制台界面中手动核对并执行。

你可以向助手咨询相关配置规则与运维机制，例如：

怎么配置 OpenAI 兼容的模型供应商？ 重启托管应用会对租户产生什么影响？ 模型网关与控制台记录不一致时该怎么修复？ 为什么查看托管运行的进程日志会被记入平台审计？

设置复制本节链接

模型与托管运行涉及的控制项与配置规则如下：

注意事项复制本节链接

• API 密钥只显示一次：供应商 API 密钥在保存后不再明文展示。后续编辑时仅显示「已保存」，输入框占位显示「（保持不变）」。
• 供应商删除影响全平台：删除供应商会使该供应商的所有模型从所有租户的可用列表中消失。正在使用这些模型的租户将无法继续调用，须改用其他模型。
• 网关配置权威源：若模型网关控制台被直接修改，会导致网关与本页记录发生漂移。系统始终以本页面的配置记录为唯一权威源，须点击「重新同步」将配置推回网关。
• 托管日志隐私与审计：托管应用的运行日志中可能包含租户的业务输入数据。每次点击「查看日志」都会作为安全事件记录在平台审计中。
• 进程重启短暂中断：重启应用进程期间，所有租户对该应用的请求会发生短暂失败。
• 账单核算性质：账单是按目录价格估算的内部核算账单，用于平台成本分析与毛利核算，平台不会自动向客户发起收款。客户实际付款与支付配置参见申请与支付。
• 管理网网络限制：服务导航中的「打开」链接直连隔离管理网主机（端口 :8443），在公网环境下无法直接访问。
• 只读角色限制：platform.support 角色为纯只读权限，无法添加、编辑、删除供应商，无法重新同步网关，无法重启应用，也无法查看日志。页面页脚会显示「你的角色只能查看」。

目前不支持复制本节链接

• 无独立网关与计费页：没有单独的网关页或计费页，相关功能集成在「模型供应商」页面中。
• 套餐级模型额度：暂未提供基于套餐级别的模型调用额度限制配置（套餐基础规格参见套餐）。
• 托管进程出网与历史版本：托管应用进程暂不支持主动访问公网（无出网能力），且平台仅支持运行最新上架的版本。
• 自动对接外部支付扣费：本页的 LLM 账单不支持自动触发微信支付等外部支付渠道的自动扣款或开票。

常见问题复制本节链接

添加 OpenAI 兼容供应商时，接口地址要不要带 /v1？复制本节链接

地址不以版本号结尾时（例如 https://api.deepseek.com），系统与模型网关自动补上 /v1，调用 <地址>/v1/chat/completions。地址以版本号结尾时（例如火山方舟的 https://ark.cn-beijing.volces.com/api/v3、智谱的 https://open.bigmodel.cn/api/paas/v4），接口路径直接接在后面，调用 <地址>/chat/completions，不再补 /v1。照供应商文档里的接口根地址填写即可；「添加供应商」里预置的供应商已带好地址。

模型网关显示与这里的记录不一致时该怎么处理？复制本节链接

当出现「网关缺少供应商」「供应商的模型对不上」或「租户在网关没有密钥」等配置漂移提示时，说明网关底层的规则与平台控制台不一致。你可以点击一致性面板中的「重新同步」按钮（或页眉右上角的「重新同步」），系统会以本页面的记录为权威源，将所有供应商和租户策略重推至模型网关并恢复一致。

为什么支持人员角色无法重启应用或查看进程日志？复制本节链接

这是由于权限隔离策略决定的。重启应用会导致租户请求短暂失败，而进程日志中可能包含租户的业务数据，属于高风险操作。因此平台将写操作权限（添加、编辑、删除供应商、重新同步、重启应用、查看日志）限制为仅 platform.ops（运营人员）可用。platform.support（支持人员）仅拥有只读权限，页面页脚会提示「你的角色只能查看」。

为什么在浏览器中点击服务导航的「打开」链接无法打开页面？复制本节链接

服务导航中展示的管理组件（如 Grafana、Temporal、Langfuse、LLM 网关、OpenBao 等）均部署在受信任的内部隔离管理网段（主机形如 {服务}.ops.{基础域名}:8443），未向公网暴露。你必须确保操作终端已接入管理网或专用网络环境后方可访问。

打开托管运行页面时，为什么显示「托管运行未开启」？复制本节链接

托管运行功能依赖底层部署时的开关配置。如果在安装平台时未包含 --apps 部署参数，系统就不会初始化托管应用运行环境，页面会显示空态「托管运行未开启（部署时使用 --apps）」。该开关属于安装部署层配置，无法在运营台界面中直接开启。