Um agente personalizado é ONE que realiza um trabalho que você define. Ele começa quando algo acontece no Factorial IT ou em um cronograma, segue suas instruções e usa apenas o conhecimento e os conectores que você fornecer.
Recurso/Funcionalidade
Visão geral
Você pode construir um agente a partir de uma página em branco ou pegar um dos modelos de agente e ajustá-lo. Cada agente tem gatilhos (o que o inicia), instruções (o que ele faz), conhecimento e conectores (o que ele pode usar) e um nível de modelo. Você pode testá-lo antes que ele funcione de verdade e acompanhar cada execução depois.
Antes de começar
- Para criar, editar, ativar ou excluir agentes, você precisa da permissão Gerenciar agentes de IA. Visualizar agentes de IA permite que você veja agentes e suas execuções.
- Publique itens da base de conhecimento para cada política ou procedimento que o agente deve seguir.
- Configure conectores para cada sistema fora do Factorial IT que o agente deve acessar.
Como usar
Vá para Agentes de IA > Agentes e clique em Navegar por modelos. No catálogo de Modelos, escolha um modelo para adaptar ou clique em Começar do zero.
Nomeie e descreva o agente:
- Nome: até 80 caracteres. É assim que o agente aparece na lista e em suas execuções.
- Ícone: clique em Embaralhar cor para dar ao agente uma cor diferente.
- Descrição: uma ou duas frases sobre para que o agente serve.
Clique em Adicionar gatilho e escolha um tipo:
- Evento: o agente é executado cada vez que o evento de Factorial IT escolhido acontece. Pesquise na lista e selecione o evento.
- Cronograma: o agente é executado em um padrão repetido. Defina Início (uma data), cada n horas, dias, semanas ou meses, às uma hora, e um fuso horário. Cronogramas semanais permitem que você escolha os dias; mensais permitem que você escolha o dia do mês.
Escreva as Instruções. O agente as recebe em cada execução: o que verificar, o que fazer, o que deixar para sua equipe e como relatar. Veja "Escreva boas instruções" abaixo.
Para que ONE as elabore, clique no ícone do assistente ao lado de Instruções. Ele lê o nome, a descrição e os gatilhos na tela, e então pergunta ou escreve um rascunho a partir dessa configuração. O rascunho vai para o campo. Nada é salvo até que você clique em Criar.
Na seção Conhecimento, selecione os itens da base de conhecimento publicados que o agente pode ler. O agente lê esses itens e nenhum outro. Itens não publicados não são listados.
Escolha o que o agente pode acessar:
- Acesso à web: permite que o agente pesquise e leia na web.
- Conectores: ative cada conector que o agente pode usar, incluindo o conector Factorial IT para seus dados do Factorial IT. Expanda um conector para definir uma política para cada ferramenta.
Abra Configurações avançadas e escolha o Nível de modelo usado em cada execução deste agente:
| Nível | Usá-lo para |
|---|---|
| Eficiente | Mais rápido, menor custo |
| Pro | Qualidade e custo equilibrados |
| Fronteira | Mais alta qualidade, maior custo |
Clique em Criar. O agente é criado já ativado e executa na próxima vez que um gatilho for acionado.
Escreva boas instruções
O agente segue suas instruções palavra por palavra em cada execução. Cubra quatro pontos:
- O trabalho. Para que o agente serve e o que ele revisa em cada execução.
- As ações. O que ele pode fazer sozinho e o que deve sugerir em vez de fazer.
- Os limites. O que ele nunca deve fazer e quando deve parar e passar para sua equipe.
- A entrega. O que ele entrega (um ticket, um comentário, um relatório) e quem o recebe.
Nomeie as pessoas, políticas e limites que ele deve usar. Se uma regra já estiver em um item da base de conhecimento, selecione esse item em Conhecimento em vez de colar a regra nas instruções.
Teste um agente com Execução teste ou Executar agora
Você pode ver o que um agente faz sem esperar por um gatilho. Abra o agente: sua página oferece Execução teste e Executar agora.
Execução teste funciona com seus dados reais, mas não altera nada. Qualquer email, ticket, comentário ou ação de dispositivo que ele teria feito é registrado em vez de realizado. Os detalhes da execução incluem uma seção O que ele teria feito antes do relatório. Ferramentas configuradas para Sempre recusar são deixadas de fora de uma execução teste, assim como em uma execução real.
Executar agora executa o agente de verdade assim que você confirmar. Use-o quando uma execução teste mostrar o resultado que você espera.
Ambos usam a versão salva do agente, então salve suas alterações primeiro. Um agente acionado apenas por eventos não pode ser iniciado dessa forma, porque não tem nada para trabalhar. Um agente desativado ainda pode fazer uma execução teste, mas você deve clicar em Ativar agente antes de Executar agora.
Execuções que você inicia aparecem como Executando na aba Execuções até que terminem.
Acompanhe suas execuções
Abra um agente e vá para a aba Execuções para ver cada execução, o gatilho por trás dela e o resultado. Clique em uma execução para ver seus detalhes: um resumo do que o agente fez, seu relatório, quaisquer arquivos que ele produziu e, se falhou, o erro.
Para ver execuções de todos os seus agentes juntos, vá para Agentes de IA > Execuções.
Gerencie seus agentes
A lista de Agentes mostra cada agente com seu tipo (Factorial IT ou Personalizado), seus gatilhos e status. Nos últimos 30 dias, também mostra suas execuções, as execuções que precisam de atenção e os créditos de IA usados. Diminua a lista com as abas (Todos os agentes, Ativados, Desativados, Falhando), pesquisa e filtros, e use Salvar como para manter uma visualização.
No menu de Ações (…) de um agente:
- Desativar agente: para todos os gatilhos. O agente mantém sua configuração e histórico de execuções, e Ativar agente o liga novamente. Um agente desativado continua com tickets e tarefas que já o têm como seu agente de IA. Ele não pode ser adicionado a novos tickets ou tarefas: aparece esmaecido no seletor de agente de IA. Para pará-lo em um ticket, defina o agente de IA do ticket como Nenhum.
- Excluir agente: remove o agente. Suas execuções passadas permanecem disponíveis.
As alterações entram em vigor na próxima execução. Enquanto houver alterações não salvas, o agente mostrará Alterações pendentes.
Encontre seus fluxos de trabalho anteriores
Nos dias 12 e 13 de outubro de 2026, o Factorial IT transformou os fluxos de trabalho que você havia configurado em agentes personalizados. Cada agente mantém o cronograma de seu fluxo de trabalho e suas instruções exatamente como escritas, além de uma breve nota sobre como enviar seus relatórios e emails. Seu relatório agora é o relatório de execução do agente, em HTML, em vez de um arquivo PDF ou CSV. Execuções de fluxos de trabalho passados não foram transferidas.
Alguns fluxos de trabalho se tornaram agentes desativados, por exemplo, aqueles que não haviam sido executados nos últimos 35 dias. Eles estão na aba Desativados de Agentes de IA > Agentes e não fazem nada até que você clique em Ativar agente em seu menu ….
Um agente migrado pode usar as ferramentas do conector Factorial IT sem pedir, independentemente de ter chegado ativado ou desativado. Revise os conectores de cada um e defina ferramentas de leitura e escrita para Sempre recusar para qualquer alteração que ele não deva fazer sozinho.
Fluxos de trabalho que estavam inativos ou não tinham instruções não foram migrados e não existem mais.
Dicas e Melhores Práticas
- Ofereça o acesso mais restrito que realiza o trabalho. Defina ferramentas de leitura e escrita para Sempre recusar a menos que o agente precise delas.
- Execução teste antes de Executar agora. Verifique o que o agente mudaria antes que ele mude qualquer coisa.
- Aponte para o conhecimento em vez de copiá-lo. Selecione o item da base de conhecimento em Conhecimento para que a regra permaneça em um só lugar.
- Diga quando parar. Instruções que nomeiam o limite e o ponto de entrega evitam surpresas.
- Escolha o nível para o trabalho. Eficiente para verificações de rotina, Fronteira apenas onde a qualidade justifica o custo.
- Revise fluxos de trabalho migrados. Eles podem usar o conector Factorial IT sem pedir.
Solução de Problemas e FAQ
Solução de Problemas
- Executar agora não está disponível. O agente pode ter apenas gatilhos de evento, então não tem nada para trabalhar. Se estiver desativado, clique em Ativar agente primeiro.
- Suas últimas alterações não se aplicaram a uma execução. Execução teste e Executar agora usam o agente salvo. Salve, depois execute novamente. Edições afetam apenas a próxima execução.
- O agente não pode usar uma ferramenta. A ferramenta está configurada para Sempre recusar para este agente, ou o conector está desligado. Expanda o conector no agente para verificar.
- Um agente desativado ainda está trabalhando em um ticket. Isso é esperado. Defina o agente de IA do ticket como Nenhum para pará-lo.
- Você não consegue encontrar um fluxo de trabalho migrado. Procure na aba Desativados de Agentes de IA > Agentes. Fluxos de trabalho que estavam inativos ou não tinham instruções não foram migrados.
- O agente não está no seletor de agente de IA. Ele está desativado. Ative-o para adicioná-lo a novos tickets ou tarefas.
FAQ
-
Um agente pode me perguntar antes de executar uma ferramenta?
Não. Ninguém está lá para responder durante uma execução, então apenas Sempre permitir e Sempre recusar existem para agentes.
-
Uma execução teste muda algo?
Não. Ela registra cada email, ticket, comentário ou ação de dispositivo em vez de fazê-lo.
-
Um agente pode ter mais de um gatilho?
Sim. Ele pode combinar vários eventos e cronogramas.
-
O que acontece com execuções passadas quando eu excluo um agente?
Elas permanecem disponíveis.
-
O agente pode ler todos os itens da base de conhecimento?
Não. Ele lê apenas os itens publicados que você seleciona em Conhecimento.