Bring Your Own Models (BYOM) | Help Center Pipefy

🔐 Disponível para todos os planos.

👤 Para super admins, admins da empresa e admins do pipe.

🎯 Permite a integração de chaves de provedores de LLM personalizados para aprimorar os comportamentos dos Agentes de IA.

O que é e como usar o BYOM

⚠️ Este recurso está atualmente em modo de pesquisa, sob lançamento gradual. Pode não estar disponível para sua empresa ainda, mas estará em breve.

O BYOM (anteriormente BYOLLM) do Pipefy permite que todas as organizações conectem vários provedores de IA simultaneamente e atribuam modelos de LLM específicos para cada comportamento do Agente.

Isso garante:

Eficiência Financeira: Use modelos mais leves para tarefas simples e modelos robustos para raciocínios complexos para otimizar o consumo de créditos.
Soberania e Segurança: Direcione dados confidenciais exclusivamente para provedores aprovados pela sua TI.
Diferenciação Técnica: Conecte seus próprios modelos ajustados ou proprietários para lógicas de negócios específicas.

Nota: É importante destacar que essa configuração se aplica apenas a Automações de IA, Agentes de IA 2.0 e Assistente.

Antes de começar

Você deve ser um Admin da Organização (Super Admin ou Admin da Empresa) para gerenciar as chaves dos provedores e o Registro de Modelos no nível da Organização.
- Certifique-se de ter as credenciais do seu provedor de IA (chaves de API, JSON, etc.) prontas para os modelos que deseja homologar.
Você deve ser um construtor de processos (Admin do Pipe) para selecionar modelos específicos dentro do Construtor de Agentes.

Lista de opções de LLM suportadas

OpenAI:
- gpt-4o, gpt-4o-mini e versões de lançamento datadas (ex: gpt-4o-2024-08-06, gpt-4o-2024-11-20)
- gpt-4.1-2025-04-14
- gpt-5 e as versões de lançamento datadas mais recentes (ex: gpt-5-2025-08-07)
Azure OpenAI: Mesmos modelos da OpenAI
Google Vertex:
- gemini-1.5-pro e gemini-1.5-pro-002
- gemini-2.0-flash e gemini-2.0-flash-lite
OCI Generative AI
- xai.grok-4
- meta.llama-4-scout-17b-16e-instruct
- meta.llama-4-maverick-17b-128e-instruct-fp8
AWS Bedrock (verifique os requisitos abaixo)
Provedor Personalizado (verifique os requisitos abaixo)

📌 O processo de adição de um novo provedor pode variar, pois os campos e requisitos específicos dependem do provedor escolhido.

Requisitos para AWS/Provedores de URL Personalizada

Ao usar a opção “Personalizado” (ou seja, fornecendo seu próprio endpoint de inferência), certifique-se de que seu LLM e configuração atendam aos seguintes critérios:

Formato de Requisição e Resposta Compatível com OpenAI: Necessário para que os Agentes de IA do Pipefy possam processar corretamente a saída do LLM (ex: choices, message, content).
Suporte à Visão (Vision): Necessário se você planeja usar recursos de entrada de imagem e/ou documento em seus Agentes de IA.
Suporte à Chamada de Ferramentas (Tool Calling): Garante que os Agentes de IA possam executar fluxos de trabalho de várias etapas e usar as habilidades do agente de forma eficaz.

💡 Dicas para usar o BYOM:

Segurança: Mantenha as chaves de API seguras e evite compartilhá-las publicamente.
Limitações: Verifique as limitações e políticas de uso da API com a qual você está se integrando para evitar interrupções no serviço.

Passo a passo: configurando o BYOM (Super Admin e Admin da Empresa)

Clique na sua Foto de Perfil e selecione Painel do Admin (Admin Panel).
No menu lateral, clique em Configurações de IA (AI Settings).
Clique em Bring Your Own Model para adicionar uma nova configuração de provedor (ex: OpenAI, Azure OpenAI).
- Nota: Você pode registrar vários provedores compartilhando o mesmo modelo e fornecedor.
Clique em + Adicionar Novo (+ Add New).
Insira um Nome/Descrição para esse modelo (ex: "GPT-4 Aprovado pelo Jurídico").
Insira as credenciais do seu provedor e clique em Salvar.
Definir Modelo Padrão da Org.: Marque um modelo como o Modelo Padrão. Isso atua como o fallback (reserva) para todas as tarefas em que um modelo específico não for selecionado.
- Atenção: O Pipefy AI é o padrão inicial e não pode ser excluído, mas pode ser substituído como padrão pelo seu próprio modelo.

Passo a passo: atribuindo modelos aos comportamentos do Agente (Admins do Pipe)

Abra o Construtor de Agentes (AI Agents) dentro do Pipe desejado.
Selecione ou crie um Comportamento (Behavior) específico.
Localize o menu suspenso Modelo (Model) na parte inferior.
Escolha o modelo específico que você deseja para alimentar esse comportamento (ex: use um modelo leve para extração de dados e um modelo poderoso para tomada de decisões).
Se você deixá-lo como Padrão da Organização (Organization Default), o Agente usará o modelo marcado pelo seu Super Admin ou Admin da Empresa.

Limitações e Comportamentos

Modelos Homologados: Atualmente suporta famílias homologadas existentes (OpenAI, Azure OpenAI, Oracle OCI, Google Vertex) e modelos personalizados que atendam a requisitos específicos (compatíveis com OpenAI).
Padrão Obrigatório: Cada organização deve sempre ter exatamente um provedor padrão.
Desativação de Modelo: Um modelo definido como padrão não pode ser desativado ou excluído até que outro seja definido como o padrão.
Seleção de Modelo apenas para Comportamentos do Agente: A seleção de modelos se aplica exclusivamente aos Comportamentos do Agente. As Automações de IA e o Assistente executarão o Modelo Padrão da Org. configurado, e o Co-pilot sempre será executado no Pipefy AI por enquanto.
Processamento Inteligente de Documentos (IDP): Ao usar o IDP como uma ferramenta avançada dentro de um Agente, o sistema continuará a usar o Pipefy AI para processar documentos, mesmo que um modelo personalizado seja atribuído ao comportamento.
Ferramenta de Pesquisa na Web: A ferramenta avançada de Pesquisa na Web também é alimentada exclusivamente pelo Pipefy AI no momento, independentemente da configuração do modelo personalizado.

Regras de validação e fallback (reserva)

Antes de publicar seu Agente, verifique a lógica de roteamento:

Escolha do Comportamento: O sistema primeiro tenta usar o modelo específico atribuído ao comportamento.
Padrão da Org: Se nenhum for atribuído, ele recorre ao provedor padrão da Organização.
Pipefy AI: Se nenhum padrão personalizado for encontrado ou se a configuração falhar, ele usa o Pipefy AI como a rede de segurança final.

Sintoma	Causa	Solução
A escolha do modelo não aparece no Construtor de Agentes	O modelo está registrado, mas "Desativado" nas Configurações do Admin.	Vá para Modelos de IA e certifique-se de que a configuração específica esteja alternada para "Ativo".
Não é possível excluir a chave de um provedor	O provedor está definido atualmente como o "Padrão da Organização".	Atribua um modelo diferente como Padrão primeiro e, em seguida, exclua a chave antiga.
O Agente está usando o Pipefy AI em vez da minha chave	Fallback foi acionado devido a credenciais inválidas ou desativação do modelo.	Verifique o status da sua chave de API no Registro de Modelos e certifique-se de que o modelo esteja ativo.

🛠 Outras verificações úteis:

Erro de Autenticação: Verifique se a chave de API está correta e ativa.
Integração Inativa: Certifique-se de que o serviço de terceiros esteja operacional.
Limites da API Excedidos: Verifique sua cota, limites de taxa e status de faturamento diretamente no painel do seu provedor de IA.
A escolha do modelo não aparece no Construtor de Agentes: O modelo pode estar registrado, mas "Desativado". Vá para Modelos de IA e certifique-se de que a configuração específica esteja alternada para "Ativo".
Não é possível excluir uma chave de provedor: Se o provedor estiver definido atualmente como o "Padrão da Organização", atribua um modelo diferente como Padrão primeiro e, em seguida, exclua a chave antiga.
O Agente está usando o Pipefy AI em vez da chave personalizada: Um fallback foi acionado devido a credenciais inválidas ou desativação do modelo. Verifique o status da sua chave de API no Registro de Modelos e certifique-se de que o modelo esteja ativo.

Se você tiver dúvidas adicionais, entre em contato com o suporte do Pipefy ou consulte a documentação oficial da API que você está usando.

Para mais detalhes sobre preços e limites do plano, visite a página de preços do Pipefy.