Passar para o conteúdo principal

Como configurar habilidades (skills) de Agentes de IA

Ian Castelli avatar
Escrito por Ian Castelli
Atualizado há mais de uma semana

👤 Para admins do pipe

🔐 Disponível para todos os planos

🎯 Para quem quer aproveitar o poder da inteligência artificial para aprimorar seus processos com automações.

Atenção: se você quer saber mais sobre o que são Agentes de IA, clique aqui.

Visão Geral

O que são habilidades?

As habilidades (ou Skills) são componentes inteligentes que ampliam a capacidade dos Agentes de IA no Pipefy. Elas funcionam como fontes de conhecimento ou formas de interação com o Pipefy, ajudando os agentes a tomar decisões mais acertadas e executar tarefas com mais contexto.

Por que elas são importantes?

Ao utilizar uma ou mais habilidades, o Agente de IA se torna capaz de consultar dados externos ao card atual — como documentos anexos ou registros de outros pipes — para realizar tarefas com mais precisão.

Isso garante maior autonomia para os Agentes e reduz a necessidade de ações manuais por parte dos usuários.

🔍 Exemplo: Um Agente de IA que precisa responder a uma pergunta pode usar uma habilidade para consultar um documento PDF ou buscar registros em outro pipe antes de dar uma resposta.

Quais são as habilidades disponíveis?

📄 Habilidade: Acesso a Documentos

Permite ao Agente de IA consultar um documento específico para extrair informações relevantes que o ajudem a executar sua tarefa.

Parâmetros:

  • Nome: defina um nome claro e descritivo (exemplo: “Consultar Manual do Produto”).

  • Descrição: explique em que tipo de situação o Agente deve usar essa habilidade (exemplo: “Usar quando for necessário responder dúvidas técnicas sobre o produto”).

  • Anexo do Documento: Upload do arquivo PDF.

📌 Recomendação: Escolha documentos curtos ou bem estruturados. Quanto mais direto o conteúdo, melhor o desempenho do Agente.

📊 Habilidade: Acesso a Dados de Pipe

Permite ao Agente buscar informações em pipes e usar esses dados como referência para sua tarefa.

Parâmetros:

  • Nome: Um nome descritivo e claro (exemplo: “Buscar histórico de compras”).

  • Descrição: Quando o Agent deve acionar essa busca (exemplo: “Usar para recomendar produtos com base em compras anteriores”).

  • Pipe de Origem: Escolha o pipe onde os dados serão buscados, que pode ser tanto em outro pipe quanto no pipe do próprio Agente. Selecione qual pipe será consultado.

  • Filtros de Busca: Defina as condições para filtrar os cards relevantes. Exemplos:

    • Fase atual = “Concluído”

    • Campo “Cliente” = corresponde ao valor dinâmico das instruções

      • O valor será filtrado com base em um campo dinâmico que foi inserido dentro do prompt para cada card no qual a automação de IA rodar.

      • Atenção: se você adicionar mais de um filtro na configuração, a lógica será sempre "E".

  • Informações Retornadas: Escolha quais campos dos cards encontrados devem ser usados pelo Agent (ex: nome do produto, data da compra, valor).

📌 Recomendação: Seja específico nos filtros e nas informações retornadas para que o Agente tenha dados precisos e úteis.

⚠️ Limitações importantes

  • A skill de acesso a dados de pipes pode retornar no máximo 30 cards por execução.

  • Caso existam mais de 30 cards que atendam aos filtros definidos, serão considerados os 30 cards criados mais recentemente.

Como as habilidades se integram ao comportamento dos Agentes de IA

As habilidades são acionadas automaticamente pelo Agente de IA, com base nas instruções de tarefa que ele recebeu e nas condições descritas em cada habilidade. O Agente avalia quando precisa de informação adicional e escolhe qual habilidade usar, conforme o contexto da automação.

Isso significa que o admin não precisa programar quando as habilidades serão chamadas. Basta definir bem os parâmetros (nome, descrição, filtros, etc.), e o Agente toma a decisão com base nisso.

Boas práticas na criação de habilidades

  • Dê nomes e descrições claras: O Agente escolhe qual habilidade usar com base nisso.

  • Evite documentos longos ou genéricos. Divida em múltiplas habilidades se necessário.

  • Use filtros precisos nos dados do pipe: Isso evita retornos desnecessários e melhora a performance.

Atualize os documentos e pipes consultados regularmente para garantir informações atualizadas.

Casos de Uso

Exemplo 1: Atendimento automatizado com base em política da empresa

  • Tarefa: O Agent responde a dúvidas sobre política de reembolso.

    Habilidade usada: Acesso a Documento com o PDF da política.

Exemplo 2: Análise de histórico de clientes

  • Tarefa: O Agent recomenda uma ação com base em interações anteriores.

    Habilidade usada: Acesso a Dados de Pipe, buscando cards em um pipe de atendimento anterior.

Conteúdos Relacionados

🎓 Aprenda a fazer muito mais com os cursos gratuitos da Pipefy Academy!

🌎 Faça parte da Comunidade do Pipefy para tirar dúvidas, compartilhar sugestões, ficar por dentro das novidades e dividir seu conhecimento com pessoas do mundo todo!

Respondeu à sua pergunta?