Traga sua própria assinatura (BYOS)

Configure o IXP para rotear solicitações de extração por meio de suas próprias assinaturas do Google Vertex AI ou Microsoft Azure OpenAI.

Visão geral

Observação:

Essa funcionalidade está disponível em pré-visualização.

O BYOS permite que você execute a Extração e Processamento Inteligente (IXP) em suas próprias assinaturas de modelo de linguagem grande (LLM) em vez dos modelos hospedados pela UiPath®.

Como o tráfego roteia por meio da sua própria assinatura do LLM de terceiros selecionado, seus dados permanecem dentro do seu limite de conformidade. Isso oferece suporte à residência de dados e requisitos de conformidade que uma assinatura hospedada pela UiPath não pode atender por conta própria. Os projetos que são executados inteiramente em suas próprias assinaturas também são elegíveis para taxas de consumo com desconto. Para obter mais detalhes, consulte Desconto do BYOS.

As solicitações ainda passam pelo gateway de LLM da AI Trust Layer, portanto, a aplicação de políticas e o registro de auditoria continuam a aplicar-se a cada chamada. Para saber como o gateway roteia solicitações e para saber a diferença entre BYOS e Traga seu próprio modelo (BYOM), consulte Configuração de LLMs.

Modelos suportados

O BYOS abrange todos os modelos que o IXP oferece. Você precisa trazer uma assinatura para pelo menos um deles, não para todos eles. Cada modelo que você traz precisa de sua própria entrada em sua configuração do AI Trust Layer LLM.

Família de modelos	Versão do modelo no IXP	Provedor	Conector
Gemini	2.5 Flash	Google Vertex AI	Google Vertex
Gemini	2.5 Pro (pré-visualização)	Google Vertex AI	Google Vertex
Gemini	3.1 Visualização do Pro (pré-visualização)	Google Vertex AI	Google Vertex
Gemini	3.5 Flash Lite (pré-visualização)	Google Vertex AI	Google Vertex
GPT	GPT-4o	Microsoft Azure OpenAI	Microsoft Azure OpenAI
GPT	gpt-5.1-2025-11-13 (pré-visualização)	Microsoft Azure OpenAI	Microsoft Azure OpenAI
GPT	gpt-5.4-2026-03-05 (pré-visualização)	Microsoft Azure OpenAI	Microsoft Azure OpenAI

Os modelos de visualização estão no escopo para BYOS nos mesmos termos que os disponíveis de forma geral. Se você trouxer uma assinatura para um modelo de visualização, os recursos que a utilizam são executados em sua própria assinatura e contam para a elegibilidade a descontos.

Cobertura do modelo e alternativas

Você pode configurar vários modelos BYOS ao mesmo tempo. O IXP resolve cada recurso baseado em LLM em relação aos modelos que você configurou. Os recursos baseados em LLM são pré-processamento, extração e atribuição baseada em modelos.

Se um recurso precisar de um modelo que suas assinaturas não cobrem, o IXP oferece as seguintes alternativas:

• Um modelo hospedado pela UiPath, se sua política de governança de IA o permitir.
• Uma alternativa não LLM, como modelo de tabela - mini para pré-processamento ou baseado em regras para atribuição.

Quanto mais modelos você trouxer, mais recursos de Extração e Processamento Inteligente (IXP) são executados em sua própria assinatura. Alguns recursos de pré-processamento e pós-processamento são baseados no Gemini e só têm alternativas não LLM se você não trouxer uma assinatura do Gemini.

Desconto no BYOS

Os projetos configurados com o BYOS são elegíveis para um desconto de 30% nas taxas de consumo típicas do IXP.

O desconto se aplica no nível do projeto, e somente se o projeto não usar nenhuma assinatura de LLM hospedada pela UiPath. Um projeto se qualifica apenas quando nenhuma das seguintes opções é executada em um modelo hospedado pela UiPath:

• Pré-processamento baseado em LLM, como Modelo de tabela.
• O modelo de extração.
• Atribuição baseada em modelo .

Se qualquer um desses recursos for executado em uma assinatura de LLM hospedada na UiPath, todo o projeto será faturado de acordo com as taxas de consumo padrão. Não há desconto parcial ou rateado.

Ao planejar sua configuração, considere o seguinte:

• Selecionar uma alternativa não LLM, como Modelo de tabela - mini ou Atribuição baseada em regras , não desqualifica um projeto. Essas alternativas não consomem uma assinatura do UiPath LLM.
• Reverter um modelo hospedado pela UiPath para qualquer uma das três opções mencionadas anteriormente desqualifica o projeto.
• Para garantir a elegibilidade, desabilite as alternâncias do modelo primário em sua política de governança de IA, conforme descrito em Criar uma política de governança de IA. Apenas sua assinatura BYOS é usada, portanto, um projeto não pode retornar a um modelo hospedado pela UiPath.
• A elegibilidade é avaliada por projeto, portanto, o mesmo tenant pode conter projetos com desconto e de taxa padrão.

Pré-requisitos

Antes de configurar o BYOS para o IXP, certifique-se de ter:

• Acesse a AI Trust Layer em seu tenant da UiPath.
• Acesso ao UiPath Integration Service.
• Uma assinatura válida do Google Vertex AI, Microsoft Azure OpenAI ou ambos.
• Credenciais para criar um conector no Integration Service.

1. Crie uma conexão no Integration Service

Crie uma conexão com cada provedor de LLM que pretende usar antes de configurá-lo no AI Trust Layer.

1. Navegue até o Integration Service em seu tenant UiPath.
2. Acesse Meu Espaço de trabalho ou Compartilhado, dependendo de onde você deseja que a conexão esteja disponível.
3. Selecione a guia Conectores e, em seguida, procure seu provedor:
   • Para modelos Gemini, pesquise por vertex e selecione Google Vertex.
   • Para modelos GPT, pesquise por azure open e selecione Microsoft Azure OpenAI.
4. Selecione o conector para abrir o formulário de conexão.
5. Preencha os campos exigidos pelo seu provedor.
6. Select Connect.
7. Se você estiver trazendo modelos de ambas as famílias, repita as etapas 2 a 6 para o outro provedor.

Lembre-se de em qual pasta você salvou a conexão. Você o seleciona no campo Pasta de conexões ao adicionar a configuração do LLM.

2. Configure seus modelos no AI Trust Layer

Configure seus LLMs no AI Trust Layer da seguinte forma:

1. Navegue até AI Trust Layer e, em seguida, Configurações de LLM.

2. Selecione Adicionar configuração.

3. Preencha os seguintes campos:

   • Tenant - O tenant que você deseja configurar.
   • Produto - Extração e Processamento Inteligente (IXP)
   • Funcionalidade : documentos não estruturados e complexos
   • Pasta de conexões - A pasta na qual você salvou sua conexão do Integration Service, por exemplo, Compartilhada.

4. Em Configuração do modelo, adicione uma entrada para cada modelo que você está trazendo. Adicione pelo menos uma entrada e todas as quais você tiver assinaturas. Os modelos que compartilham um provedor, como vários modelos do Gemini, podem reutilizar a mesma conexão do Integration Service.

   • Para modelos do Gemini , preencha os seguintes campos:

     • Nome do LLM — O identificador do modelo.
     • Tipo de API – Gerar conteúdo do Gemini
     • Conector - Google Vertex
     • Conexão - A conexão do Google Vertex que você criou.
     • Identificador do LLM - Insira o identificador do modelo manualmente.

   • Para modelos GPT , preencha os seguintes campos:

     • Nome do LLM — O identificador do modelo.
     • Tipo de API – Conclusão do OpenAI Chat
     • Conector - Microsoft Azure OpenAI
     • Conexão - A conexão do Microsoft Azure OpenAI que você criou.
     • Identificador do LLM - Insira o identificador do modelo manualmente.
   Observação:

   Há um problema conhecido em que o preenchimento automático do menu suspenso de identificadores de LLM pode não funcionar corretamente nesta visualização. Certifique-se de inserir o identificador diretamente em vez de confiar nas sugestões.

5. Selecione Testar configuração para validar que a AI Trust Layer pode alcançar cada provedor de LLM configurado com as credenciais e identificadores que você forneceu.

6. Na confirmação Configuração validada , selecione Concluído.

7. Selecione Salvar.

Identificadores de modelo

Insira os seguintes identificadores para os modelos que você configura:

Versão do modelo no IXP	Identificador
2.5 Flash	gemini-2.5-flash
2.5 Pro (pré-visualização)	gemini-2.5-pro
3.1 Visualização do Pro (pré-visualização)	gemini-3.1-pro-preview
3.5 Flash Lite (pré-visualização)	gemini-3.5-flash-lite
GPT-4o	gpt-4o-2024-08-06
gpt-5.1-2025-11-13 (pré-visualização)	gpt-5.1-2025-11-13
gpt-5.4-2026-03-05 (pré-visualização)	gpt-5.4-2026-03-05

Cada modelo que você adiciona também deve ser implantado e disponível em sua assinatura do provedor. Por exemplo, uma entrada para gpt-5.4-2026-03-05 é validada apenas se seu recurso do Azure OpenAI tiver essa implantação.

Solução de problemas de configuração de teste

Se o teste da configuração falhar, verifique o seguinte:

• Suas credenciais no Integration Service estão corretas, e a conexão está ativa.
• A pasta correta é selecionada no campo Pasta de conexões .
• O identificador do LLM corresponde exatamente ao valor de seu modelo.
• Cada entrada de modelo que você adicionou tem sua própria conexão válida. A validação falha se qualquer modelo único na configuração falhar.
• Cada modelo que você adicionou é implantado em sua assinatura do provedor.

3. Crie uma política de governança de IA

Depois de salvar sua configuração do LLM, você precisa configurar uma política de governança de IA para controlar quais modelos são permitidos em seu tenant. Crie a política da seguinte forma:

1. Na página de destino da AI Trust Layer , selecione a guia Governança da IA .
2. Selecione Adicionar política.
3. Insira um nome de política, por IXP_BYOS_Policy exemplo, e opcionalmente uma descrição.
4. Selecione a aba Modelos .
5. Defina as alternâncias Anthropic, Open AI e Gemini . Essa configuração determina se seus projetos podem retornar a modelos hospedados pela UiPath e, portanto, se eles se qualificam para descontos BYOS:
   • Habilitado: as versões hospedadas pela UiPath desses modelos permanecem disponíveis junto com sua configuração BYOS. Isso dá a você uma cobertura de recursos mais ampla, mas qualquer projeto que acabe usando um modelo hospedado pela UiPath para pré-processamento, extração ou atribuição baseada em modelo perde o desconto.
   • Desabilitado: apenas sua assinatura BYOS é usada. Os recursos que seus modelos não cobrem retornarão às alternativas não LLM deles, e seus projetos permanecerão elegíveis para o desconto.
6. Selecione Enviar para aplicar as configurações do modelo.
7. Selecione Salvar para salvar a política.

Para obter mais detalhes, consulte Configurações para políticas da AI Trust Layer.

4. Atribua a política a seu tenant

Depois de salvar a política, implante-a no tenant onde o IXP é executado:

1. Na guia Governança de IA , selecione Gerenciar implantações.
2. Na guia Tenants , localize o tenant ao qual você deseja aplicar a política e, em seguida, selecione o ícone de edição ao lado dele.
3. Expanda a seção Sem licença .
4. Na linha da AI Trust Layer , selecione a política que você criou no menu suspenso Política do produto .
5. Selecione Salvar.

5. Verifique sua assinatura

Depois que sua configuração e política forem salvas, verifique se sua assinatura está ativa:

1. No IXP, crie um projeto ou abra um existente.
2. Selecione Configuração do modelo.
3. Em Família de modelo e Versão do modelo, selecione seu modelo e versão. O que você pode selecionar depende dos modelos que você configurou. Para obter detalhes, consulte as seguintes seções.
4. Defina as configurações preferidas em Pré-processamento inteligente, Atribuição e Opções avançadas.
5. Selecione Salvar.

As famílias de modelos que você não configurou são exibidas como indisponíveis, a menos que os modelos próprios estejam habilitados em sua política de governança. Qualquer recurso que dependa de uma família indisponível oferece sua alternativa.

Observação:

O menu suspenso Versão do modelo lista todas as versões compatíveis com o IXP, não apenas as versões para as quais você trouxe uma assinatura. Se você selecionar uma versão que sua assinatura não cobre, esse recurso retornará ao modelo hospedado pela UiPath, se sua política de governança permitir, e o projeto não se qualificar para o desconto BYOS.

Para obter o conjunto completo de configurações do modelo, consulte Configuração do modelo.

Se você configurou apenas modelos do Gemini

• A família do modelo GPT não está disponível.
• Na família Gemini , você pode selecionar as versões 2.5 Flash, 2.5 Pro, 3.1 Pro Preview e 3.5 Flash Lite. As versões para as quais você trouxe uma assinatura são executadas no BYOS.
• As opções de pré-processamento e atribuição baseadas no Gemini permanecem disponíveis.

Se você configurou apenas modelos GPT

• A família de modelos do Gemini não está disponível.
• Na família GPT , você pode selecionar as versões gpt-4o, gpt-5.1-2025-11-13, e gpt-5.4-2026-03-05.
• Os avisos indicam que certas opções de pré-processamento e pós-processamento estão indisponíveis. Essas opções dependem do Gemini e não podem ser usadas sem uma assinatura do Gemini. Eles são acinzentados e você pode usar as seguintes alternativas:

Configuração afetada	Onde aparece	Alternativa
Modelo de tabela	Pré-processamento inteligente	Modelo de tabela - Mini
Atribuição baseada em modelo	Atribuição	Baseado em regras

A seleção dessas alternativas mantém o projeto totalmente na sua própria assinatura, portanto, o projeto permanece elegível ao desconto do BYOS.

Se você configurou modelos de ambas as família

• Você pode selecionar tanto a família de modelos Gemini quanto a GPT .
• As opções de pré-processamento e atribuição baseadas no Gemini estão disponíveis e são executadas em sua própria assinatura.
• Se você trouxe todos os modelos de que o projeto precisa, nenhum recurso retornará a um modelo hospedado pela UiPath, e o projeto se qualifica para desconto BYOS em qualquer combinação de configurações.

Confirmação da elegibilidade ao desconto

Antes de salvar a configuração do modelo, verifique as seguintes configurações:

Recursos	Qualifica-se para o desconto quando definido como
Pré-processamento baseado em LLM (Modelo de tabela)	Uma versão do modelo para a qual você trouxe uma assinatura ou modelo de tabela - mini
Modelo de extração	Uma versão do modelo para a qual você trouxe uma assinatura
Atribuição	Com base em uma versão do modelo para a qual você trouxe uma assinatura ou com base em regras

Observação:

Se qualquer um desses recursos for definido como um modelo hospedado pela UiPath, o projeto será cobrado de acordo com as taxas padrão.

A elegibilidade é verificada por versão do modelo, não por família de modelos. Por exemplo, trazer o Gemini 2.5 Flash não cobre um projeto que está configurado para extrair com o Gemini 3.1 Pro Preview.

6. Teste a configuração

Depois de salvar a configuração do modelo, você pode validar o pipeline de extração completo usando BYOS da seguinte forma:

1. Crie sua taxonomia para definir os campos que deseja extrair.
2. Carregue documentos para seu projeto.
3. Execute a extração.

Se você receber previsões, o IXP está roteando solicitações por meio de sua assinatura de LLM configurada.