Um agente personalizado é ONE realizando um trabalho que você define. Ele começa quando algo acontece na Factorial TI ou em uma programação, 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 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, habilitar ou excluir agentes, você precisa da permissão Gerenciar agentes de IA. Visualizar agentes de IA permite que você veja os 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 da Factorial TI que o agente deve acessar.

Como usar

Vá para Agentes de IA > Agentes e clique em Navegar 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 TI escolhido acontece. Pesquise na lista e selecione o evento.
• Programação: 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. Programações 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 "Escrever boas instruções" abaixo.

Para que ONE as redija, clique no ícone do assistente ao lado de Instruções. Ele lê o nome, descrição e gatilhos na tela, e então faz perguntas ou escreve um rascunho a partir dessa configuração. O rascunho vai para o campo. Nada é salvo até que você clique em Criar.

Em 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 da Factorial TI para seus dados da Factorial TI. 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:

Clique em Criar. O agente é criado já habilitado e executa na próxima vez que um gatilho for acionado.

Escrever 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 saída. 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á existir em um item da base de conhecimento, selecione esse item em Conhecimento em vez de colar a regra nas instruções.

Testar um agente com Execução seca 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 seca e Executar agora.

Execução seca funciona com seus dados reais, mas não muda 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 seca, assim como em uma execução real.

Executar agora executa o agente de verdade uma vez que você confirma. Use-o quando uma execução seca 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 maneira, pois não tem nada com que trabalhar. Um agente desabilitado ainda pode fazer uma execução seca, mas você deve clicar em Habilitar agente antes de Executar agora.

Execuções que você inicia aparecem como Executando na aba Execuções até que terminem.

Acompanhar 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 produziu e, se falhou, o erro.

Para ver execuções de todos os seus agentes juntos, vá para Agentes de IA > Execuções.

Gerenciar seus agentes

A lista de Agentes mostra cada agente com seu tipo (Factorial TI 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. Restringa a lista com as abas (Todos os agentes, Habilitados, Desabilitados, Com falha), pesquisa e filtros, e use Salvar como para manter uma visualização.

Do menu Ações (…) de um agente:

• Desabilitar agente: para todas as execuções. O agente mantém sua configuração e histórico de execuções, e Habilitar agente o ativa novamente. Um agente desabilitado 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 desativado na seleção 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 anteriores 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, a Factorial TI transformou os fluxos de trabalho que você configurou em agentes personalizados. Cada agente mantém a programação 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 anteriores não foram transferidas.

Alguns fluxos de trabalho se tornaram agentes desabilitados, por exemplo, aqueles que não foram executados nos últimos 35 dias. Eles estão na aba Desabilitados de Agentes de IA > Agentes e não fazem nada até que você clique em Habilitar agente no menu ….

Um agente migrado pode usar as ferramentas do conector da Factorial TI sem pedir, independentemente de ter chegado habilitado ou desabilitado. Revise os conectores de cada um e defina as 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.

Resolução de Problemas e FAQ

Resolução de Problemas

• Executar agora não está disponível. O agente pode ter apenas gatilhos de evento, então não tem nada com que trabalhar. Se estiver desabilitado, clique em Habilitar agente primeiro.
• Suas alterações mais recentes não se aplicaram a uma execução. Execução seca e Executar agora usam o agente salvo. Salve e, em seguida, 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 desabilitado 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 Desabilitados 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á na seleção de agentes de IA. Ele está desabilitado. Habilite-o para adicioná-lo a novos tickets ou tarefas.

FAQ

1. Um agente pode me perguntar antes de executar uma ferramenta?
   Não. Ninguém está lá para responder durante uma execução, então existem apenas Sempre permitir e Sempre recusar para agentes.
    
2. Uma execução seca muda alguma coisa?
   Não. Ela registra cada email, ticket, comentário ou ação de dispositivo em vez de realizá-los.
    
3. Um agente pode ter mais de um gatilho?
   Sim. Ele pode combinar vários eventos e programações.
    
4. O que acontece com as execuções passadas quando eu excluo um agente?
   Elas permanecem disponíveis.
    
5. O agente pode ler todos os itens da base de conhecimento?
   Não. Ele lê apenas os itens publicados que você selecionar em Conhecimento.