uip model-hub

Syntaxe et options pour `uip model-hub`, une vue de lecture/configuration des règles de routage de la passerelle LLM — organisations, locataires, routages personnalisés, historique du routage et aperçus des politiques.

uip model-hub est une vue de lecture/configuration du routage de la passerelle LLM — quel modèle prend en charge une paire donnée (produit, fonctionnalité), dans quelle région et qui peut remplacer cette valeur par défaut. Cinq groupes de commandes: organizations, tenants, custom-routings, routing-history, policy-previews. Tous nécessitent le rôle OrganizationAdmin pour AI Trust Layer.

Voir uip llm-gateway pour les flux d'API côté découverte de cette configuration.

Concepts

• Produit/fonction/modèle. Une règle de routage est accessible par un --product (par ex. agenthub), un --feature à l'intérieur (par ex. llm-call) et un identifiant --model. tenants get renvoie chaque règle pour le locataire actuel, regroupée par produit.
• Le routage personnalisé remplace le routage par défaut. custom-routings create insère une règle qui redirige un Tuple (produit, fonctionnalité, modèle principal) de sa région par défaut vers une paire modèle/région différente; si la cible que vous définissez correspond à la valeur GitOps par défaut, le remplacement est supprimé plutôt que stocké en tant que règle redondante.
• Régions. Les codes de zone valides sont EU, CA, US, SI, JA, AU, IN, UK, CH, UAE, SK, GLOBAL — la transmission de quoi que ce soit à une option de région échoue côté client avant tout appel réseau.
• Les aperçus des stratégies sont en lecture seule. policy-previews get calcule la forme de tenants get si une politique de gouvernance donnée était active — elle n'applique rien.

Synthèse

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

Tous les verbes acceptent également --login-validity <minutes> (remplacer la durée de vie du jeton de connexion interactive).

Organisations uip model-hub

Récupérez la vue d’ensemble de l’organisation Model Hub — les chiffres des modèles par locataire (total/actif/personnalisé/obsolète-bientôt obsolète) et les totaux des entrées bloquées.

Options

Long	Valeur (Value)	Description
--tenant <name>	string	Nom du locataire cible (étendues que les comptages de locataires doivent inclure si l’organisation s’étend sur plusieurs — dans le cas contraire informatif).
--login-validity <minutes>	Integer	Remplacer la durée de vie du jeton de connexion interactive.

Exemple

uip model-hub organizations get

Format des données (--sortie 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 - Obtenir des locataires

Récupérez la vue d’ensemble du locataire Model Hub pour le locataire actuel - chaque règle de routage, regroupée par produit, avec l’état de modèle/géré par/status/BYO-intégration.

Options

Long	Valeur (Value)	Description
--tenant <name>	string	Nom du locataire cible.
--force-refresh	Drapeau	Ignorez tout cache prenant en charge cette vue (y compris la stratégie résolue) et récupérez à partir de la source. Par défaut false.
--login-validity <minutes>	Integer	Remplacer la durée de vie du jeton de connexion interactive.

Exemple

uip model-hub tenants get

Format des données (--sortie 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 routages personnalisés obtenir

Recherchez la carte de disponibilité du modèle par région pour un Tuple (produit, fonctionnalité, modèle principal) - utilisez-la pour choisir des valeurs --current-model/--current-region valides avant d'exécuter custom-routings create.

Options

Long	Valeur (Value)	Requis	Description
--product <name>	string	oui	Produit Hub, par exemple agenthub.
--feature <name>	string	oui	Fonctionnalité au sein du produit, par exemple llm-call.
--primary-model <id>	string	oui	Identifiant du modèle de la règle de base dont les alternatives régionales doivent être énumérées.
--current-model <id>	string	oui	Requis par la validation de la demande côté serveur et renvoyé dans la réponse — transmettez la même valeur que --primary-model si vous n'avez pas encore d'autre choix.
--primary-model-region <region>	EU|CA|US|SI|JA|AU|IN|UK|CH|UAE|SK|GLOBAL	non	Envoyé pour vérifier l’exhaustivité de la forme de la demande; non utilisé pour la recherche elle-même.
--current-region <region>	EU|CA|US|SI|JA|AU|IN|UK|CH|UAE|SK|GLOBAL	non	Envoyé pour vérifier l’exhaustivité de la forme de la demande; non utilisé pour la recherche elle-même.
--tenant <name>	string	non	Nom du locataire cible.
--login-validity <minutes>	Integer	non	Remplacer la durée de vie du jeton de connexion interactive.

Exemple

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

Format des données (--sortie 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 }]
    }
  }
}

Création de routages personnalisés uip model-hub

Mettez à jour et insérez une règle de routage personnalisée pour (produit, fonctionnalité, modèle principal). Si la cible demandée correspond à la version GitOps par défaut, la règle personnalisée existante est supprimée à la place. Renvoie la vue d’ensemble du locataire obtenue (même forme que tenants get).

Options

Long	Valeur (Value)	Requis	Description
--product <name>	string	oui	Produit Model Hub.
--feature <name>	string	oui	Fonctionnalité au sein du produit.
--primary-model <id>	string	oui	L’identificateur du modèle de la règle de base est remplacé.
--primary-model-region <region>	EU|CA|US|SI|JA|AU|IN|UK|CH|UAE|SK|GLOBAL	oui	Région de la règle de base.
--current-model <id>	string	oui	Modèle cible vers lequel acheminer (souvent le même que --primary-model).
--current-region <region>	EU|CA|US|SI|JA|AU|IN|UK|CH|UAE|SK|GLOBAL	oui	Région cible vers laquelle acheminer.
--tenant <name>	string	non	Nom du locataire cible.
--login-validity <minutes>	Integer	non	Remplacer la durée de vie du jeton de connexion interactive.

Les valeurs de région non valides sur l’un ou l’autre des indicateurs de région échouent côté client, indiquant l’ensemble accepté, avant tout appel réseau.

Exemple

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

Format des données (--sortie json)

Même forme que tenants get, reflétant la règle immédiatement après l'upsert — par exemple le modelRouting/effectiveDefaultModelRouting de la règle affectée affichera "EU".

uip model-hub routage-historique liste

Répertoriez l'historique des modifications des règles de routage pour un (produit, fonctionnalité, modèle) — ancien/nouveau modèle et région par modification, l'acteur et l'horodatage.

Options

Long	Valeur (Value)	Requis	Description
--product <name>	string	oui	Produit Model Hub.
--feature <name>	string	oui	Fonctionnalité au sein du produit.
--model <id>	string	oui	Identifiant du modèle dont récupérer l'historique.
--tenant <name>	string	non	Nom du locataire cible.
--login-validity <minutes>	Integer	non	Remplacer la durée de vie du jeton de connexion interactive.

Exemple

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

Format des données (--sortie 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 est "System" ou "User". Data est [] lorsqu'il n'y a pas d'historique pour le Tuple, et non une erreur.

uip model-hub politique-aperçus obtenir

Prévisualisez la configuration de Model Hub qui en résulterait si une politique de gouvernance donnée était appliquée — même forme de réponse que tenants get, calculée par rapport à <policy-id> au lieu de la politique actuellement active. En lecture seule; n'active rien.

Arguments

Nom	Requis	Objectif
<policy-id>	oui	ID de politique de gouvernance à prévisualiser.

Options

Long	Valeur (Value)	Description
--tenant <name>	string	Nom du locataire cible.
--login-validity <minutes>	Integer	Remplacer la durée de vie du jeton de connexion interactive.

Exemple

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

Format des données (--sortie 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
          }
        ]
      }
    ]
  }
}

Comportement des erreurs

Chaque verbe échoue de la même manière sur un problème d'authentification/autorisation: Instructions: "Ensure you are logged in with 'uip login' and your account has the OrganizationAdmin role for AI Trust Layer." — vérifiez Message pour l'erreur sous-jacente spécifique. La validation de l’indicateur de région sur custom-routings get/create échoue avant tout appel réseau, affichant le EU/CA/US/SI/JA/AU/IN/UK/CH/UAE/SK/GLOBAL défini.

Voir également

• uip llm-gateway — Découverte de modèles LLM, côté lecture de ce que cela configure.
• uip llm-configuration — Connexions LLM BYO référencées par des règles de routage intégrées BYO.
• Outils (extensions)
• Options globales
• Codes de sortie