Criar e gerenciar os seus agentes de IA

Visão geral

Configure agentes de IA que reagem à atividade nos seus projetos e criam tickets, adicionam comentários ou enviam e-mails por conta própria, com base nas instruções que você escreve.

Um agente é formado por quatro partes, e cada uma tem uma função diferente:

• As Instruções dizem ao agente o que fazer, com as suas próprias palavras e com o nível de detalhe que você quiser. É aqui que o trabalho de verdade é descrito.
• Os Acionadores definem quando o agente começa a verificar. Eles não definem se ele age.
• As Ações estabelecem o limite do que o agente pode fazer. Elas não definem o que ele faz.
• O Projeto é o único projeto que o agente observa e os únicos dados que ele pode ler.

Acionadores e ações formam a moldura; as instruções fazem o trabalho dentro dela. Por exemplo, para que um agente comente quando um ticket for resolvido, dê a ele o acionador Ticket atualizado para que verifique a cada alteração em um ticket, e escreva nas instruções que ele só deve agir quando o status passar para Resolvido.

Estes são os eventos que um agente pode usar como acionadores:

• Ticket criado
• Ticket atualizado
• Comentário adicionado ao ticket
• Arquivo enviado (em Documentos)
• Nova versão do arquivo (em Documentos)

Um agente sempre lê os tickets e documentos do seu projeto para encontrar as informações de que precisa. Ele é executado com as permissões do usuário que o criou e é seu proprietário. Tenha isso em mente caso haja informações confidenciais em tickets ou documentos, e deixe claro nas instruções o que o agente deve fazer e compartilhar e o que não deve.

Estas são as ações que um agente pode ter permissão para executar:

• Criar ticket
• Adicionar comentário (em um ticket)
• Enviar email (para membros do projeto)

Tudo o que um agente cria leva o nome dele: um ticket ou comentário que ele escreve mostra o nome do agente em nome da pessoa que o criou. Leia mais em Recognise Work Done by AI Agents.

Você também pode definir instruções globais para toda a conta, aplicadas a todos os agentes, e controlar as notificações de agentes para a conta inteira. Leia mais em Configure AI Agents for your Account.

Sem suporte na versão atual:

• Alterar ou excluir tickets, documentos ou plantas existentes. Um agente apenas cria.
• Executar de acordo com uma programação. Um agente reage somente a eventos do seu projeto.
• Atuar em vários projetos. Cada agente é executado em exatamente um projeto: crie um agente para cada projeto que deseja cobrir.
• Enviar e-mails para pessoas fora do projeto. Os e-mails só podem ser enviados para membros do projeto.

Este recurso consome o seu limite de uso de IA. Leia mais em Limites de uso e upgrades de IA.

Leia mais sobre Privacidade e segurança para recursos de IA.

Como acessar os agentes de IA

1. Clique em Agentes de IA

Você vê os agentes da sua conta:

Criar um agente

Um agente precisa de quatro coisas antes de poder ser executado: instruções, um projeto, ao menos um acionador e ao menos uma ação. Até que todas estejam definidas, o agente permanece como rascunho, e um rascunho nunca é executado.

Você pode escrever um agente do zero ou partir de um dos quatro modelos incluídos na sua conta.

Do zero

Para criar um novo agente sem modelo:

1. Clique em Criar novo agente
   
2. Escreva as instruções, por exemplo Criar subtickets com base em comentários sobre tarefas incompletas
   Leia mais abaixo em Escrever as instruções.
3. Clique em Próximo
   
4. Adicionar um Projeto, Acionadores e Ações
   Leia mais abaixo em Definir o projeto, Definir os acionadores e Definir as ações.
   
5. Clique em Revisar e testar
   
6. Clique em Execução de teste
   Leia mais abaixo em Testar o agente.
   
7. Clique em Ativar agente
   Leia mais abaixo em Ativar o agente.
   

A partir de um modelo

A sua conta inclui quatro agentes prontos para usar. Cada um chega totalmente escrito, com instruções, acionador e ações já definidos, faltando apenas o projeto.

Para criar um agente com um modelo:

1. Clique em Criar novo agente
   
2. Em Nossos modelos, clique no modelo que deseja usar
   
3. Clique em Adicionar em Projeto
   
4. Selecione o projeto
5. Clique em Salvar
   
6. Verifique o Nome do agente, a Descrição e as Instruções e altere-os se quiser.
7. Clique em Execução de teste
   
8. Clique em Ativar agente
   

Configurar e editar um agente

Tudo o que um agente precisa é definido na própria tela do agente: nome, descrição, instruções, projeto, acionadores e ações.

Para editar um agente em rascunho:

1. Clique no agente
   

Para editar um agente ativo ou pausado:

1. Clique no agente
   
2. Clique em Editar agente
   

Agentes arquivados não podem ser editados. É preciso restaurá-los primeiro.

A tela do agente é a mesma, tanto se você criar um novo agente como se editar um existente. Aqui você pode adicionar ou editar o seguinte:

1. Nome do agente (deve ser único: se o nome já estiver em uso, um número é adicionado)
2. Descrição
3. Instruções – leia mais abaixo em Escrever as instruções
4. Projeto – leia mais abaixo em Definir o projeto
5. Acionadores – leia mais abaixo em Definir os acionadores
6. Ações – leia mais abaixo em Definir as ações

A tela do agente, com o painel Testando à direita:

Salvar alterações não muda o status do agente. Os agentes continuam como rascunho, pausados ou ativos.

Escrever as instruções

As instruções são o coração do agente: tudo o que ele faz decorre delas. Escreva-as como você explicaria a tarefa a um colega.

Por exemplo:

• “Quando um ticket for criado sem data de vencimento, adicione um comentário pedindo essa data.”
• “Quando um ticket for movido para Resolvido, verifique as fotos e comente se a correção não estiver documentada.”

Para escrever as instruções:

1. Em Instruções, descreva o que o agente deve fazer.
   
2. Opcional: clique em Reescrever com IA para receber uma sugestão da IA com uma formulação mais clara das suas instruções.
   
3. Opcional: você pode manter a sugestão, desfazê-la com Desfazer ou escrever a sua própria versão.
   

As instruções podem ter até 4.000 caracteres.

Para expandir o campo de entrada das instruções:

1. Clique no ícone Expandir
   

Para recolher o campo de entrada expandido:

1. Clique no ícone Recolher
   

Definir o projeto

Um agente é executado em exatamente um projeto e nunca lê nada fora dele.

Para editar o projeto:

1. Em Projeto, clique em Editar
   
2. Selecione o projeto em que o agente é executado
3. Clique em Salvar
   

Definir os acionadores

Um acionador é o evento que inicia uma execução. Um agente pode ter vários acionadores e é executado quando qualquer um dos eventos definidos ocorre.

Para editar os acionadores:

1. Em Acionadores, clique em Editar
   
2. Em Origem, escolha se o agente reage a Tickets ou a Documentos.
   
3. Em Evento, escolha o evento que inicia a execução.
   
4. Clique em Salvar
   

Cada acionador é uma origem e um evento:

Para adicionar mais acionadores:

1. Clique em + Adicionar acionador
2. Selecione uma Origem e um Evento como descrito acima
   

Você pode restringir um acionador com o Escopo, para que o agente reaja apenas a parte do projeto:

• Acionadores de tickets podem ser limitados a uma Camada, a um Formulário ou a ambos.
• Acionadores de documentos podem ser limitados a uma Pasta.

Para limitar o escopo de um acionador de tickets:

1. Clique em Configurações avançadas
2. Selecione uma Camada e/ou um Formulário
   

Para limitar o escopo de um acionador de documentos:

1. Clique em Configurações avançadas
2. Selecione uma Pasta
   

Um acionador de documentos observa uma pasta, não um único arquivo. Para que um agente reaja a um documento específico, mova-o para uma pasta própria e limite o acionador a essa pasta.

Um acionador define quando o agente olha, não se ele age. Ticket atualizado dispara a cada alteração em um ticket, portanto, se o agente só deve agir em alguns casos, informe isso nas instruções — por exemplo “aja somente quando o status passar para Resolvido”. O agente lê o evento, compara com as suas instruções e não faz nada se não se aplicar.

Eventos de tickets valem onde quer que aconteçam: um ticket criado no aplicativo móvel inicia o agente da mesma forma que um criado no aplicativo web.

Acionadores de documentos estão disponíveis para contas com Gerenciamento de documentos.

Definir as ações

As ações são o que o agente pode escrever. Adicione as que ele precisa; o agente decide por conta própria quando usar cada uma, com base nas suas instruções. Cada ação pode ser adicionada uma vez.

Para editar as ações:

1. Em Ações, clique em Editar
   
2. Clique em Adicionar ação
3. Clique em Criar ticket, Adicionar comentário ou Enviar email.
   
4. Opcional: preencha as configurações que o agente deve sempre usar.
   Para Criar ticket você pode definir: Camada, Formulário. E em Defina valores específicos para os campos: Título, Responsável, Prioridade, Status
   Para Enviar email você pode definir: Para, CC, Assunto
5. Clique em Salvar
   

Testar o agente

O painel Testando lista as quatro coisas de que o agente precisa e marca cada uma conforme você as conclui. Quando as quatro estiverem prontas, você pode executar um teste.

Uma execução de teste lê dados reais do seu projeto, mas não escreve nada. O resultado mostra o que o agente teria criado, comentado ou enviado. Nada é criado nem alterado no seu projeto. Você pode testar as alterações antes de salvá-las.

Para testar um agente:

1. No painel Testando, clique em Execução de teste.
   
2. Leia o que o agente teria feito.

Um teste que termina sem que o agente faça nada é um resultado normal. Significa que o agente concluiu que nenhuma ação era necessária.

Um teste consome o seu limite de uso de IA, igual a uma execução real.

Ativar o agente

Um agente só começa a trabalhar depois de você ativá-lo.

Para ativar um agente:

1. Clique em Ativar agente
   

O agente aparece como Ativo na lista e, a partir de então, é executado sempre que um dos eventos definidos nos acionadores ocorrer.

Para manter o agente sem ligá-lo, clique em Salvar como rascunho. Um rascunho nunca é executado, e você pode voltar e ativá-lo a qualquer momento.

Salvar o agente como rascunho em vez de ativá-lo:

Cada execução do agente é registrada. Abra o Registro de atividades para ver o que ele fez e por quê. Leia mais em Monitor AI Agents in the Activity Log.

Gerenciar os seus agentes

• Qualquer pessoa com a permissão de usuário Agentes de IA vê os agentes que são executados nos projetos aos quais tem acesso, incluindo agentes criados por um colega. O mesmo se aplica a Agentes arquivados e ao Registro de atividades.
• A pessoa que cria um agente é a sua proprietária, e somente ela pode editá-lo, testá-lo, ativá-lo, pausá-lo, arquivá-lo, restaurá-lo ou excluí-lo.

Duplicar

Duplicar cria a sua própria cópia de um agente, da qual você é proprietário e que pode alterar. Você pode duplicar qualquer agente que consiga ver, incluindo um criado por um colega — é assim que você reaproveita o agente de outra pessoa ou executa o mesmo comportamento em um segundo projeto.

Para duplicar um agente:

1. Abra o menu Mais do agente
2. Clique em Duplicar agente
   

A cópia recebe o nome do original com (copy) acrescentado e começa como rascunho. Altere o projeto ou o que mais precisar, depois teste e ative.

Pausar

Pausar interrompe a execução do agente e mantém todas as suas configurações, para que você possa ligá-lo novamente quando quiser.

Para pausar um agente:

1. Abra-o na lista de agentes
   
2. Abra o menu Mais
3. Clique em Pausar agente
   

Arquivar e restaurar

Arquivar move o agente para Agentes arquivados e interrompe a sua execução, sem excluir nada.

Para arquivar um agente:

1. Abra o menu Mais do agente
2. Clique em Arquivar agente
   

Para restaurar um agente:

1. Clique em Agentes arquivados
2. Abra o menu Mais do agente
3. Clique em Restaurar agente
   

Agentes restaurados ficam sempre pausados. Ative-os quando estiver pronto.

Excluir

Exclua um agente somente se tiver certeza de que nunca vai querer restaurá-lo. Se não tiver certeza, arquive-o. As suas execuções permanecem no Registro de atividades, então você ainda pode ver o que ele fez.

Para excluir um agente:

1. Abra o menu Mais do agente
2. Clique em Excluir agente
   
3. Clique em Excluir para confirmar
   

Quando um agente se pausa sozinho

Um agente se pausa sozinho nestes casos:

• A sua conta atingiu o limite de uso de IA.
• As execuções falharam repetidamente porque o conteúdo enviado ao modelo de IA era muito grande. Encurte 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.
• Muitas execuções foram iniciadas em pouco tempo.
• O proprietário do agente foi definido como inativo, perdeu a permissão Agentes de IA ou perdeu o acesso ao projeto.

Você recebe uma notificação, e o agente continua pausado até você ativá-lo novamente.

É possível desativar, para a conta inteira, as notificações de falha na execução de um agente ou de pausa automática. Leia mais em Configure AI Agents for your Account.

Um agente nunca se reinicia sozinho. Passe o cursor sobre o status Pausado para ver por que ele parou.