UIP-Modellhub

Syntax und Optionen für „uip Model-Hub“, eine Lese-/Konfigurationsansicht über LLM Gateway-Routingregeln – Organisationen, Mandanten, benutzerdefinierte Routings, Routingverlauf und Richtlinienvorschau.

uip model-hub ist eine Lese-/Konfigurationsansicht über das LLM Gateway-Routing – welches Modell ein bestimmtes (Produkt, Funktion)-Paar unterstützt, in welcher Region und wer diesen Standard überschreiben kann. Fünf Befehlsgruppen: organizations, tenants, custom-routings, routing-history, policy-previews. Alle erfordern die Rolle OrganizationAdmin für AI Trust Layer.

Die erkennungsseitige API, die diese Konfiguration endgültig feeds, finden Sie unter uip llm-gateway .

Konzepte

• Produkt/Funktion/Modell. Eine Routing-Regel wird durch einen --product (z. B. agenthub), ein --feature darin (z. B. llm-call) und einen --model -Bezeichner. tenants get gibt jede Regel für den aktuellen Mandanten zurück, gruppiert nach Produkt.
• Benutzerdefiniertes Routing überschreibt den Standard. custom-routings create führt einen Upsert für eine Regel durch, die ein Tupel (Produkt, Funktion, primäres Modell) von seiner Standardregion zu einem anderen Modell-/Regionspaar umleitet; Wenn das von Ihnen festgelegte Ziel dem GitOps-Standardwert entspricht, wird die Überschreibung entfernt, anstatt als redundante Regel gespeichert zu werden.
• Regionen. Die gültigen Geographie-Codes sind EU, CA, US, SI, JA, AU, IN, UK, CH, UAE, SK, GLOBAL – Das Übergeben von etwas anderem an eine Regionsoption schlägt auf der Clientseite vor einem Netzwerkaufruf fehl.
• Richtlinienvorschau sind schreibgeschützt. policy-previews get berechnet, wie die Form von tenants get aussehen würde , wenn eine bestimmte Governance-Richtlinie aktiv wäre – es wird nichts angewendet.

Zusammenfassung

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>]

Alle Verben akzeptieren auch --login-validity <minutes> (überschreiben die Lebensdauer des interaktiven Anmeldetokens).

UIP Model-Hub-Organisationen erhalten

Rufen Sie die Model Hub-Organisationsübersicht ab – Anzahl der Modelle pro Mandant (insgesamt/aktiv/benutzerdefiniert/kurz veraltet) und Gesamtzahlen für blockierte Einträge.

Optionen

Long	Wert	Beschreibung
--tenant <name>	string	Name des Zielmandanten (Scopes, zu denen der Mandant gehört, wenn die Organisation mehrere umfasst – andernfalls informativ).
--login-validity <minutes>	Integer	Überschreiben Sie die Lebensdauer des interaktiven Anmeldetokens.

Beispiel

uip model-hub organizations get

Datenform (--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-Modell-Hub-Mandanten abrufen

Rufen Sie die Model Hub-Mandantenübersicht für den aktuellen Mandanten ab – jede Routing-Regel, gruppiert nach Produkt, mit Modell/verwaltet-von/Status/BYO-onboarding.

Optionen

Long	Wert	Beschreibung
--tenant <name>	string	Name des Zielmandanten.
--force-refresh	Markieren	Umgehen Sie alle Caches, die diese Ansicht unterstützen (einschließlich der aufgelösten Richtlinie), und rufen Sie erneut aus der Quelle ab. Der Standardwert ist false.
--login-validity <minutes>	Integer	Überschreiben Sie die Lebensdauer des interaktiven Anmeldetokens.

Beispiel

uip model-hub tenants get

Datenform (--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
          }
        ]
      }
    ]
  }
}

Abrufen von benutzerdefinierten UIP Model-Hub-Routings

Suchen Sie nach der Modellverfügbarkeitskarte pro Region für ein Tupel (Produkt, Funktion, primäres Modell) – verwenden Sie dies, um gültige --current-model/--current-region -Werte auszuwählen, bevor Sie custom-routings create ausführen.

Optionen

Long	Wert	Erforderlich	Beschreibung
--product <name>	string	ja	Model Hub-Produkt, z. B. agenthub).
--feature <name>	string	ja	Funktion innerhalb des Produkts, z. B. llm-call).
--primary-model <id>	string	ja	Modellbezeichner der Basisregel, dessen regionale Alternativen aufgezählt werden sollen.
--current-model <id>	string	ja	Erforderlich für die serverseitige Anforderungsvalidierung und wird in der Antwort zurückgegeben – übergeben Sie denselben Wert wie --primary-model, wenn Sie noch keine andere Wahl haben.
--primary-model-region <region>	EU|CA|US|SI|JA|AU|IN|UK|CH|UAE|SK|GLOBAL	nein	Für die Vollständigkeit der Anforderungsform gesendet; wird nicht für die Suche selbst verwendet.
--current-region <region>	EU|CA|US|SI|JA|AU|IN|UK|CH|UAE|SK|GLOBAL	nein	Für die Vollständigkeit der Anforderungsform gesendet; wird nicht für die Suche selbst verwendet.
--tenant <name>	string	nein	Name des Zielmandanten.
--login-validity <minutes>	Integer	nein	Überschreiben Sie die Lebensdauer des interaktiven Anmeldetokens.

Beispiel

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

Datenform (--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 }]
    }
  }
}

Benutzerdefinierte UIP-Modell-Hub-Routings erstellen

Führen Sie einen Upsert einer benutzerdefinierten Routingregel für (Produkt, Funktion, primäres Modell) durch. Wenn das angeforderte Ziel dem GitOps-Standardwert entspricht, wird stattdessen die vorhandene benutzerdefinierte Regel entfernt. Gibt die resultierende Mandantenübersicht zurück (dieselbe Form wie tenants get).

Optionen

Long	Wert	Erforderlich	Beschreibung
--product <name>	string	ja	Model Hub-Produkt.
--feature <name>	string	ja	Funktion innerhalb des Produkts.
--primary-model <id>	string	ja	Der Modellbezeichner der Basisregel wird überschrieben.
--primary-model-region <region>	EU|CA|US|SI|JA|AU|IN|UK|CH|UAE|SK|GLOBAL	ja	Region der Basisregel.
--current-model <id>	string	ja	Zielmodell, an das weitergeleitet werden soll (oft mit --primary-model identisch).
--current-region <region>	EU|CA|US|SI|JA|AU|IN|UK|CH|UAE|SK|GLOBAL	ja	Zielregion, zu der weitergeleitet werden soll.
--tenant <name>	string	nein	Name des Zielmandanten.
--login-validity <minutes>	Integer	nein	Überschreiben Sie die Lebensdauer des interaktiven Anmeldetokens.

Ungültige Regionswerte auf einem der beiden Regions-Flags schlagen auf der Clientseite fehl und listen den akzeptierten Satz vor einem Netzwerkaufruf auf.

Beispiel

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

Datenform (--output json)

Die gleiche Form wie tenants get, die die Regel sofort nach dem Upsert widerspiegelt – z. B. modelRouting/effectiveDefaultModelRouting der betroffenen Regel zeigt "EU" an.

UIP Model-Hub Routing-History-Liste

Listen Sie den Änderungsverlauf der Routing-Regel für ein (Produkt, Funktion, Modell) – altes/neues Modell und eine Region pro Änderung, den Akteur und den Zeitstempel auf.

Optionen

Long	Wert	Erforderlich	Beschreibung
--product <name>	string	ja	Model Hub-Produkt.
--feature <name>	string	ja	Funktion innerhalb des Produkts.
--model <id>	string	ja	Modellbezeichner, dessen Verlauf abgerufen werden soll.
--tenant <name>	string	nein	Name des Zielmandanten.
--login-validity <minutes>	Integer	nein	Überschreiben Sie die Lebensdauer des interaktiven Anmeldetokens.

Beispiel

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

Datenform (--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 ist "System" oder "User". Data ist [], wenn für das Tupel kein Verlauf vorhanden ist, kein Fehler.

Abrufen von UIP Model-Hub Policy-Previews

Zeigen Sie eine Vorschau der Model Hub-Konfiguration des Mandanten an, die sich ergeben würde, wenn eine bestimmte Governance-Richtlinie angewendet wurde – dieselbe Antwortform wie tenants get, berechnet für <policy-id> anstelle der derzeit aktiven Richtlinie. Schreibgeschützt; aktiviert nichts.

Argumente

Name	Erforderlich	Zweck
<policy-id>	ja	Governance-Richtlinien-ID zur Vorschau.

Optionen

Long	Wert	Beschreibung
--tenant <name>	string	Name des Zielmandanten.
--login-validity <minutes>	Integer	Überschreiben Sie die Lebensdauer des interaktiven Anmeldetokens.

Beispiel

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

Datenform (--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
          }
        ]
      }
    ]
  }
}

Fehlerverhalten

Jedes Verb schlägt auf die gleiche Weise bei einem Authentifizierungs-/Berechtigungsproblem fehl: Instructions: "Ensure you are logged in with 'uip login' and your account has the OrganizationAdmin role for AI Trust Layer." – überprüfen Sie Message auf den spezifischen zugrunde liegenden Fehler. Die Region-Flag-Validierung für custom-routings get/create schlägt vor einem Netzwerkaufruf fehl und die akzeptierten EU/CA/US/SI/JA/AU/IN/{ werden aufgelistet. UK/CH/UAE/SK/GLOBAL festgelegt.

Siehe auch

• uip llm-gateway – LLM-Modellerkennung, die Leseseite der Konfiguration.
• uip llm-configuration – BYO LLM-Verbindungen, auf die durch BYO-onboarded Routingregeln verwiesen wird.
• Tools (Plugins)
• Globale Optionen
• Exitcodes