uip model-hub

「uip model-hub」の構文とオプション。LLM ゲートウェイのルーティング ルール (組織、テナント、カスタム ルーティング、ルーティング履歴、ポリシー プレビュー) の読み取り/構成ビューです。

uip model-hub 、 LLM ゲートウェイのルーティング に対する読み取り/構成ビューです。このビューでは、どのモデルが特定の (製品、機能) ペアをどのリージョンで、誰がその既定値を上書きできるかを判断します。5 つのコマンド グループ: 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 の組織は、以下を取得します。

Model Hub の組織の概要を取得する — テナントごとのモデル数 (合計/アクティブ/カスタム/非推奨化予定) と、ブロックされたエントリの合計。

オプション

長押し	値 (Value)	説明
--tenant <name>	string	対象のテナント名 (組織が複数のテナントにまたがっている場合に含めるテナントの数のスコープ。それ以外の場合は情報提供を目的とします)。
--login-validity <minutes>	integer	対話型ログイン トークンの有効期間を上書きします。

例

uip model-hub organizations get

データシェイプ(--output 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 model-hub テナントは、以下を取得します。

現在のテナントの Model Hub テナントの概要を取得します。すべてのルーティング ルールを、モデル/管理者/ステータス/BYO-onboarding ステートとともに製品別にグループ化します。

オプション

長押し	値 (Value)	説明
--tenant <name>	string	対象のテナント名。
--force-refresh	フラグ	このビュー (解決されたポリシーを含む) をサポートしているキャッシュをバイパスし、ソースから再取得します。既定 falseです。
--login-validity <minutes>	integer	対話型ログイン トークンの有効期間を上書きします。

例

uip model-hub tenants get

データシェイプ(--output 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 model-hub custom-routing get

(製品、機能、プライマリ モデル) タプルのリージョンごとのモデル可用性マップを検索します — 実行する前に有効な --current-model/--current-region 値を選択するために使用します custom-routings create。

オプション

長押し	値 (Value)	Required	説明
--product <name>	string	○	ハブ製品をモデル化します。例:agenthubです。
--feature <name>	string	○	製品内の機能 (例:llm-callです。
--primary-model <id>	string	○	列挙するリージョンの代替手段が存在するベース ルールのモデル識別子。
--current-model <id>	string	○	サーバー側の要求の検証で必要であり、応答でエコーバックされます。他に選択肢がない場合は、 --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>	string	×	対象のテナント名。
--login-validity <minutes>	integer	×	対話型ログイン トークンの有効期間を上書きします。

例

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

データシェイプ(--output 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 custom-routing 作成

(製品、機能、プライマリ モデル) のカスタム ルーティング ルールを更新/挿入します。要求されたターゲットが GitOps の既定値と一致する場合、代わりに既存のカスタム ルールが削除されます。結果のテナントの概要 ( tenants getと同じ形状) を返します。

オプション

長押し	値 (Value)	Required	説明
--product <name>	string	○	ハブ製品をモデル化します。
--feature <name>	string	○	製品内の機能。
--primary-model <id>	string	○	上書きされるベース ルールのモデル識別子
--primary-model-region <region>	EU|CA|US|SI|JA|AU|IN|UK|CH|UAE|SK|GLOBAL	○	基本ルールのリージョンです。
--current-model <id>	string	○	ルーティング先のターゲット モデルです (多くの場合、 --primary-modelと同じです)。
--current-region <region>	EU|CA|US|SI|JA|AU|IN|UK|CH|UAE|SK|GLOBAL	○	ルーティング先のターゲット リージョンです。
--tenant <name>	string	×	対象のテナント名。
--login-validity <minutes>	integer	×	対話型ログイン トークンの有効期間を上書きします。

どちらのリージョン フラグにも無効なリージョン値があると、ネットワーク呼び出しの前にクライアント側で失敗し、受け入れられたセットが一覧表示されます。

例

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

データシェイプ(--output json)

tenants getと同じ形状で、更新/挿入の直後にルールが反映されます (例: 影響を受けるルールのmodelRouting/effectiveDefaultModelRoutingには "EU"と表示されます。

uip model-hub ルーティング履歴リスト

(製品、機能、モデル)のルーティングルールの変更履歴のリスト — 変更ごとの新旧モデルとリージョン、アクター、タイムスタンプ。

オプション

長押し	値 (Value)	Required	説明
--product <name>	string	○	ハブ製品をモデル化します。
--feature <name>	string	○	製品内の機能。
--model <id>	string	○	履歴を取得するモデル識別子です。
--tenant <name>	string	×	対象のテナント名。
--login-validity <minutes>	integer	×	対話型ログイン トークンの有効期間を上書きします。

例

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

データシェイプ(--output 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 model-hub policy-previews get

特定のガバナンス ポリシーが適用された場合に実行されるテナントの Model Hub の設定をプレビューします ( tenants getと同じ応答形態 を、現在アクティブなポリシーではなく <policy-id> に対して計算)。読み取り専用。何もアクティブにしません。

引数

名前	Required	目的
<policy-id>	○	ガバナンス ポリシー ID をプレビューします。

オプション

長押し	値 (Value)	説明
--tenant <name>	string	対象のテナント名。
--login-validity <minutes>	integer	対話型ログイン トークンの有効期間を上書きします。

例

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

データシェイプ(--output 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 接続です。
• ツール (プラグイン)
• グローバル オプション
• 終了コード