Passar para o conteúdo principal

Como configurar habilidades (skills) de Agentes de IA

Ian Castelli avatar
Escrito por Ian Castelli
Atualizado essa 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.

Se primeiro 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 habilidade, 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 (ex: “Buscar histórico de compras”).

  • Descrição: Quando o Agent deve acionar essa busca (ex: “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

      • Nesse caso, 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.

  • 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.

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. Habilidades 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?