👤 Para admins de pipes e pessoas responsáveis por processos
🔐 Agentes de IA disponíveis em todos os planos, conforme habilitação e créditos da organização
🎯 Para quem quer escolher uma tarefa para a IA e acompanhar sua execução
Uma solicitação sobre férias chega no mesmo canal que um pedido de compra. Antes de atender, alguém precisa ler o texto, identificar a área responsável e organizar o contexto. Quando essa análise se repete ao longo do dia, parte do tempo da equipe fica concentrada na preparação do atendimento.
Ao terminar a leitura, você vai saber como delimitar uma tarefa para um Agente de IA, fornecer as referências necessárias e conferir o resultado antes de ampliar o uso.
📖 O que você vai entender aqui:
Quando combinar agentes e automações
O primeiro critério é o tipo de trabalho. Enviar uma confirmação sempre que uma solicitação chega segue uma regra fixa. Entender se um texto trata de férias ou aquisição de equipamentos exige interpretação.
Na sessão, essa distinção orientou a divisão de responsabilidades: o agente interpreta a solicitação e registra a classificação; uma automação pode comunicar o encaminhamento conforme uma regra definida pela empresa. A orquestração reúne as duas partes em um fluxo com finalidade clara.
Imagine a mensagem: “Gostaria de saber quantos dias de férias tenho disponíveis. Ainda não defini quando vou viajar”. A análise identifica o assunto para encaminhar a demanda ao RH. Ela não informa o saldo de férias sem consultar uma fonte apropriada.
Escolha uma tarefa cujo resultado você consiga conferir. “Classificar a solicitação e justificar a categoria” oferece um critério mais concreto de avaliação do que “cuidar de todo o atendimento”.
Para rever essa escolha, consulte o papel dos AI Agents no processo. O curso Panorama da IA, na Academy ajuda a comparar regras, IA e revisão humana em cenários práticos.
O que preparar antes de delegar uma análise
O agente atua no contexto de um processo. Antes de escrever a orientação, defina quais informações estarão disponíveis, qual análise será feita e onde a equipe encontrará o resultado.
No exemplo do treinamento, o título, a descrição detalhada e o anexo eram as entradas da triagem. Categoria, Urgência, Resumo e Justificativa eram os campos destinados à saída. Esses nomes pertencem à demonstração: use os campos e as opções que existem no seu processo.
A organização da configuração separa o papel do agente, o conhecimento de referência e os comportamentos. O conhecimento pode incluir documentos, texto simples ou consultas a dados de pipes e databases. Veja as possibilidades na documentação de bases de conhecimento, em inglês.
Uma política de reembolso responde quais despesas a empresa aceita. O comprovante anexado ao card mostra a despesa daquela solicitação. As duas fontes têm funções diferentes: uma oferece o critério; a outra traz a evidência a analisar.
Saiba mais: o guia de criação de Agentes de IA, em inglês, detalha a configuração para admins do pipe.
Como a triagem transforma texto em contexto
A demonstração avançou de um resumo simples para uma triagem com quatro resultados: categoria, urgência, resumo e justificativa. O ganho para o atendimento está em reunir uma leitura inicial que a pessoa possa conferir.
Para categorias, Beatriz apresentou referências como férias e benefícios para RH, e aquisição de materiais e equipamentos para Compras. A urgência considerava impacto e prazo informados na solicitação. Esses critérios precisam refletir as regras da sua empresa.
No pedido sobre saldo de férias, a categoria identificada foi RH, com urgência baixa. A justificativa tornava visível o motivo da classificação. Outro agente, com responsabilidade separada, sugeria próximos passos ao analista, como verificar o saldo e solicitar dados de identificação ausentes.
Ao orientar uma análise semelhante, organize o raciocínio nesta ordem: contexto da tarefa, dados de entrada, ação e saída esperada. Especifique também como tratar informação ausente e ambiguidade. Uma solicitação que reúne benefício e compra, por exemplo, precisa de um critério de encaminhamento ou revisão definido pela empresa.
“Não invente dados ausentes” precisa vir acompanhado de um caminho operacional: registre o que falta e indique quem deve conferir ou complementar a solicitação.
Na configuração, selecione os campos dinâmicos e as ações do processo. Escrever apenas o nome de um campo no texto não substitui essa referência. A orientação oficial para escrever instruções eficazes, em inglês, explica essa diferença.
Como testar e manter a revisão humana
Antes de ampliar o uso, compare a saída com o resultado que a equipe esperaria. Na sessão, Beatriz mostrou o teste com um card e o ajuste das instruções quando a resposta não seguia o idioma desejado.
Para uma triagem, vale montar uma amostra com situações diferentes:
- Um pedido de férias com assunto claro.
- Uma compra com prazo explícito e impacto descrito.
- Uma descrição curta, sem contexto suficiente.
- Um pedido que envolve duas áreas.
- Uma solicitação cujo anexo é essencial para entender o caso.
Essa amostra é uma recomendação para aplicar o aprendizado. Em cada caso, confira a categoria, a urgência, a fidelidade do resumo e a justificativa. Verifique também se as informações ausentes continuam identificadas como ausentes.
Defina a participação humana conforme o impacto da decisão. Em um reembolso, preparar uma análise e autorizar um pagamento são responsabilidades distintas. A Validação Humana em Agentes de IA permite encaminhar a saída para revisão. Para a continuidade depender da decisão registrada, siga o encadeamento de comportamentos descrito no Help Center, em inglês.
A revisão precisa ter responsável e critério de continuidade. Incluir uma solicitação de validação não dispensa configurar quando a próxima etapa poderá começar.
Como investigar anexos e resultados pelos logs
Uma pergunta da sessão foi: como investigar uma classificação que aparentemente não considerou a captura de tela anexada?
Comece conferindo se o anexo estava disponível na execução e se o campo correspondente fazia parte das entradas. Depois, consulte os Logs e o Rastreamento para verificar as fontes utilizadas e as ações registradas. O registro ajuda a investigar o percurso; os detalhes disponíveis podem variar por etapa.
O guia de Logs e Rastreamento explica como localizar a execução e analisar suas fontes. Se os registros não esclarecerem o resultado, reúna o card, o horário, o comportamento e a diferença entre a saída esperada e a observada para o Suporte.
Para arquivos, confira também formato e limites do recurso utilizado. O Processamento Inteligente de Documentos trabalha com anexos do card, enquanto documentos de conhecimento oferecem referências fixas. Consulte a documentação de processamento de documentos, em inglês.
O Max Effort, citado na sessão para análises extensas, está em Beta e tem condições próprias, incluindo limitações de OCR. Ele não deve ser tratado como uma ampliação universal para qualquer arquivo. Confira os requisitos atuais de Max Effort, em inglês, antes de usar o recurso.
Como escolher recursos e acompanhar o consumo
A escolha do modelo deve acompanhar a complexidade do comportamento. Os modelos atuais são Lite, Standard e Pro. Compare o resultado com seus casos de teste e consulte a referência de modelos e consumo, em inglês.
Leitura de documentos, pesquisa na web e cálculos atendem a necessidades diferentes. Identifique primeiro qual informação ou operação a tarefa exige. Uma triagem baseada na descrição e nas regras internas, por exemplo, pode ser avaliada sem acrescentar uma consulta à internet.
Para acompanhar o uso, consulte Estatísticas de uso e a aba de Créditos de IA. O consumo depende do modelo e das ferramentas executadas, conforme o guia de consumo, em inglês. A visibilidade de custos antes e depois da execução ajuda a comparar configurações quando disponível na organização.
Outra pergunta da sessão tratou de sequências com muitas ações. A recomendação foi dividir responsabilidades. Defina o que cada parte recebe, o que entrega e qual evento inicia a seguinte. Assim, a equipe consegue testar e acompanhar cada responsabilidade com clareza.
Perguntas da audiência, respondidas ao vivo
As dúvidas enviadas durante o treinamento trouxeram situações práticas de quem está começando a construir ou revisar agentes. Confira as seis perguntas e os principais pontos das respostas, com as condições de uso dos recursos.
Existem limites para imagens, PDFs e documentos?
Sim. Formato, quantidade e extensão dos arquivos precisam ser compatíveis com o recurso utilizado. Na sessão, Beatriz citou a leitura de até 30 páginas ou imagens no uso convencional e apresentou o Max Effort como alternativa para análises extensas. Antes de planejar o fluxo, confira os limites aplicáveis na documentação de criação de agentes, em inglês.
O Max Effort está em Beta, admite documentos de até 150 páginas e tem condições específicas, incluindo limitações de OCR. Isso exige conferir se o arquivo contém texto digital legível. Consulte os requisitos de Max Effort, em inglês, em vez de assumir que o recurso aceita qualquer documento maior.
Como investigar uma classificação que não considerou a captura de tela anexada?
A orientação da sessão foi consultar os Logs. Localize a execução e confira as informações disponíveis no Rastreamento, incluindo fontes consultadas e ações realizadas. Verifique também se o arquivo estava disponível, se seu campo foi incluído como entrada e se o formato é compatível.
Se os registros não explicarem a diferença, encaminhe o caso ao Suporte com o card, o horário da execução e o resultado esperado. O guia de Logs e Rastreamento ajuda a organizar essa investigação.
Qual é a diferença entre um Agente de IA e a automação Peça à IA?
Ambos permitem orientar uma tarefa com linguagem natural. A automação mencionada como Peça à IA na sessão usa uma ação de geração com IA dentro de uma regra de automação. Já o Agente de IA organiza sua atuação em torno de um papel, fontes de conhecimento e comportamentos, com recursos próprios de acompanhamento.
Para novas construções, Beatriz recomendou os Agentes de IA. Avalie essa escolha conforme a análise, as referências e as ações necessárias ao seu processo. A documentação de automações com IA, em inglês, explica a ação Generate with AI. Essa comparação não implica que os dois formatos tenham o mesmo consumo em qualquer configuração.
Como IA e automação podem atuar juntas no mesmo processo?
No exemplo da sessão, o agente faz a triagem, classifica a solicitação e registra a justificativa. Uma automação pode enviar uma confirmação ao solicitante após o encaminhamento, seguindo uma regra fixa.
O prazo informado nessa comunicação precisa corresponder ao compromisso real da equipe. Se a mensagem depender da conclusão da triagem, defina um evento que represente essa conclusão para iniciar a comunicação.
Quais cenários testar e quando conferir o resultado?
Beatriz recomendou testar com alguns cards e revisar a classificação e a resposta produzida. O exemplo citado foi ajustar as instruções quando o agente respondeu em inglês e o esperado era português.
Para aplicar essa orientação, inclua pedidos claros, ambíguos, incompletos e dependentes de anexo. Confira os resultados antes de colocar a configuração em operação e após mudanças que afetem as instruções ou as referências. A amostra apresentada na seção de testes deste artigo ajuda a começar essa comparação.
Como organizar um comportamento que exige mais de três ações?
Na sessão, a recomendação foi dividir o trabalho em responsabilidades menores e respeitar a ordem lógica da execução. A documentação atual estabelece até três ações principais por comportamento e orienta considerar outro comportamento ou uma automação complementar quando a tarefa ultrapassar esse limite.
Um agente pode concentrar a triagem e outro preparar orientações ao analista, como ocorreu na demonstração. Para conectar as partes, defina a saída da primeira e o evento que autoriza a seguinte. A separação precisa deixar claro quem entrega cada resultado e quando o processo pode continuar.
Antes de avançar, confirme que você entende:
☐ Sei distinguir uma regra fixa de uma tarefa de interpretação.
☐ Defini as entradas, as referências e a saída esperada da análise.
☐ Tenho exemplos para conferir casos claros, ambíguos e incompletos.
☐ Sei onde consultar os logs e quem participa da revisão.
Pronto para aplicar esse cuidado a outras tarefas? Continue com teste e acompanhamento de processos com IA.
