🔐 Disponível para todos os planos,exceto plano Starter. 👤 For super admins and company admins 🎯 Permite integrar chaves de API próprias para personalizar o Pipefy AI |
Como Utilizar a Funcionalidade Pipefy AI - LLM provider (AI)
A funcionalidade "Pipefy AI - Bring your own Keys" permite que os usuários integrem suas próprias chaves de API para personalizar e potencializar as capacidades dos Agentes de AI no Pipefy. Neste artigo, vamos guiá-lo pelo processo de configuração e utilização dessa funcionalidade.
O que é a Funcionalidade "LLM provider (AI)"?
Esta funcionalidade oferece a flexibilidade de usar suas próprias chaves de API com o Pipefy AI. Com isso, você pode integrar serviços de inteligência artificial de sua escolha, melhorando a personalização e eficiência dos fluxos de trabalho no Pipefy.
Atenção: Essa configuração se aplica exclusivamente aos AI Agents, garantindo maior personalização e eficiência nos fluxos de trabalho compatíveis.
Passo a Passo para Configurar suas Próprias Chaves
Passo 1: Acesse as Configurações do Pipefy
Faça login na sua conta Pipefy.
No canto superior direito, clique no ícone de perfil para acessar a opção “Painel da Administração”:
Passo 2: Selecione "Provedor de LLM (IA)".
Passo 3: Inserir Chaves de API
📌O processo de adição de um novo provedor pode variar, pois os campos e requisitos específicos dependem do provedor escolhido.
📢Para integrar um modelo de linguagem (LLM) ao Pipefy, você precisará de uma chave de API fornecida pelo provedor de LLM. Procure por uma aba chamada "Configurações", "Credenciais", "API Keys" ou algo semelhante no provedor selecionado.
Nesse momento o Provedor LLM foi adicionado no Pipefy:
Caso seja necessário restaurar ao modelo padrão Pipefy, pode realizar o processo cliacando no icone de "reload" dentro do card do modelo ativo ou ir no card do Pipefy > Definir como provedor:
Lista de LLMs Suportados
OpenAI:
gpt-4o, gpt-4o-mini e versões com data de lançamento (ex.: gpt-4o-2024-08-06, gpt-4o-2024-11-20)
gpt-4.1-2025-04-14
gpt-5 e versões com data de lançamento (ex.: gpt-5-2025-08-07)
Azure OpenAI:
Mesmos modelos do OpenAI
Google Vertex (somente via API — entre em contato com o suporte):
gemini-1.5-pro, gemini-1.5-pro-002
gemini-2.0-flash, gemini-2.0-flash-lite
AWS Bedrock:
Ver requisitos abaixo
Custom Provider:
Ver requisitos abaixo
Limitações e Requisitos para Uso do BYOLLM
Se você planeja usar um provedor LLM personalizado com a funcionalidade BYOLLM do Pipefy, revise os seguintes requisitos técnicos e limitações:
Requisitos para provedores com URL personalizada
Ao usar a opção Custom (endpoint próprio), seu LLM e configuração devem atender aos seguintes critérios:
Formato de resposta compatível com OpenAI: Necessário para que os AI Agents processem corretamente a saída do LLM (ex.:
choices,message,content).Suporte a Vision: Necessário se você pretende usar entrada de imagens e/ou documentos nos AI Agents.
Suporte a Tool Calling: Necessário para que os AI Agents executem fluxos de múltiplas etapas e utilizem skills.
Autenticação OAuth 2.0: Ainda não suportada — recurso em desenvolvimento.
Comportamento na Plataforma
Quando qualquer provedor BYOLLM é selecionado (OpenAI, Azure OpenAI ou Custom), todas as execuções dos AI Agents serão feitas usando o LLM configurado, exceto em um caso específico:
Exceção para Embedding de Documentos: Para skills do tipo Acesso a Documentos, a etapa que converte o texto do documento em vetores pesquisáveis (embedding) continuará usando o provedor interno do Pipefy. Isso garante que a precisão de recuperação dessas skills se mantenha, mesmo com um LLM personalizado.
Estamos trabalhando para que o BYOLLM também seja suportado nesse passo em uma atualização futura.
📢Dicas para Utilizar a Funcionalidade:
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 que você está integrando para evitar interrupções no serviço.
Esta funcionalidade é uma maneira poderosa de personalizar sua experiência com o Pipefy AI, permitindo que suas operações sejam mais ágeis e adaptadas às suas necessidades específicas.
🛠Resolução de Problemas Comuns:
Erro de Autenticação: Verifique se a chave da API está correta e ativa.
Integração Inativa: Certifique-se de que o serviço de terceiros está operacional.
Caso tenha dúvidas adicionais, entre em contato com o suporte do Pipefy ou consulte a documentação oficial da API que está utilizando.