UIP model-hub

Sintaxis y opciones para `uip model-hub`, una vista de lectura/configuración sobre las reglas de enrutamiento de puerta de enlace de LLM: organizaciones, tenants, enrutamiento personalizado, historial de enrutamiento y vistas previas de políticas.

uip model-hub una vista de lectura/configuración sobre el enrutamiento de puerta de enlace de LLM : qué modelo respalda un par determinado (producto, característica), en qué región y quién puede anular ese valor predeterminado. Cinco grupos de comandos: organizations, tenants, custom-routings, routing-history, policy-previews. Todos requieren el rol OrganizationAdmin para AI Trust Layer.

Consulta uip llm-gateway para la API del lado del descubrimiento que esta configuración alimenta en última instancia.

Conceptos

• Producto/característica/modelo. Una regla de enrutamiento está marcada por un --product (por ejemplo agenthub), un --feature dentro de él (por ejemplo llm-call) y un identificador --model. tenants get devuelve todas las reglas para el tenant actual, agrupadas por producto.
• El enrutamiento personalizado anula el predeterminado. custom-routings create inserta una regla que redirige una tupla (producto, característica, modelo principal) de su región predeterminada a un par de modelo/región diferente; si el destino que estableces coincide con el valor predeterminado de GitOps, la anulación se elimina en lugar de almacenarse como una regla redundante.
• Regiones. Los códigos geográficos válidos son EU, CA, US, SI, JA, AU, IN, UK, CH, UAE, SK, GLOBAL — pasar cualquier otra cosa a una opción de región falla en el lado del cliente antes de cualquier llamada de red.
• Las vistas previas de las políticas son de solo lectura. policy-previews get calcula cómo se vería la forma de tenants get si una política de control determinada estuviera activa; no aplica nada.

Sinopsis

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

Todos los verbos también aceptan --login-validity <minutes> (anulan la vigencia del token de inicio de sesión interactivo).

las organizaciones de model-hub de uip obtienen

Obtener la descripción general de la organización de Model Hub: recuentos de modelos por tenant (total/activo/personalizado/obsoleto pronto) y totales de entradas bloqueadas.

Opciones

Largo	Valor	Descripción
--tenant <name>	String	Nombre del tenant de destino (ámbitos de los recuentos de tenants que se incluirán si la organización abarca varios; de lo contrario, informativo).
--login-validity <minutes>	Entero	Anula la vigencia del token de inicio de sesión interactivo.

Ejemplo

uip model-hub organizations get

Forma de datos (--json de salida)

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

los tenants de model-hub de uip obtienen

Obtén la descripción general del tenant de Model Hub para el tenant actual: cada regla de enrutamiento, agrupada por producto, con el estado de modelo/gestionado por/estado/BYO-onboarding.

Opciones

Largo	Valor	Descripción
--tenant <name>	String	Nombre del tenant de destino.
--force-refresh	Marca	Omita cualquier caché que respalde esta vista (incluida la política resuelta) y vuelva a obtenerla desde el origen. Predeterminado false.
--login-validity <minutes>	Entero	Anula la vigencia del token de inicio de sesión interactivo.

Ejemplo

uip model-hub tenants get

Forma de datos (--json de salida)

{
  "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-routings get

Busca el mapa de disponibilidad de modelos por región para una tupla (producto, característica, modelo principal): utilízalo para elegir valores --current-model/--current-region válidos antes de ejecutar custom-routings create.

Opciones

Largo	Valor	Obligatorio	Descripción
--product <name>	String	Sí	Producto de Model Hub, por ejemplo agenthub.
--feature <name>	String	Sí	Característica dentro del producto, por ejemplo llm-call.
--primary-model <id>	String	Sí	Identificador del modelo de la regla base cuyas alternativas regionales se van a enumerar.
--current-model <id>	String	Sí	Requerido por la validación de la solicitud del lado del servidor y reflejado en la respuesta: pasa el mismo valor que --primary-model si aún no tienes otra opción.
--primary-model-region <region>	EU|CA|US|SI|JA|AU|IN|UK|CH|UAE|SK|GLOBAL	No	Enviado para completar la forma de la solicitud; no se utiliza para la búsqueda en sí.
--current-region <region>	EU|CA|US|SI|JA|AU|IN|UK|CH|UAE|SK|GLOBAL	No	Enviado para completar la forma de la solicitud; no se utiliza para la búsqueda en sí.
--tenant <name>	String	No	Nombre del tenant de destino.
--login-validity <minutes>	Entero	No	Anula la vigencia del token de inicio de sesión interactivo.

Ejemplo

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

Forma de datos (--json de salida)

{
  "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-routings create

Insertar una regla de enrutamiento personalizada para (producto, característica, modelo principal). Si el destino solicitado coincide con el valor predeterminado de GitOps, se elimina la regla personalizada existente en su lugar. Devuelve la descripción general del tenant resultante (la misma forma que tenants get).

Opciones

Largo	Valor	Obligatorio	Descripción
--product <name>	String	Sí	Producto de Model Hub.
--feature <name>	String	Sí	Característica dentro del producto.
--primary-model <id>	String	Sí	Se está anulando el identificador del modelo de la regla base.
--primary-model-region <region>	EU|CA|US|SI|JA|AU|IN|UK|CH|UAE|SK|GLOBAL	Sí	Región de la regla base.
--current-model <id>	String	Sí	Modelo de destino al que enrutar (a menudo el mismo que --primary-model).
--current-region <region>	EU|CA|US|SI|JA|AU|IN|UK|CH|UAE|SK|GLOBAL	Sí	Región de destino a la que enrutar.
--tenant <name>	String	No	Nombre del tenant de destino.
--login-validity <minutes>	Entero	No	Anula la vigencia del token de inicio de sesión interactivo.

Los valores de región no válidos en cualquiera de los marcadores de región fallan en el lado del cliente, enumerando el conjunto aceptado, antes de cualquier llamada de red.

Ejemplo

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

Forma de datos (--json de salida)

La misma forma que tenants get, reflejando la regla inmediatamente después del upsert — p. ej. modelRouting/effectiveDefaultModelRouting de la regla afectada mostrará "EU".

lista de historial de enrutamiento de model-hub de uip

Enumerar el historial de cambios de la regla de enrutamiento para un (producto, característica, modelo): modelo antiguo/nuevo y región por cambio, el actor y la marca de tiempo.

Opciones

Largo	Valor	Obligatorio	Descripción
--product <name>	String	Sí	Producto de Model Hub.
--feature <name>	String	Sí	Característica dentro del producto.
--model <id>	String	Sí	Identificador del modelo cuyo historial se va a recuperar.
--tenant <name>	String	No	Nombre del tenant de destino.
--login-validity <minutes>	Entero	No	Anula la vigencia del token de inicio de sesión interactivo.

Ejemplo

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

Forma de datos (--json de salida)

{
  "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 es "System" o "User". Data es [] cuando no hay historial para la tupla, no es un error.

uip model-hub policy-previews get

Vista previa de la configuración de Model Hub del tenant que resultaría si se aplicara una política de gobernanza determinada: la misma forma de respuesta que tenants get, calculada contra <policy-id> en lugar de la política actualmente activa. Solo lectura; no activa nada.

Argumentos

Nombre	Obligatorio	Propósito
<policy-id>	Sí	ID de política de control para previsualizar.

Opciones

Largo	Valor	Descripción
--tenant <name>	String	Nombre del tenant de destino.
--login-validity <minutes>	Entero	Anula la vigencia del token de inicio de sesión interactivo.

Ejemplo

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

Forma de datos (--json de salida)

{
  "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
          }
        ]
      }
    ]
  }
}

Comportamiento de error

Todos los verbos fallan de la misma manera en un problema de autorización/permiso: Instructions: "Ensure you are logged in with 'uip login' and your account has the OrganizationAdmin role for AI Trust Layer." — comprueba Message para ver el error subyacente específico. La validación del marcador de región en custom-routings get/create falla antes de cualquier llamada de red, enumerando los EU/CA/US/SI/JA/AU/IN/UK/CH/UAE/SK/GLOBAL conjunto.

Ver también

• uip llm-gateway — Descubrimiento de modelos LLM, el lado de lectura de lo que esto configura.
• uip llm-configuration — Conexiones BYO LLM referenciadas por reglas de enrutamiento incorporadas BYO.
• Herramientas (complementos)
• Opciones globales
• Códigos de salida