Agentes de IA no Wrike

Selecione a guia Agentes de IA 2 na visão geral das configurações do espaço e clique em Começar 3.

Escolha um tipo de agente no menu suspenso 4 (Triagem, Recebimento ou Risco) ou clique em + Agente de IA personalizado 5 para criar seu próprio agente.

Configure os detalhes:

1. Dê um nome ao seu agente. Dê ao seu agente um nome descritivo — isso servirá como seu @handle ao atribuí-lo a locais.

2. Em Instruções gerais, descreva a função, o objetivo, a lógica, as ações esperadas e o comportamento de fallback do agente. Adicione exemplos de entradas/saídas se isso ajudar a esclarecer o comportamento.

   Exemplo: “Você atua como assistente de projeto. Você monitora o trabalho atribuído, sinaliza riscos e mantém as equipes alinhadas atualizando itens de trabalho e deixando comentários claros e acionáveis.”

3. Escolha quando o agente deve ser acionado:

   • Agentes agendados (por exemplo, um relatório de status de risco): defina com que frequência o agente será executado (Diariamente, Semanalmente ou Personalizado).
   • Agentes baseados em eventos: selecione gatilhos como Novo item criado ou Alterações de valor de campo (para status ou outros campos).
   • Agentes baseados em data: acionam o agente em relação a um valor de campo de data, como "3 dias antes da data de vencimento" ou "Quando a data de início for alcançada". Funciona com campos personalizados de Data e Data/hora e oferece suporte ao cálculo de dias úteis. Ideal para lembretes, escalonamentos e ações baseadas em prazo.
   • Agentes acionados por API: alterações feitas via API do Wrike também acionam agentes, permitindo integração com sistemas externos.
   • Integração com Wrike Automations: os agentes funcionam bidirecionalmente com o Wrike Automations. Regras tradicionais de automação podem acionar agentes, e ações de agentes podem ativar regras de automação. Isso permite fluxos de trabalho complexos de múltiplas etapas que combinam raciocínio de IA com automação baseada em regras.

   Nota

   Os agentes de IA podem ler e reagir a estes tipos de campos personalizados: Texto, Número, Percentual, Moeda, Data, Seleção única, Seleção múltipla, Duração, Caixa de seleção, Link para banco de dados, Espelhos e Campos calculados/fórmula.

   Além dos campos personalizados, os agentes podem ler:

   • Autor e responsável do item de trabalho
   • Campos personalizados vazios — os agentes podem raciocinar sobre o que está faltando, não apenas sobre o que está presente
   • Campos calculados/fórmula — podem expor dados do sistema que os agentes não acessam diretamente, como capacidade, carga de trabalho ou horas programadas
   • Campos personalizados do item pai — os agentes podem ler campos personalizados da tarefa ou projeto pai
   • Itens irmãos e subtarefas — os agentes podem ver itens irmãos e subtarefas para raciocínio entre itens
   • Contexto de localização — os agentes sabem onde estão no espaço e na hierarquia de contas

4. Defina o escopo de quando o gatilho deve ocorrer:

   • Qualquer subitem do item de trabalho onde o agente foi adicionado:

     Use isso para ações em nível de tarefa, como Recebimento ou Triagem. O agente reage a alterações nos subitens e atua nesses subitens.

     Exemplo: o agente de Recebimento é adicionado a uma pasta de Solicitações recebidas. Quando um novo subitem é adicionado a essa pasta, isso aciona o agente para verificar se todas as informações obrigatórias (como responsável ou data de vencimento) foram fornecidas. Em seguida, o agente publica um comentário nesse subitem para informar se algo está faltando.

   • Item onde o agente foi adicionado:

     Use isto para ações agregadas, como um relatório de riscos. O agente reage a alterações neste item e atua sobre o mesmo item.

     Exemplo: um agente personalizado é adicionado a um projeto de Lançamento de Produto para notificar os seguidores sobre as alterações no projeto. Se algum dos campos personalizados do projeto mudar, o agente publica um comentário no projeto sobre essa alteração e @menciona todos os seguidores.

5. Defina uma ação:

   • Postar comentário: o agente compartilha sua análise ou decisão como um comentário no item relevante.

   • Atualizar valores de campo: o agente atualiza campos específicos, como Responsável, Campo personalizado, Nome do item ou Status.

     • Alterar campo personalizado: o agente atualizará campos personalizados específicos (escolha qual campo atualizar).

       Nota

       Os agentes de IA podem atualizar estes tipos de campos personalizados: Texto, Seleção única, Seleção múltipla, Número, Percentual, Moeda, Link para banco de dados, Caixa de seleção, Data.

       Apenas leitura (não podem ser escritos por agentes): campos Espelho e campos Calculados/Fórmula. Os agentes podem ler esses valores como contexto, mas não podem atualizá-los. Campos personalizados do tipo Pessoa não podem ser lidos nem escritos por agentes.

       Campos de data que incluem um componente de hora (um recurso Labs) não são compatíveis com ações de agente. Esses campos não aparecerão no seletor de campos personalizados ao configurar um agente. Se um campo de data for alterado para incluir hora depois que um agente já tiver sido salvo com esse campo em uma ação, essa ação falhará em todas as execuções.

     • Alterar responsável: o agente atribuirá itens de trabalho a usuários com base no seu prompt. Os agentes podem ver atributos do perfil do usuário (cargo, departamento, país, fuso horário, quantidade de tarefas atribuídas) e pertencimento a grupos de usuários, permitindo atribuições por função, localização, departamento ou grupo. Os agentes não podem acessar dados de carga de trabalho ou capacidade além da contagem de tarefas.
     • Alterar nome do item de trabalho: o agente atualizará o título da tarefa ou projeto com base em sua análise.
     • Alterar status: o agente atualizará o status da tarefa com base nas condições que você definir. Funciona com fluxos de trabalho padrão e personalizados.

     • Selecionar registro de Link-to-Database: o agente pode alterar qual registro do banco de dados está selecionado em campos Link-to-Database. Use isto quando os agentes precisarem categorizar itens selecionando entre os registros do seu banco de dados.

       Nota

       Acesso ao contexto de Link-to-Database:

       • Ação Alterar campo L2DB: o agente pode pesquisar em todo o banco de dados. Pesquise por valor, não por nome de coluna.
       • Outras ações (Postar comentário, Alterar status etc.): o agente vê apenas o valor atualmente selecionado, não o banco de dados completo.

       Exemplo

       • ✅ “selecione o registro que contém o valor”
       • ❌ “selecione o registro onde o Nome da Coluna é valor”

     • Alterar data de início/vencimento: o agente pode modificar datas de início e vencimento em tarefas. Use isso para fluxos de gerenciamento de prazos, como adiar uma data de vencimento quando uma tarefa está bloqueada ou definir uma data de início com base em critérios de recebimento.

       Prompts de exemplo:

       • “Quando o status mudar para Bloqueado, adie a data de vencimento em 5 dias úteis.”
       • “Quando todos os campos obrigatórios estiverem preenchidos, defina a data de início para hoje.”

     • Localização: o agente pode mover ou adicionar itens de trabalho às pastas que você definir durante a configuração. Ao configurar essa ação, você incorpora chips de localização — referências estruturadas a pastas ou projetos específicos — diretamente no texto de instruções da ação. O agente analisa o item de trabalho e escolhe o destino apropriado entre esses chips.

       Dois modos estão disponíveis:

       • Mover para localização: Remove o item da pasta atual e o coloca exclusivamente na pasta de destino.
       • Adicionar à localização: Mantém o item na pasta atual e o adiciona a uma pasta adicional.

       Prompts de exemplo:

       • “Quando a descrição de uma tarefa mencionar jurídico, compliance ou regulamentação, mova-a para a pasta Legal Review.”

       • “Quando a prioridade estiver definida como Crítica, adicione a tarefa à pasta Urgent Queue para que ambas as equipes possam vê-la.”

         Importante

         O agente só pode mover itens para pastas que você referencia explicitamente como chips de local na instrução. Ele não pode mover itens para locais arbitrários nem criar novas pastas.

       • Iniciar ou gerenciar fluxo de aprovações: O agente cria novas aprovações em itens de trabalho ou atualiza aprovações de rascunho existentes. Você pode especificar aprovadores usando chips de usuário nas instruções da ação.

         Ações de aprovação suportadas:

         • Criar uma nova aprovação em um item de trabalho
         • Atualizar uma aprovação de rascunho existente
         • Adicionar ou remover aprovadores
         • Escolher o autor ou o responsável do item como aprovador
         • Especificar usuários individuais ou grupos de usuários como aprovadores por meio de chips de usuário

         Exemplos de prompts:

         • \"Quando o status mudar para Pronto para revisão, inicie uma aprovação com o proprietário do projeto como aprovador.\"
         • \"Quando o campo Budget ultrapassar 50.000, inicie uma aprovação com o grupo de usuários Finance Team.\"
       • Enviar e-mail (Gmail ou Outlook): O agente envia um e-mail por meio de uma conta OAuth conectada. Durante a configuração do agente, o administrador do espaço autentica uma conta do Gmail ou Outlook. O agente compõe o assunto, o corpo e os destinatários a partir do contexto do item de trabalho e das instruções da ação.

       • Escrevendo prompts de e-mail:

         Seu prompt deve instruir o agente sobre para quem enviar o e-mail. Seja explícito sobre de onde vem o endereço do destinatário.

         O agente pode obter endereços de e-mail de:

         • Endereço de e-mail principal do responsável (por exemplo, "enviar aos responsáveis pela tarefa")
         • Endereço de e-mail do autor (por exemplo, "notificar o autor")
         • Valores de campos personalizados que contenham endereços de e-mail
         • Título da tarefa ou texto da descrição contendo endereços de e-mail
         • Endereços explícitos no prompt (por exemplo, "enviar para intake@company.com")
         • Regras de composição (por exemplo, "nome + ponto + sobrenome + @contoso.com")

         O agente não pode obter endereços de e-mail de:

         • Seguidores
         • Endereços de e-mail secundários

         Assunto e corpo podem ser deixados em branco — o agente só os preencherá se o seu prompt instruí-lo a isso.

         Dica

         Tenha cuidado com prompts ambíguos. Um prompt como \"Atualizar responsáveis sobre o status do projeto\" pode ser interpretado como \"alterar os responsáveis\" em vez de \"enviar um e-mail de atualização aos responsáveis\". Use uma linguagem sem ambiguidades, como \"Envie um e-mail aos responsáveis resumindo o status do projeto.\"

         Exemplos de prompts:

         • "Quando o status mudar para Blocked, envie um e-mail para o responsável com um resumo do que está bloqueando a tarefa."
         • "Quando uma nova tarefa for criada na pasta Incoming, envie um e-mail para intake@company.com com o título e a descrição da tarefa."

         • "Envie um resumo semanal para o endereço de e-mail do autor com todas as subtarefas em atraso."

           Importante

           Uma única ação de e-mail pode atender a vários destinatários (múltipos endereços "Para"). Limitações de e-mail: sem campos CC/BCC, sem anexos, sem endereços de e-mail secundários, sem endereços de e-mail de seguidores. O remetente da mensagem exibe a conta conectada.

         • Notificar no Slack: O agente publica uma mensagem em um canal do Slack como uma ação. Durante a configuração do agente, um administrador de espaço conecta um workspace do Slack e seleciona um canal de destino usando um chip de canal do Slack. O canal de destino é definido durante a configuração — cada ação de Notificar no Slack publica em um único canal. O agente compõe apenas o corpo da mensagem, usando o contexto do item de trabalho e as instruções da ação.

           Importante

           As notificações do Slack exigem a conexão de um workspace do Slack nas configurações do agente. Somente administradores de espaço podem concluir a conexão. O aplicativo do Slack deve estar instalado em qualquer canal no qual o agente vá publicar. O aplicativo Wrike para Slack é aprovado pelo Slack Marketplace; se o seu workspace do Slack restringir a instalação de aplicativos de terceiros, o administrador do workspace poderá precisar aprovar previamente \"Wrike\" no diretório de aplicativos do Slack antes que a conexão possa ser concluída.

           Exemplos de prompts:

           • "Quando o status mudar para Blocked, publique uma mensagem no canal conectado resumindo o que está bloqueando a tarefa."
           • "Quando uma tarefa de alta prioridade for criada na pasta Incoming, publique no canal conectado o título da tarefa, o responsável e a descrição."

           Exemplo: um agente disparado por uma alteração de status para "Em Risco" agora pode publicar uma notificação no canal do Slack do projeto — mencionando a tarefa, o proprietário e o que está bloqueando — sem que ninguém precise mudar para o Wrike para verificar.

           Limitações das notificações do Slack: Um canal por ação (vários canais e mensagens diretas não são compatíveis na V1); sem respostas em threads ou preservação de contexto de thread; sem mencionar usuários do Slack.

         • Notificar no Microsoft Teams: o agente publica uma mensagem em um canal do Microsoft Teams como ação. Durante a configuração do agente, um administrador do espaço conecta uma conta do Microsoft Teams e seleciona um canal de destino. O canal de destino é definido durante a configuração — cada ação de Notificar-no-Teams publica em um canal; o agente não escolhe o canal em tempo de execução. O agente compõe apenas o corpo da mensagem, usando o contexto do item de trabalho e as instruções da ação. A mensagem é entregue pelo aplicativo Wrike Microsoft Teams e inclui um link de retorno para o item de trabalho no Wrike. O registro de atividades armazena o status de entrega com o nome do canal.

         Prompts de exemplo:

         • "Quando o status mudar para Blocked, publique uma mensagem no canal do Teams conectado resumindo o que está bloqueando a tarefa."
         • "Quando uma tarefa de alta prioridade for criada na pasta Incoming, publique no canal do Teams conectado com o título, o responsável e a descrição da tarefa."

               Limitações de notificações do Microsoft Teams: publica apenas em canais dentro de um team — ainda não há suporte para publicar em chats (DMs de grupo); sem @menções a usuários do Teams; sem mensagens em thread; um canal por ação.

   Escolha onde a atualização deve acontecer:

   • Item de trabalho onde o agente foi adicionado: A ação tem como alvo o item pai onde o agente está configurado.
   • Todos os subitens do item de trabalho onde o agente foi adicionado: A ação tem como alvo todos os itens filhos (máximo de 1.000 subitens por execução).
   • Item de trabalho onde o gatilho ocorreu: A ação tem como alvo o item específico que acionou o agente.
   • Subitens do item acionado: A ação tem como alvo os subitens do item específico que acionou o agente. Apenas filhos diretos (um nível abaixo do item acionado). Caso de uso: um blueprint cria um projeto com subtarefas em uma pasta de entrada; o agente atua somente nas subtarefas do novo projeto, não nas subtarefas de outros projetos.

   • Filtragem de itens de trabalho

     Filtre a quais itens a ação se aplica: cada ação possui um seletor de filtro — os mesmos controles de filtro que você usa em outras partes do Wrike. Você pode filtrar por tipo de item, status, responsável, campos personalizados, importância, nome ou qualquer combinação. Itens que não correspondem ao filtro são ignorados sem consumir créditos do agente.

     Isso é configurado por ação, portanto ações diferentes dentro do mesmo agente podem ter filtros diferentes. Por exemplo, uma ação pode ter como alvo apenas tarefas com status “New”, enquanto outra mira projetos concluídos.

   Dica

   Se o seu agente estiver atribuído a uma pasta que contenha projetos e tarefas, use um filtro para restringir as ações aos tipos de itens desejados.

   Nota

   Você pode adicionar várias ações clicando em + Ação, para que o agente execute diversas atualizações em uma única execução.

   Importante

   Como múltiplas ações funcionam

   • As ações são independentes - o resultado de uma ação não afeta as outras.
   • Não há uma ordem de execução garantida. Ação 1, Ação 2 e Ação 3 podem ser executadas em qualquer sequência, e podem rodar em paralelo. Trate cada ação como se ela pudesse ser executada primeiro.
   • Cada ação possui sua própria instrução e pode ter como alvo um local diferente (item pai, todos os subitens ou o item acionado).
   • A instrução geral é compartilhada por todas as ações, enquanto cada ação possui seu prompt específico.
   • Você pode nomear cada ação para facilitar a identificação na configuração e nos logs de atividade. Por exemplo, nomeie suas ações como “Definir Prioridade”, “Encaminhar para Equipe” e “Publicar Resumo” em vez de usar rótulos genéricos. Isso é especialmente útil quando um agente possui várias ações do mesmo tipo.

   O que isso significa para seus prompts:

   • Cada prompt de ação deve ser autônomo, funcionando a partir dos campos do item de trabalho, comentários, contexto pai ou chips de localização referenciados.
   • Não escreva frases como "Leia o comentário postado pela ação anterior", "Use o valor calculado na Ação 2" ou "Se a Ação 1 tiver êxito, então…". Não existe Ação 1 — há apenas ações, e qualquer uma delas pode ser executada primeiro.
   • Se duas ações precisarem do mesmo valor calculado (por exemplo, uma data de marco baseada na data de início do projeto e urgência), faça com que cada ação o calcule independentemente a partir da mesma fonte. Elas produzirão o mesmo resultado porque leem os mesmos dados.

   Se a Ação B realmente precisar da saída da Ação A, um único agente com várias ações não funcionará. Use encadeamento de agentes: o Agente 1 escreve um campo personalizado ou status; o Agente 2 é acionado por essa alteração e executa o próximo passo.

   Bons casos de uso para agentes com múltiplas ações:

   • Definir um campo de categoria E publicar um comentário de classificação (sem dependência)
   • Alterar responsável E atualizar status (sem dependência)
   • Atualizar vários campos personalizados simultaneamente

   Quando usar Alteração de Status:

   A alteração de status é ideal para a progressão automática do fluxo de trabalho:

   • Validação de entrada: Alterar o status para Ready quando todos os campos obrigatórios estiverem preenchidos.
   • Rastreamento de atrasos: Marcar tarefas como Overdue quando ultrapassarem a data de vencimento.
   • Detecção de dependências: Definir o status como Blocked quando dependências forem mencionadas em comentários.
   • Conclusão de projeto: Mover tarefas para Complete quando todas as subtarefas estiverem concluídas.

   Observações importantes sobre alterações de status:

   • Os agentes respeitam suas regras de transição de fluxo de trabalho e não podem pular status obrigatórios.
   • As alterações de status são registradas no histórico de atividade da tarefa com o raciocínio do agente.
   • Se o status já estiver correto, o agente cria apenas uma entrada de log (sem comentário duplicado).
   • Funciona com status padrão do Wrike e status de fluxos de trabalho personalizados.

   Exemplos de Prompts de Alteração de Status:

   • Marcar tarefas atrasadas:

     Quando uma tarefa ultrapassar sua data de conclusão e o status não for Completed, altere o status para Overdue.

   • Validar conclusão da entrada:

     Quando uma tarefa tiver os três campos obrigatórios preenchidos (Orçamento, Responsável, Prazo), altere o status de New para Ready for Work. Ignore tarefas já marcadas como Ready for Work ou Completed.

   • Detectar trabalho bloqueado:

     Quando comentários mencionarem "blocked", "waiting on" ou "dependency", e o status ainda não for Blocked ou Completed, altere o status para Blocked e publique um comentário resumindo o que está bloqueando a tarefa.

6. Teste sua configuração no Playground de Testes para ver como o agente raciocina e responde. Execuções no Playground não contam para seus limites de uso de IA, portanto você pode iterar livremente em prompts e configurações antes de implantar o agente.
7. Clique em Criar para ativar seu agente.

8. Atribua o agente a um local: Após criar o agente, você deve atribuí-lo à pasta, projeto ou tarefa específica onde ele deverá operar. Navegue até o local de destino e @mencione o agente no fluxo de comentários para ativá-lo ali. O agente monitorará e atuará somente dentro do seu escopo atribuído.

   Importante

   Criar um agente nas Configurações do Espaço não é suficiente — você também deve atribuí-lo a um local específico @mencionando-o. Sem essa etapa, o agente não ficará ativo.