👤 Para admins do pipe
🔐 Disponível para todos os planos
🎯 Para quem deseja aproveitar o poder da inteligência artificial para aprimorar seus processos com uma força de trabalho digital.
Usando linguagem natural, você pode instruir estes digital workers a analisar informações, tomar decisões e executar ações complexas dentro de um ou mais pipes.
O que isso resolve:
Automatiza tarefas complexas que exigem análise e tomada de decisão
Cria agentes especializados usando suas próprias bases de conhecimento
Orquestra ações entre diferentes pipes de forma inteligente e condicional.
Passo a passo: Como criar um Agente de IA
A criação de um novo agente de IA é dividida em três etapas principais: Criar, Conhecimento e Comportamentos.
Acesse o pipe onde você deseja criar o agente. No cabeçalho do pipe, clique no botão Agentes de IA.
2. Se você já tiver um agente criado, esta tela irá listá-los. Neste exemplo, temos quatro agentes já criados:
Para criar um novo agente, clique no botão "Novo Agente de IA" no lado superior direito da tela.
3. Na primeira seção, insira um Nome para o seu agente e uma Descrição para ajudar a identificar sua função principal.
Para este exemplo, vamos criar um agente de IA para atuar dentro de um pipe de Recrutamento e Seleção.
ℹ️ Dica: O campo Descrição é obrigatório, pois esta informação é usada pela IA para melhorar seu desempenho e resultados.
4. Na seção Conhecimento, adicione o contexto que seu agente precisa para operar. Esta será sua fonte de verdade. Você pode usar dois tipos de fontes de informação:
Pipe ou database: Permita que seu agente utilize dados de cards de pipes ou registros de databases como contexto. Isso garante que o agente forneça respostas com maior precisão baseando-se em suas informações estruturadas.
Documentos: Anexe arquivos. Isto é ideal para fornecer conhecimento estático, como políticas internas, descrições de vagas, manuais de produtos ou artigos técnicos.
Neste exemplo, o agente tem como Conhecimento um documento em PDF com a descrição vaga e acesso ao pipe de Entrevistas.
ℹ️ Dica: Embora adicionar conhecimento não seja obrigatório, é altamente recomendado. Fornecer documentos ou dados do pipe dá ao seu agente o contexto necessário para atuar com maior precisão.
5. Na seção Comportamentos, defina o gatilho e a ação do agente.
5.1. Defina o evento que irá acionar o agente. Por exemplo, Quando um card entrar em uma fase.
5.2. Escreva a instrução (prompt) que o agente deve seguir em linguagem natural.
Você pode usar / ou clicar no botão + para adicionar informações dinâmicas de Campos ou Ações do seu processo.
Ações Principais: Na caixa de instruções, digite / para selecionar quais ações o agente deve executar:
Atualizar campos do card: Preencha informações automaticamente no card atual.
Criar um card: Gere um novo card em um pipe específico.
Criar um registro: Crie novas entradas diretamente em bancos de dados (databases) do Pipefy para centralizar informações.
Criar um card conectado: Gere um card vinculado ao processo atual.
Mover card: Transfira o card para uma fase diferente do fluxo de trabalho.
ℹ️ Lendo anexos nos prompts: ao usar um campo de anexo em seu prompt (ex: /Anexo do Cliente), o agente pode ler e interpretar o conteúdo de vários tipos de arquivos para extrair informações.
Formatos suportados:
Documentos e Imagens: PDF (limite de 30 páginas por arquivo), PNG e JPG (limite de 30 imagens no total).
Tipos de arquivos: JSON, XML, EML, CSV e TXT.
Limites e Recomendações:
A extração de dados (de arquivos JSON, CSV, etc.) funciona melhor para extrações simples. Análises complexas podem não funcionar como esperado.
Limites de arquivos de dados: JSON (400kb); XML, EML, CSV, TXT (200kb).
ℹ️ Dica: Você pode criar instruções condicionais e até mesmo pedir ao agente para executar ações em outros pipes.
Limites e comportamentos:
Para garantir que seu agente opere com alta velocidade e precisão, observe os seguintes limites de estrutura:
Comportamentos: Você pode criar até 5 comportamentos diferentes dentro de um único AI Agent.
Ações por comportamento: Cada comportamento pode executar até 3 ações principais (ex: criar um registro, mover um card e atualizar um campo simultaneamente).
Tamanho das instruções: Cada caixa de instrução suporta até 10.000 caracteres.
💡 Dica: Se o seu processo exigir mais de 3 ações para um gatilho específico, considere dividir a lógica em um segundo comportamento ou em uma automação complementar.
Exemplo de prompt: “Analise as informações do candidato em /Currículo. Se o perfil for compatível usando a descrição da vaga em sua base de conhecimento, Crie um card no pipe 'entrevistas' com o nome e email do candidato, e Mova o card para a fase Em Entrevista.”
⚠️ Atenção: Limites da ação de "Criar Card": ao instruir o agente a "criar um card", o agente pode preencher um limite de 80 campos no novo card.
6. Após configurar todas as seções, clique em Salvar na parte inferior direita da tela para ativá-lo e clique em "Voltar para agentes" para retornar à tela principal com a lista de agentes em seu pipe.
Como monitorar a atividade do seu agente
Existem duas maneiras de acompanhar o que seu digital worker está fazendo:
Atividades do card: Para uma visão rápida do resultado da ação, abra o card onde o gatilho ocorreu e clique na aba Atividades. Lá você verá se o agente executou a tarefa, como a atualização de um campo ou a movimentação de um card.
Logs de automação: Para uma visão técnica e detalhada, especialmente para investigar falhas, acesse os logs. No cabeçalho do seu pipe, clique em Automações e, em seguida, selecione a aba Logs. Aqui você pode ver o status de execução de todas as automações, incluindo os agentes.
Solução de Problemas
O agente não executou a ação esperada:
Sintoma: O evento de gatilho ocorreu (ex: o card entrou na fase), mas nada aconteceu.
Monitorando a Atividade: Para acompanhar o desempenho do seu agente e solucionar comportamentos, utilize os Logs dos Agentes de IA. Eles oferecem uma visão detalhada de cada execução, incluindo gatilhos e ações realizadas.
O agente executou uma ação incorreta:
Sintoma: O agente criou um card com informações erradas ou atualizou o campo errado.
Solução: Refine seu prompt. Seja mais específico em suas instruções. Por exemplo, em vez de "atualize o card", diga "preencha o campo @Status do Candidato com o valor 'Aprovado'". Verifique as Atividades do Card para ver exatamente o que o digital worker fez.