uip 模型中心

“uipmodel-hub”的语法和选项，这是对 LLM 网关路由规则的读取/配置视图 — 组织、租户、自定义路由、路由历史记录和策略预览。

uip model-hub是基于LLM 网关路由的读取/配置视图 — 哪个模型支持给定的（产品，功能）对，以及谁可以覆盖该默认值。五个命令组：organizations、tenants、custom-routings、routing-history、policy-previews。所有这些都需要 AI Trust Layer 的 OrganizationAdmin 角色。

有关此配置最终提供的发现端 API，请参阅uip llm-gateway 。

概念

• 产品/功能/模型。路由规则以 --product 作为键值（例如agenthub），并包含其中的 --feature（例如llm-call）和 --model 标识符。tenants get 返回当前租户按产品分组的所有规则。
• 自定义路由将覆盖默认路由。custom-routings create 更新并插入一个规则，将（产品、功能、主模型）元组从其默认区域重定向到不同的模型/区域对；如果您设置的目标与 GitOps 默认值匹配，则覆盖将被删除，而不是存储为冗余规则。
• 区域。有效的地理代码为 EU、CA、US、SI、JA、AU、IN、UK、CH、UAE、SK、GLOBAL — 在进行任何网络调用之前，在客户端，将其他任何内容传递到区域选项都会失败。
• 策略预览为只读状态。policy-previews get计算如果给定的监管策略处于活动状态， tenants get的形状会是什么样子 — 它不应用任何内容。

大纲

uip model-hub organizations get [--tenant <name>]
uip model-hub tenants get [--tenant <name>] [--force-refresh]
uip model-hub custom-routings get --product <name> --feature <name> --primary-model <id> --current-model <id> [--primary-model-region <region>] [--current-region <region>] [--tenant <name>]
uip model-hub custom-routings create --product <name> --feature <name> --primary-model <id> --primary-model-region <region> --current-model <id> --current-region <region> [--tenant <name>]
uip model-hub routing-history list --product <name> --feature <name> --model <id> [--tenant <name>]
uip model-hub policy-previews get <policy-id> [--tenant <name>]

所有动词也接受 --login-validity <minutes>（覆盖交互式登录令牌生存期）。

UIP Model- Hub 组织获取

获取模型中心组织概述 — 每个租户的模型计数（总数/活动/自定义/即将弃用）和阻止的条目总数。

选项

长	值	描述
--tenant <name>	字符串	目标租户名称（如果组织跨越多个租户计数要包含的作用域 — 否则提供信息）。
--login-validity <minutes>	整数	覆盖交互式登录令牌的生存期。

示例

uip model-hub organizations get

数据形状（--输出 json）

{
  "Code": "ModelHubOrganizationsGet",
  "Data": {
    "tenants": [
      {
        "tenantName": "DefaultTenant",
        "tenantId": "00000000-0000-0000-0000-000000000000",
        "region": "westeurope",
        "totalModels": 42,
        "activeModels": 38,
        "customModels": 2,
        "deprecatingSoonModels": 1,
        "blockedEntries": 0
      }
    ]
  }
}

uip 模型中心租户获取

获取当前租户的模型中心租户概述 - 按产品分组的每条路由规则，以及模型/托管者/状态/BYO 开启状态。

选项

长	值	描述
--tenant <name>	字符串	目标租户名称。
--force-refresh	标记	绕过支持此视图的任何缓存（包括已解决的策略），然后从来源重新提取。默认 false。
--login-validity <minutes>	整数	覆盖交互式登录令牌的生存期。

示例

uip model-hub tenants get

数据形状（--输出 json）

{
  "Code": "ModelHubTenantsGet",
  "Data": {
    "products": [
      {
        "modelHubProduct": "agenthub",
        "rules": [
          {
            "feature": "agenthub-llm-call",
            "model": "anthropic.claude-sonnet-4-20250514-v1:0",
            "managedBy": "UiPath",
            "modelStatus": "Active",
            "isBlocked": false,
            "isFeatureOnboardedToByo": false
          }
        ]
      }
    ]
  }
}

uip 模型中心自定义路由获取

在每个区域的模型可用性映射中查找（产品、功能、主要模型）元组 —--current-model --current-region在运行 之前使用此方法来选择有效的custom-routings create 值。

选项

长	值	必填	描述
--product <name>	字符串	是	模型中心产品，例如agenthub。
--feature <name>	字符串	是	产品中的功能，例如llm-call。
--primary-model <id>	字符串	是	要枚举其区域替代方案的基本规则的模型标识符。
--current-model <id>	字符串	是	服务器端请求验证为必填项，并在响应中回显 — 如果您没有其他选择，请传递与 --primary-model 相同的值。
--primary-model-region <region>	EU|CA|US|SI|JA|AU|IN|UK|CH|UAE|SK|GLOBAL	否	已发送以确保请求形状完整；不用于查找本身。
--current-region <region>	EU|CA|US|SI|JA|AU|IN|UK|CH|UAE|SK|GLOBAL	否	已发送以确保请求形状完整；不用于查找本身。
--tenant <name>	字符串	否	目标租户名称。
--login-validity <minutes>	整数	否	覆盖交互式登录令牌的生存期。

示例

uip model-hub custom-routings get \
  --product agenthub --feature llm-call \
  --primary-model gpt-5-mini-2025-08-07 --current-model gpt-5-mini-2025-08-07

数据形状（--输出 json）

{
  "Code": "ModelHubCustomRoutingsGet",
  "Data": {
    "organizationId": "00000000-0000-0000-0000-000000000000",
    "tenantId": "00000000-0000-0000-0000-000000000000",
    "modelHubProduct": "agenthub",
    "feature": "llm-call",
    "primaryModel": "gpt-5-mini-2025-08-07",
    "currentModel": "gpt-5-mini-2025-08-07",
    "availableModelsInRegions": {
      "EU": [{ "model": "gpt-5-mini-2025-08-07", "isBlockedByPolicy": false }],
      "US": [{ "model": "gpt-5-mini-2025-08-07", "isBlockedByPolicy": false }]
    }
  }
}

UIP Model- Hub 自定义路由 创建

更新并插入（产品、功能、主要模型）的自定义路由规则。如果请求的目标与 GitOps 默认目标匹配，则系统会删除现有自定义规则。返回生成的租户概述（与 tenants get 形状相同）。

选项

长	值	必填	描述
--product <name>	字符串	是	模型中心产品。
--feature <name>	字符串	是	产品中的功能。
--primary-model <id>	字符串	是	基本规则的模型标识符被覆盖。
--primary-model-region <region>	EU|CA|US|SI|JA|AU|IN|UK|CH|UAE|SK|GLOBAL	是	基本规则所在区域。
--current-model <id>	字符串	是	要路由到的目标模型（通常与 --primary-model 相同）。
--current-region <region>	EU|CA|US|SI|JA|AU|IN|UK|CH|UAE|SK|GLOBAL	是	要路由到的目标区域。
--tenant <name>	字符串	否	目标租户名称。
--login-validity <minutes>	整数	否	覆盖交互式登录令牌的生存期。

任一区域标志上的无效区域值都会导致客户端失败，并在任何网络调用之前列出接受的集合。

示例

uip model-hub custom-routings create \
  --product agenthub --feature llm-call \
  --primary-model gpt-5-mini-2025-08-07 --primary-model-region US \
  --current-model gpt-5-mini-2025-08-07 --current-region EU

数据形状（--输出 json）

形状与 tenants get 相同，反映更新插入操作后立即发出的规则 — 例如受影响规则的 modelRouting/effectiveDefaultModelRouting 将显示 "EU"。

UIP 模型中心路由历史列表

列出（产品、功能、模型）的路由规则更改历史记录 — 新旧模型和每次更改的区域、参与者和时间戳。

选项

长	值	必填	描述
--product <name>	字符串	是	模型中心产品。
--feature <name>	字符串	是	产品中的功能。
--model <id>	字符串	是	要检索其历史记录的模型标识符。
--tenant <name>	字符串	否	目标租户名称。
--login-validity <minutes>	整数	否	覆盖交互式登录令牌的生存期。

示例

uip model-hub routing-history list \
  --product agenthub --feature llm-call --model gpt-5.1-2025-11-13

数据形状（--输出 json）

{
  "Code": "ModelHubRoutingHistoryList",
  "Data": [
    {
      "product": "agenthub",
      "feature": "llm-call",
      "oldModel": "gpt-5.1-2025-11-13",
      "oldRegion": "EU",
      "oldConfigIsByo": false,
      "newModel": "gpt-5.1-2025-11-13",
      "newRegion": "CA",
      "newConfigIsByo": false,
      "actor": "User",
      "organizationId": "00000000-0000-0000-0000-000000000000",
      "tenantId": "00000000-0000-0000-0000-000000000000",
      "createdAt": "2026-05-22T10:15:00.000Z"
    }
  ]
}

actor 为 "System" 或 "User"。当元组没有历史记录时，Data 为 []，而不是错误。

uip 模型中心策略预览 获取

预览应用给定监管策略时生成的租户模型中心配置 — 响应形状与 tenants get 相同，计算根据 <policy-id> 而不是当前处于活动状态的策略。只读；不会激活任何内容。

参数

名称	必填	用途
<policy-id>	是	要预览的监管策略 ID。

选项

长	值	描述
--tenant <name>	字符串	目标租户名称。
--login-validity <minutes>	整数	覆盖交互式登录令牌的生存期。

示例

uip model-hub policy-previews get 11111111-2222-3333-4444-555555555555

数据形状（--输出 json）

{
  "Code": "ModelHubPolicyPreviewsGet",
  "Data": {
    "products": [
      {
        "modelHubProduct": "agenthub",
        "rules": [
          {
            "feature": "llm-call",
            "model": "gpt-5-mini-2025-08-07",
            "managedBy": "UiPath",
            "modelStatus": "Active",
            "isBlocked": true,
            "isFeatureOnboardedToByo": false
          }
        ]
      }
    ]
  }
}

错误行为

在身份验证/权限问题上，每个动词都以相同的方式失败：Instructions: "Ensure you are logged in with 'uip login' and your account has the OrganizationAdmin role for AI Trust Layer." — 检查 Message 以了解特定的基础错误。在任何网络调用之前，custom-routings get/create 上的区域标志验证失败，列出已接受的 EU/CA/US/SI/JA/AU/IN/UK/CH/UAE/SK/GLOBAL 集。

另请参阅

• uip llm-gateway — LLM 模型发现，此配置内容的读取端。
• uip llm-configuration — 由 BYO 启用的路由规则引用的 BYO LLM 连接。
• 工具（插件）
• 全局选项
• 退出代码