模型网关与调用事实
看懂执行引擎、模型目录、临时访问身份和费用记录怎样配合,并理解它们各自的限制。
执行任务与提供模型是两件事
Hive Pi和OpenCode是执行引擎,负责推进任务、使用文件和工具。模型服务提供推理接口,具体模型在上下文容量、输出、图片输入和思考设置上可能不同。管理员登记模型服务与模型,再把可用模型开放给某个引擎;员工只能从已开放目录中选择。
Model Gateway位于执行环境与模型上游之间,负责核对本轮模型身份、使用固定路由、检查预算,并记录实际调用事实。它不是业务系统代理,也不会让一个未经配置的模型自动变成可用模型。
一次任务只拿到临时访问身份
模型供应方的长期API Key由控制面管理并供网关读取,不直接交给员工运行环境。任务通过短期随机模型访问码调用网关,访问码与当前员工、工作空间、任务、引擎、路由和共同期限关联。
- Core接受任务时固定本轮模型路由版本、参数、思考设置和截止时间。
- Runtime Manager为活动任务生成随机访问码,并在内存中维护对应关系。
- 引擎通过本轮链路调用网关;网关在线查询Manager,取得实际身份与固定路由。
- 取消、到期、结束、运行环境停止或Manager重启后,访问码失效。
模型访问码不是带身份声明的JWT,也没有独立续期接口。它不能用于业务系统或管理员接口;业务短期Token、MCP认证和开放API Key另有用途,不能互换。
固定路由避免任务条件悄悄变化
一项任务可能先排队,再多次调用模型。固定提交时的路由,意味着管理员后来修改默认模型,不会让这项已提交工作突然换用另一个服务。思考等级也按本轮设置解释,不能根据界面名称猜测上游一定支持全部等级。
若当前上游凭据修订与固定路由不匹配,平台拒绝调用,不静默改用旧凭据或其它默认模型。提高模型单次超时也不会自动延长任务期限:排队、准备和执行共用总时限,每次模型请求还受自身超时约束。
调用记录说明什么
调用记录帮助核对哪个员工、哪次任务、哪个引擎和模型使用了多少明确Token,以及按配置价格计算的已知费用。一个任务可以调用模型多次,任务数量不能直接等同于调用次数或账单金额。
上游用量缺失、价格不完整或调用失败时,费用可能未知。未知不能当作零,参考费用也不保证与服务商最终账单完全一致。管理员可以设置自然月预算和硬限额,但这不替代上游服务自身的账户与账单管理。
网关记录能证明模型请求和明确用量,不能证明工具完成或外部业务正确。模型会收到实际提交给它的内容,企业需要根据资料性质选择获准服务。整体执行链路见任务生命周期,相关限制见安全边界。