Criar um agente de IA – PlanRadar HelpCenter

Visão geral

Configure um agente de IA que reage à atividade em um dos seus projetos e cria tickets, adiciona comentários ou envia emails sem que ninguém precise iniciá-lo.

Acesso e permissões

Agentes de IA estão disponíveis somente no Webapp.

Você precisa de um usuário interno com a permissão de usuário Agentes de IA. Agentes de IA não estão disponíveis para subcontratados nem observadores.

A página Configuração exige um usuário interno com a permissão de usuário Account. Os proprietários da conta sempre a têm.

Leia mais em Permissões.

As execuções dos agentes consomem seu limite de uso de IA, o mesmo limite do Assistente de IA. Leia mais em Limites de uso e upgrades de IA.

Veja como funciona

Onde encontrar seus agentes

Clique em Agentes de IA na barra lateral.

Página	O que mostra
Agentes	Todos os agentes da conta com o status, o projeto, quem os criou e quando foram executados pela última vez.
Agentes arquivados	Os agentes que foram arquivados. Nunca são executados e não podem ser ativados novamente.
Registro de atividades	As execuções de todos os agentes da conta.
Configuração	As configurações da conta para Agentes de IA. Exige a permissão de usuário Account.

O que um agente precisa antes de poder ser executado

Quatro itens. O painel Testando ao lado do agente lista todos eles e marca cada um conforme você o conclui.

Item	Para que serve
Instruções	O que você quer que o agente faça, descrito com suas próprias palavras.
Projeto	O único projeto em que o agente é executado. Ele nunca lê nada fora dele.
Acionadores	Os eventos que iniciam uma execução, por exemplo a criação de um ticket.
Ações	O que o agente pode escrever.

Enquanto os quatro itens não estiverem prontos, você pode salvar o agente, mas não pode testá-lo nem ativá-lo.

Começar com um modelo

Sua conta inclui quatro agentes prontos para usar, cada um já descrito. Altere qualquer parte antes de ativá-lo.

Modelo	Para que serve
Verificador de preenchimento do ticket	Identifica novos tickets que estão sem campos obrigatórios preenchidos ou sem fotos.
Detector de tickets duplicados	Identifica possíveis tickets duplicados quando um novo ticket é criado.
Tarefa de verificação da resolução	Cria um subticket de verificação quando um ticket é resolvido.
Assistente de respostas sobre documentos	Elabora uma resposta com base nos documentos do projeto quando um ticket de pergunta é criado.

Clique em Agentes de IA na barra lateral.
Clique em Criar novo agente.
Em Nossos modelos, clique em um modelo.
Confira Nome do agente, Descrição e Instruções e altere-os se quiser.
Em Projetos, clique em Adicionar e escolha o projeto em que o agente é executado.
Confira o acionador e as ações. Clique em Editar em qualquer um deles para alterá-lo.
No painel Testando, clique em Execução de teste e leia o que o agente teria feito.
Clique em Ativar agente.

Descreva seu próprio agente

Você não precisa começar com um modelo. Na etapa Explicar, você pode escrever o que quiser com suas próprias palavras.

Clique em Agentes de IA na barra lateral e depois em Criar novo agente.
Em Instruções, descreva o que o agente deve fazer, por exemplo: quando um ticket for criado sem data de vencimento, adicione um comentário solicitando que ela seja informada.
Clique em Próximo.
Na etapa Configurar, clique em Adicionar em Projetos, Acionadores e Ações, um por vez.
Clique em Revisar e testar.
Dê um nome ao agente. A descrição é opcional.
No painel Testando, clique em Execução de teste.
Clique em Ativar agente.

Clique em Reescrever com IA abaixo das instruções para melhorar a redação. Mantenha o resultado, desfaça-o ou escreva sua própria versão.

Clique em Salvar como rascunho a qualquer momento para voltar depois. Um rascunho nunca é executado.

Acionadores

Um agente é executado quando um dos seus acionadores ocorre no projeto dele. Um agente pode ter mais de um acionador.

Acionador	Executa o agente quando
Ticket criado	Alguém cria um ticket.
Ticket atualizado	Alguém altera um ticket.
Comentário adicionado ao ticket	Alguém adiciona um comentário a um ticket.
Arquivo enviado	Alguém envia um arquivo para Documentos.
Nova versão do arquivo	Alguém envia uma nova versão de um arquivo em Documentos.

Os acionadores de ticket podem ser limitados a formulários e camadas específicos. Os acionadores de arquivo podem ser limitados a pastas específicas em Documentos.

Os agentes não são executados conforme uma programação e você não pode iniciá-los pelo Assistente de IA.

Ações

Um agente sempre pode ler os tickets e os documentos do projeto dele. É assim que ele responde a uma pergunta ou verifica se há um duplicado, e você não precisa ativar isso. As ações definem o que o agente pode escrever, e é você que as adiciona.

Um agente pode usar cada ação apenas uma vez.

Ação	O que você define	O que o agente decide
Criar ticket	Formulário, camada, responsável, prioridade, status e título. Somente o formulário é obrigatório.	O conteúdo do ticket e se algum deve ser criado.
Adicionar comentário	Nada.	O texto do comentário e se deve comentar.
Enviar email	Para, CC e Assunto, todos opcionais.	O conteúdo do email e se deve enviá-lo.

Em Criar ticket, escolha primeiro o formulário. O formulário determina quais campos um ticket tem, então as outras configurações ficam desativadas até você selecionar um formulário, e um campo que o formulário não tem permanece desativado.

Em Enviar email, você pode escolher os destinatários na ação ou indicar uma pessoa nas instruções. Os destinatários escolhidos na ação têm prioridade.

Um agente só pode enviar emails para membros ativos do próprio projeto. Endereços externos não são possíveis.

Teste antes de ativar

Um teste faz tudo o que uma execução real faz, exceto escrever. O agente lê os mesmos dados e toma as mesmas decisões, e o resultado mostra o que ele teria criado, comentado ou enviado. Nada é criado nem alterado no seu projeto. Um teste funciona em um rascunho e em um agente que já está ativo ou pausado.

Execução de teste aparece no painel Testando quando o agente tem instruções, um projeto, um acionador e uma ação. Antes disso, o painel indica o que ainda falta.

O teste é executado em um item real do projeto, escolhido automaticamente. Se nada no projeto corresponder ao acionador, o teste retorna nenhum dado em vez de um resultado.
Você pode testar as alterações antes de salvá-las. Depois, o agente volta às configurações salvas.
Os testes aparecem no histórico de execuções junto com as execuções reais, marcados como testes.

Um teste consome seu limite de uso de IA, igual a uma execução real. Se a conta atingiu o limite, os testes voltam a funcionar quando o limite é renovado.

Ative o agente

Clique em Ativar agente. O agente aparece como Ativo na lista e passa a ser executado sempre que um acionador ocorrer. Pause-o a qualquer momento e ele para de ser executado até alguém reativá-lo.

Somente a pessoa que criou o agente pode reativá-lo depois de uma pausa. Um agente arquivado não pode ser ativado novamente.

Veja o que um agente fez

Cada execução é registrada. Abra um agente e depois uma execução para ver o que o agente leu, o que decidiu e o que escreveu. Registro de atividades mostra as execuções de todos os agentes da conta.

Uma execução pode terminar sem que o agente faça nada. Esse é um resultado normal, não uma falha, e a execução informa isso: "Your agent reviewed this event and decided no action was needed."

A pessoa que criou o agente e o proprietário da conta veem todos os detalhes de cada execução. Os demais veem que a execução aconteceu.

Quando um agente se pausa sozinho

Um agente se pausa sozinho nestes casos. Você recebe uma notificação, e o agente fica pausado até a pessoa que o criou reativá-lo.

Sua conta atingiu o limite de uso de IA. O agente não reinicia sozinho quando o limite é redefinido.
As execuções falharam repetidamente porque o conteúdo enviado ao modelo de IA era muito grande. Reduza as instruções ou direcione o agente para formulários menores ou menos documentos.
O agente atingiu o limite de ações em uma única execução.
O projeto do agente foi arquivado ou excluído.
O proprietário do agente foi definido como inativo, perdeu a permissão de usuário Agentes de IA ou perdeu o acesso ao projeto.
Muitas execuções foram iniciadas em pouco tempo.

Tenha em mente

Os agentes criam tickets, adicionam comentários e enviam emails. Eles não alteram nem excluem tickets, documentos ou plantas existentes.
O agente decide se age. Duas execuções em tickets parecidos podem terminar de formas diferentes.
Cada agente tem o próprio usuário na sua conta. Tudo o que ele escreve aparece com esse usuário no histórico do ticket.

Este conteúdo foi gerado com o auxílio de inteligência artificial e pode conter imprecisões. Favor revisar e verificar as informações antes de usá-las.

Configurações da conta para Agentes de IA

A página Configuração tem três configurações para toda a conta, não por usuário. Exige um usuário interno com a permissão de usuário Account.

Configuração	Para que serve
Instruções globais	Instruções aplicadas a cada execução de agente na conta, além das instruções de cada agente. Escolha uma sugestão como ponto de partida ou escreva as suas e use Reescrever com IA para melhorar a redação. A página mostra quem as alterou pela última vez e quando.
Notificações	Dois botões para toda a conta: avisar quando uma execução de agente falha e avisar quando um agente é pausado.
Permissões	Todas as pessoas da conta que podem usar Agentes de IA, com um campo de busca e uma contagem. Clique no ícone de lápis ao lado de uma pessoa para abrir as configurações de usuário dela.

FAQ

Um agente pode alterar um ticket?

Não. Um agente pode criar um ticket, comentá-lo e enviar um email. Ele não pode editar nem excluir nada.

Um agente pode abranger vários projetos?

Não. Um agente é executado em um único projeto. Crie um segundo agente para um segundo projeto.

Subcontratados ou observadores podem criar agentes?

Não. Agentes de IA estão disponíveis somente para usuários internos.

Por que ainda não consigo testar meu agente?

Execução de teste aparece quando o agente tem instruções, um projeto, um acionador e uma ação. O painel Testando indica qual dos quatro itens ainda falta.

Posso testar uma alteração antes de salvá-la?

Sim. O teste usa o que está na tela e, depois, o agente volta às configurações salvas.

Em nome de quem o agente age?

Cada agente tem o próprio usuário na sua conta. Tudo o que ele escreve aparece com esse usuário no histórico do ticket, então você sempre consegue distinguir o que um agente fez do que uma pessoa fez.

Um colega pausou um agente. Por que não consigo reativá-lo?

Somente a pessoa que criou o agente pode reativá-lo depois de uma pausa.