hub de modelo da uip

Sintaxe e opções para "uip model-hub", uma visualização de leitura/configuração das regras de roteamento do gateway de LLM — organizações, tenants, roteamentos personalizados, histórico de roteamento e visualizações de políticas.

uip model-hub uma visualização de leitura/configuração sobre o roteamento do Gateway de LLM — qual modelo suporta um determinado par (produto, funcionalidade), em qual região e quem pode substituir esse padrão. Cinco grupos de comando: organizations, tenants, custom-routings, routing-history, policy-previews. Todos exigem a função OrganizationAdmin para a AI Trust Layer.

Consulte uip llm-gateway para obter a API do lado da descoberta que essa configuração gera.

Conceitos

• Produto / funcionalidade / modelo. Uma regra de roteamento é chaveada por um --product (por exemplo agenthub), um --feature dentro dela (por exemplo llm-call), e um identificador --model. tenants get retorna todas as regras para o tenant atual, agrupadas por produto.
• O roteamento personalizado substitui o padrão. custom-routings create faz um upsert de uma regra que redireciona uma tupla (produto, funcionalidade, modelo primário) de sua região padrão para um par de modelo/região diferente; se o destino que você definir corresponder ao padrão do GitOps, a substituição será removida em vez de armazenada como uma regra redundante.
• Regiões. Os códigos de geografia válidos são EU, CA, US, SI, JA, AU, IN, UK, CH, UAE, SK, GLOBAL — passar qualquer outra coisa para uma opção de região falha no lado do cliente antes de qualquer chamada de rede.
• As visualizações de políticas são somente leitura. policy-previews get como seria a aparência da forma de tenants get se uma determinada política de governança estivesse ativa — ele não aplica nada.

Resumo

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 os verbos também aceitam --login-validity <minutes> (substituir o tempo de vida do token de login interativo).

as organizações do modelo uip-hub obtêm

Busque a visão geral da organização do Model Hub — contagens de modelos por tenant (total/ativo/personalizado/descontinuado em breve) e totais de entradas bloqueadas.

Opções

Long	Valor	Description
--tenant <name>	String	Nome do tenant de destino (escopos quais contagens do tenant devem incluir se a organização abranger várias — caso contrário, informativo).
--login-validity <minutes>	Número inteiro	Substitua a vida útil do token de login interativo.

Exemplo

uip model-hub organizations get

Formato dos dados (--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
      }
    ]
  }
}

os tenants do modelo-hub do uip obter

Buscar a visão geral do tenant do Modelo Hub para o tenant atual — todas as regras de roteamento, agrupadas por produto, com o estado de integração de modelo/gerenciado por/status/BYO.

Opções

Long	Valor	Description
--tenant <name>	String	Nome do tenant de destino.
--force-refresh	Bandeira	Ignore qualquer cache que apoia esta visualização (incluindo a política resolvida) e busque novamente na origem. falsePadrão.
--login-validity <minutes>	Número inteiro	Substitua a vida útil do token de login interativo.

Exemplo

uip model-hub tenants get

Formato dos dados (--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
          }
        ]
      }
    ]
  }
}

roteamentos personalizados do hub do modelo uip get

Procure no mapa de disponibilidade do modelo por região para uma tupla (produto, funcionalidade, modelo primário) — use isso para escolher valores --current-model/--current-region válidos antes de executar custom-routings create.

Opções

Long	Valor	Required	Description
--product <name>	String	sim	Produto do Hub de modelo, por exemplo agenthub).
--feature <name>	String	sim	Funcionalidade dentro do produto, por exemplo llm-call).
--primary-model <id>	String	sim	O identificador do modelo da regra de base cujas alternativas regionais serão enumeradas.
--current-model <id>	String	sim	Exigido pela validação da solicitação no lado do servidor e retornado na resposta — passe o mesmo valor que --primary-model se você ainda não tiver outra escolha.
--primary-model-region <region>	EU|CA|US|SI|JA|AU|IN|UK|CH|UAE|SK|GLOBAL	não	Enviado para integridade da forma de solicitação; não usado para a pesquisa em si.
--current-region <region>	EU|CA|US|SI|JA|AU|IN|UK|CH|UAE|SK|GLOBAL	não	Enviado para integridade da forma de solicitação; não usado para a pesquisa em si.
--tenant <name>	String	não	Nome do tenant de destino.
--login-validity <minutes>	Número inteiro	não	Substitua a vida útil do token de login interativo.

Exemplo

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

Formato dos dados (--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 }]
    }
  }
}

roteamentos personalizados do hub do modelo do uip criar

Faça upsert de uma regra de roteamento personalizada para (produto, funcionalidade, modelo principal). Se o destino solicitado corresponder ao padrão do GitOps, a regra personalizada existente será removida. Retorna a visão geral do tenant resultante (mesma forma que tenants get).

Opções

Long	Valor	Required	Description
--product <name>	String	sim	Produto do Hub de modelo.
--feature <name>	String	sim	Funcionalidade dentro do produto.
--primary-model <id>	String	sim	Identificador do modelo da regra base sendo substituído.
--primary-model-region <region>	EU|CA|US|SI|JA|AU|IN|UK|CH|UAE|SK|GLOBAL	sim	Região da regra de base.
--current-model <id>	String	sim	Modelo de destino para o qual rotear (muitas vezes o mesmo que --primary-model).
--current-region <region>	EU|CA|US|SI|JA|AU|IN|UK|CH|UAE|SK|GLOBAL	sim	Região de destino para a qual rotear.
--tenant <name>	String	não	Nome do tenant de destino.
--login-validity <minutes>	Número inteiro	não	Substitua a vida útil do token de login interativo.

Os valores de região inválidos em qualquer sinalizador de região falham no lado do cliente, listando o conjunto aceito, antes de qualquer chamada de rede.

Exemplo

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

Formato dos dados (--output json)

Mesma forma que tenants get, refletindo a regra imediatamente após o upsert — por exemplo o modelRouting/effectiveDefaultModelRouting da regra afetada mostrará "EU".

lista de histórico de roteamento do hub do modelo uip

Liste o histórico de alterações das regras de roteamento para um (produto, funcionalidade, modelo) — modelo antigo/novo e região por alteração, o ator e o carimbo de data/hora.

Opções

Long	Valor	Required	Description
--product <name>	String	sim	Produto do Hub de modelo.
--feature <name>	String	sim	Funcionalidade dentro do produto.
--model <id>	String	sim	Identificador do modelo cujo histórico será recuperado.
--tenant <name>	String	não	Nome do tenant de destino.
--login-validity <minutes>	Número inteiro	não	Substitua a vida útil do token de login interativo.

Exemplo

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

Formato dos dados (--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"ou. Data é [] quando não há histórico para a tupla, não é um erro.

visualizações da política do hub do modelo uip get

Visualize a configuração do Hub do Modelo do tenant que resultaria se uma determinada política de governança fosse aplicada — mesmo formato de resposta que tenants get, calculado em relação a <policy-id> em vez da política atualmente ativa. SomenteLeitura; não ativa nada.

Argumentos

Name	Required	Finalidade
<policy-id>	sim	ID da política de governança para visualizar.

Opções

Long	Valor	Description
--tenant <name>	String	Nome do tenant de destino.
--login-validity <minutes>	Número inteiro	Substitua a vida útil do token de login interativo.

Exemplo

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

Formato dos dados (--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
          }
        ]
      }
    ]
  }
}

Comportamento de erro

Cada verbo falha da mesma maneira em um problema de autenticação/permissão: Instructions: "Ensure you are logged in with 'uip login' and your account has the OrganizationAdmin role for AI Trust Layer." — verifique Message para o erro subjacente específico. A validação de sinalizador de região em custom-routings get/create falha antes de qualquer chamada de rede, listando os EU/CA/US/SI/JA/AU/IN/{ aceitosUK/CH/UAE/SK/GLOBAL definido.

Veja também

• uip llm-gateway — Descoberta de modelos de LLM, o lado de leitura do que isso configura.
• uip llm-configuration — Conexões BYO LLM referenciadas por regras de roteamento integradas BYO.
• Ferramentas ( plugins )
• Opções globais
• Códigos de saída