You need to enable JavaScript to run this app.
文档中心
AgentKit

AgentKit

复制全文
下载 pdf
模型接入
创建并授权模型组
复制全文
下载 pdf
创建并授权模型组
模型组用于将多个已接入的上游模型组合为一个稳定的调用入口。应用只需在请求的 model 字段中填写模型组的调用名称,模型网关便会按配置的权重选择组内上游模型,当组内重试未成功时,可调用备用模型。模型组适合需要多供应商分流、平滑切换或统一业务模型名称的场景。本文介绍如何创建和管理模型组。​
使用限制​
  • 创建模型组前,需先在“供应商与模型管理”页签中接入至少一个供应商模型。相关操作,请参见 管理供应商和模型。​
  • 模型组需单独创建,并单独授权给 Proxy API Key;已有的指定供应商调用授权不会自动授予模型组调用权限。​
  • 保存模型组配置后,配置立即对新请求生效;已经开始的请求仍使用发起时的配置快照。​
创建模型组​
  1. 登录 AgentKit 控制台。​
  1. 在左侧导航树中选择“网关 > 模型接入”,进入目标模型服务。​
  1. 单击“模型组”页签,然后单击“创建模型组”按钮。​
  • ​​​
  1. 配置模型组信息。​
  • ​
    配置项​
    说明​
    模型组名称​
    请输入模型组的名称。​
    此名称作为模型组的唯一调用标识,应用调用模型组时,在请求的 model 字段填写该名称,无需指定供应商,建议使用能体现业务用途的名称,例如 coding-fast。​
    组内模型​
    选择模型组中配置的模型。仅可从已接入供应商的模型中选择一个或多个上游模型,若无目标模型,请先在已有供应商中添加新模型,或者配置新的模型供应商和模型。​
    • 单次只能添加一个模型供应商下的一个模型作为上游模型,每个模型组中最多可配置 5 个上游模型。​
    • 每个上游模型由供应商、模型 ID 和权重组成。​
    • 供应商:选择已配置的模型供应商。​
    • 模型 ID:选择模型供应商下,已配置的模型。​
    • 权重:网关按各模型权重比例选择上游模型,权重值越大优先级越高,权重为 0 时停止向该上游分配请求。​
    失败处理​
    组内重试次数由模型服务的统一设置。​
    • 上游模型调用失败后,网关先在组内按该设置继续尝试。​
    • 组内模型共用该次数,即以模型组为单位,在模型组中失败重试的次数,并非单个模型调用失败的次数。​
    备用模型​
    可选。组内重试结束后仍未成功时,网关最多调用一次备用模型。​
    ​
  1. 单击“保存”按钮,完成模型组创建。创建成功后,可在“模型组管理”页签下查看模型组的信息。​
  • ​​​
  1. (可选)创建完成后,单击“编辑”按钮,调整模型组的名称、组内模型、权重等信息,修改后单击“确定”按钮保存变更,变更后的模型组仅影响新请求。​
  • ​​​
  1. (可选)后续如果不再使用模型组,单击“删除”按钮,在弹出的对话框中单击“删除”按钮,删除模型组。​
注意​
删除前,请先确认没有应用继续以该调用名称发起请求,并移除不再需要的 Proxy API Key 授权。删除后,以该名称调用将失败。​
  • ​​​
为 Proxy API Key 授权模型组​
注意​
仅持有已获授权的 Proxy API Key,应用才能调用模型组。​
  1. 在模型服务页面,选择“Proxy API Key 管理”页签,单击目标 Key 的“编辑”按钮。​
  • ​​​
  1. 在“供应商模型权限”部分,选择“全部供应商模型”。​
  • ​​​
  1. 在“模型组权限”部分,如果仅需配置部分模型组,选择“自定义范围”,然后选择可调用的模型组;如果不限制模型组,选择“全部模型组”。​
  • ​​​
  1. 单击右下角“确定”按钮,保存配置。返回列表后,可在“可调用模型”列查看该 Key 已获授权的模型组以及模型组中的模型数量。​
  • ​​​
最近更新时间:2026.10.29 11:43:28
这个页面对您有帮助吗?
有用
有用
无用
无用