👤 Para admins do pipe
🔐 Disponível para todos os planos
🎯 Para quem quer deseja aproveitar o poder da inteligência artificial para aprimorar seus processos com uma força de trabalho digital.
Criar um agente de IA poderoso depende da qualidade das suas instruções. Instruções claras, lógicas e contextualizadas ajudam o agente a executar tarefas de forma confiável e previsível.
Use este guia para aprender as melhores práticas ao escrever instruções eficazes para suas automações. Este guia te ajuda a:
Criar agentes de IA confiáveis e previsíveis
Reduzir erros e comportamentos inesperados da IA
Construir agentes mais poderosos para lidar com tarefas complexas.
Melhores práticas para escrever instruções (prompts)
Tudo o que você configura é uma forma de instrução para a IA. Para obter os melhores resultados, siga estes princípios fundamentais.
1. Seja claro e direto
Use uma linguagem simples e objetiva. Comece suas instruções com um verbo de ação claro para dizer ao agente exatamente o que fazer.
Em vez de: "Eu quero saber quem é o cliente"
Tente isto: "Extraia o nome completo do cliente do corpo do email"
Em vez de: "Verifique se o negócio é importante"
Tente isto: "Se o campo 'Valor do Negócio' for maior que R$10.000, atualize o campo 'Prioridade' para Alta"
ℹ️ Nota: Neste exemplo, "Atualize" é um comando de ação usando / ou clicando no botão + para adicionar informações dinâmicas de Campos ou Ações do seu processo.
2. Forneça contexto
Um agente de IA não sabe nada sobre um card a menos que você forneça as informações. Use múltiplas fontes de contexto para guiar a IA:
Adicione Conhecimento: use informações contextuais, como documentos ou acesso a dados de tubulação.
Campos dinâmicos: Insira dados em tempo real do seu card (como campos de formulário, propriedades do card, resultados de ações anteriores, etc.) diretamente em suas instruções.
Para fazer isso, use o seletor de campos dinâmicos para adicionar o campo desejado, em vez de digitá-lo manualmente.
Exemplo: A instrução Resuma o seguinte email: Último email é o resultado de você escrever "Resuma o seguinte email:" e depois selecionar o campo dinâmico Último email da fase Start Form, na interface.
3. Forneça exemplos
Sempre que possível, inclua um breve exemplo do resultado esperado diretamente nas suas instruções. Isso ajuda a IA a entender o formato e o tipo de resposta que você precisa.
Exemplo: "Extraia o ID do ticket do assunto do email. O ID é sempre um número de 7 dígitos. Por exemplo:
9876543"
4. Seja específico sobre o resultado
Evite instruções vagas. Quanto mais específico você for, mais preciso será o resultado. Isso inclui os nomes dos seus campos de resultado.
Vago: "Atualize o card com as informações"
Específico: "Atualize o campo 'Nome do Contato' com o nome completo do cliente encontrado no campo 'Corpo do Email'"
ℹ️ Dica: Garanta que os nomes dos campos que você seleciona para os resultados sejam claros e descritivos (ex: use "Nome Completo do Cliente" em vez de "Campo de Texto 1"). Os próprios nomes dos campos são instruções para a IA.
5. Teste e refine
Sua primeira instrução pode não ser perfeita. Realize testes em alguns cards com cenários diferentes para ver como o agente se comporta. Se o resultado não for o esperado, ajuste a formulação, adicione mais contexto ou simplifique o comando até que funcione de forma confiável.
Como a IA executa as instruções
O Agente de IA executa as ações sequencialmente, na ordem exata em que você as escreve. A leitura é feita de cima para baixo.
Imagine que você tem estas duas instruções:
Se o campo 'Estado' for 'São Paulo',atualizeo campo 'Região de Vendas' para 'Sudeste'.Mova
o card para a fase 'Revisão Regional'.
O agente sempre verificará a condição na primeira instrução antes de tentar executar a segunda.
✅ Se a condição for atendida (o estado é São Paulo), o agente primeiro atualizará o campo 'Região de Vendas' e depois moverá o card.
❌ Se a condição não for atendida, o agente pulará a ação da primeira instrução e passará diretamente para a segunda, movendo o card.
❗ Limites
Limite de texto da instrução: Você pode escrever até 10.000 caracteres de texto fixo para suas instruções.
Limite de campos dinâmicos: Você pode adicionar até 30 campos dinâmicos para fornecer contexto ao agente.
Formatos de arquivo suportados: Ao usar agentes de IA para extração ou interpretação de dados de imagens ou documentos, os formatos suportados são PDF, PNG e JPG.
🛠️ Solução de problemas
Sintoma: O agente de IA não está executando a ação correta ou se comporta de forma imprevisível.
Causa provável: As instruções podem ser ambíguas ou sem contexto.
Como corrigir:
Verifique a clareza: Existe uma maneira mais simples e direta de formular o comando? Leia suas instruções em voz alta para ver se elas fazem sentido lógico.
Verifique o contexto: Garanta que seus campos dinâmicos, nomes de campos de resultado e descrições de campos estejam claros e forneçam a informação correta.
Revise a ordem: Confirme se a sequência de suas ações é lógica. Lembre-se, o agente as executa uma após a outra.