Gerenciamento de modelos no hub de modelo

Gerencie o roteamento do modelo e as configurações de LLM personalizadas no hub de modelo, verifique o status da configuração, reabilite as configurações desabilitadas e revise o histórico da configuração.

Na grade de tenants do Hub de modelos, você pode alterar como um produto e recurso roteiam o tráfego de LLM, substituir o modelo que dá suporte ao mapeamento e consultar o histórico de configuração. Todas as ações se aplicam ao tenant atual.

Pré-requisitos

• Acesso ao Hub de modelos no nível do tenant.
• O produto e a funcionalidade estão habilitados para o tenant.
• Para uma configuração de LLM personalizada — Bring Your Own Subscription (BYOS) ou Bring Your Own Model (BYOM) — um endpoint ou uma assinatura configurada. Para obter informações sobre configuração, consulte Configuração de LLMs.

Cada procedimento começa a partir da grade de tenants. Para abri-la, acesse Test Cloud Admin > AI Trust Layer > Hub de modelos e selecione um tenant no painel Tenants ou selecione Visualizar detalhes em um cartão de tenant. Na grade, localize a linha de produto e funcionalidade com a qual trabalhar e abra seu menu de contexto para acessar as ações disponíveis.

Produtos selecionáveis e não selecionáveis

Nem todos os produtos oferecem suporte à seleção direta de modelos, o que afeta a forma como você configura o roteamento e substitui modelos:

• Produtos selecionáveis, como Agentes e Atividades de GenAI, permitem que você selecione o modelo diretamente.
• Produtos não selecionáveis, como o Test Manager, não expõem a seleção direta de modelos. Para esses produtos, a grade permite visualizar os resultados e os roteamentos baseados em políticas, além das opções de configuração oferecidas pela UiPath para o produto.

Configurar o roteamento do modelo

Configure onde um produto e recurso roteiam o tráfego de LLM e, quando o produto oferecer suporte, qual modelo dá suporte ao mapeamento. Para usar sua própria assinatura, consulte Substituir um modelo.

1. Abra o menu de contexto da linha e selecione Configurar modelo.
2. Em Selecionar roteamento do modelo, selecione uma região disponível. A região em uso é identificada como Atual.
3. Em Selecionar modelo, selecione um dos modelos disponíveis nessa região, se o produto oferecer suporte à seleção de modelos.
4. Selecione Salvar configuração.

A região de roteamento do mapeamento e, quando alterado, o modelo reflete sua seleção.

Observação:

As regiões esmaecidas não têm uma opção de roteamento compatível para esse produto e funcionalidade, portanto, não existe modelo qualificado disponível nelas. Uma região desabilitada não significa que a UiPath não oferece suporte a essa região.

Substituir um modelo

A forma como você substitui o modelo que suporta um mapeamento depende de a substituição ser gerenciada pela UiPath ou de uma configuração personalizada do LLM. Para ver quais processos usam o modelo atual primeiro, consulte Revisão do impacto do modelo.

Mudar para outro modelo gerenciado pela UiPath

1. Abra o menu de contexto da linha e selecione Configurar modelo.
2. Em Selecionar modelo, selecione o modelo substituto. Quando um modelo está sendo descontinuado, a caixa de diálogo mostra a data de descontinuação e o modelo substituto designado.
3. Selecione Salvar configuração.

Mudar para uma configuração personalizada

Para usar uma configuração de LLM personalizada (BYOS ou BYOM):

1. Abra o menu de contexto da linha e selecione Adicionar modelo personalizado.
2. Defina a configuração de LLM personalizada. Para obter detalhes, consulte Configuração de LLMs.

Após aplicar uma substituição personalizada, seu modelo aparece na lista do Hub de modelos com Gerenciado por definido como Personalizado e pode ser reutilizado como uma opção de substituição em outros locais.

Observação:

Você é responsável pelo ciclo de vida de qualquer configuração de LLM personalizada, inclusive por migrar para um modelo substituto antes da descontinuação de um modelo. Consulte Configurações de LLM personalizadas. Para conferir as próximas datas de descontinuação, consulte o cronograma de descontinuação de modelos de LLM.

Atualizar um modelo personalizado em processo de descontinuação

Quando um modelo que você usa por meio de uma configuração personalizada estiver sendo descontinuado, por exemplo, GPT-4, migre antes da data de descontinuação:

1. Provisione um modelo substituto, por exemplo, GPT-5, em sua assinatura.
2. Atualize a configuração de LLM personalizada para usar o modelo substituto.
3. Valide e salve a configuração. Para obter detalhes, consulte Configuração de LLMs.

Marcar ou habilitar uma configuração personalizada

O hub de modelo mantém as configurações personalizadas desabilitadas visíveis na grade do tenant. Use as ações de linha para atualizar o status de uma configuração habilitada ou habilitar uma configuração desabilitada.

Verificar o status de uma configuração personalizada

1. Localize uma configuração personalizada habilitada na grade do tenant. Se várias configurações usarem o mesmo modelo, use a coluna Pasta para identificar a configuração.
2. Abra o menu de contexto da linha e selecione Verificar o status.

Resultado

O hub do modelo atualiza o status da configuração. Uma falha na verificação de conexão é exibida como Falha.

Habilitar uma configuração desabilitada

1. Localize uma configuração personalizada com status Desabilitado na grade do tenant.
2. Abra o menu de contexto da linha e selecione Habilitar configuração.
3. Após a configuração ser habilitada, abra o menu de contexto da linha e selecione Verificar o status.

Resultado

Depois de habilitar a configuração, o hub de Modelo mostra seu status atual na grade do tenant.

Reverter para a configuração padrão

O Hub de modelos distingue entre dois estados de configuração:

• A configuração inicial, identificada como Padrão, é o estado anterior à aplicação de qualquer configuração personalizada.
• A configuração atual, identificada como Editada, é a configuração ativa, com base na alteração mais recente.

A forma de reverter depende da configuração atual:

• Se o mapeamento usar um modelo gerenciado pela UiPath, use Configurar modelo para restaurar os valores padrão do modelo e da região de roteamento.
• Se o mapeamento usar uma configuração de LLM personalizada, remova a configuração para retornar ao padrão gerenciado pela UiPath. A mensagem de confirmação identifica a Pasta da configuração e os modelos que ela abrange, o que ajuda você a verificar o destino quando várias configurações usam o mesmo modelo.

Para comparar os valores atuais com os padrões, use o controle Colunas para adicionar colunas padrão opcionais à grade, como Modelo padrão.

Visualizar histórico de configuração

Ver histórico mostra o histórico de auditoria de um mapeamento para que você possa ver como ele mudou ao longo do tempo e se cada alteração foi feita por um usuário ou pelo sistema.

1. Abra o menu de contexto da linha e selecione Exibir Histórico.

Para o mapeamento selecionado, o histórico mostra quantas vezes o modelo foi alterado e, para cada alteração, os seguintes campos:

Campo	Exemplo
Carimbo de data/hora	05/06/2026 13:42 UTC
Ator	Sistema ou uma identidade do usuário
Change type	Região alterada / Modelo alterado / BYOM atribuído / BYOM removido
Antes e depois	GPT-4 (US) > GPT-5 (UE)
Motivo (opcional)	Substituição por descontinuação / Atualização manual

Uma ação do sistema indica uma atualização automatizada, como uma alteração do padrão gerenciado pela UiPath, enquanto uma ação do usuário indica uma configuração manual feita por um administrador.