model-gateway 命令组用于启用 AgentKit Model Gateway,并管理可被统一访问的模型提供方与调用方。顶层命令别名为 mgw。
Model Gateway 会创建或使用云端网关资源,并保存模型提供方 API Key。执行前确认账号、区域、网关模式与密钥来源;不要把真实 API Key 写入仓库、脚本或命令历史。
model-gateway activate
启用 Model Gateway。若当前区域已经存在 Model Gateway,命令会返回已有资源;若资源处于失败状态,命令会报错。创建后 CLI 会等待网关进入可用状态。
model-gateway provider create
创建一个模型提供方。提供方包含上游 Base URL、协议、一个或多个 API Key,以及可通过网关访问的模型名称。
model-gateway provider list
列出当前 Model Gateway 下的模型提供方。
model-gateway provider show
查看指定模型提供方详情。
model-gateway provider update
更新指定模型提供方。至少传入 --base-url、--api-key、--model 或 --protocol 之一。传入 --api-key 会替换提供方 API Key 列表;传入 --model 会替换模型列表。
model-gateway provider delete
删除指定模型提供方。
删除提供方会影响依赖该提供方或其模型授权的调用方。执行前确认名称和授权范围;自动化脚本中才建议使用 --yes 跳过确认。
model-gateway consumer create
创建调用方。调用方会获得用于访问 Model Gateway 的 API Key,并可配置模型授权范围和 token 速率限制。
--allow-model 的值可以只写提供方名称,表示允许该提供方下的所有模型;也可以写作 <provider>/<model>,只允许指定模型。
model-gateway consumer list
列出当前 Model Gateway 下的调用方。
model-gateway consumer show
查看指定调用方详情,包括 API Key、授权范围和速率限制。
model-gateway consumer update
更新调用方的模型授权范围或 token 速率限制。至少传入 --allow-model、--tpm 或 --tpd 之一。传入 --allow-model 会替换现有授权范围。
model-gateway consumer delete
删除指定调用方。
删除调用方会使其 API Key 失效。执行前确认业务已经切换或停止使用该调用方。
model-gateway show-example
根据提供方和调用方生成调用示例。命令会读取提供方访问地址、协议、可访问模型以及调用方 API Key,然后输出所选类型的示例。
agentkit 示例会输出可写入当前项目的模型环境变量,例如 MODEL_AGENT_NAME、MODEL_AGENT_API_BASE 与 MODEL_AGENT_API_KEY。