Referência de ações do agente de IA

TL;DR

Os agentes de IA do Wrike executam ações quando disparados — publicam comentários, atualizam campos, alteram responsáveis/status/datas, movem itens, enviam e-mails ou enviam notificações via Slack/Teams. Você pode adicionar várias ações por agente (executadas em ordem), filtrar quais itens elas afetam e definir locais de destino.

• Visão geral
• Tabela de ações
• Regras de gravação de campos personalizados
• Detalhes da ação e exemplos de prompts
• Local de destino da ação
• Filtragem de itens de trabalho
• Ações múltiplas
• Quando usar a mudança de status
• O que vem a seguir?

Visão geral

As ações definem o que um agente de IA faz quando é acionado. Você pode adicionar várias ações por agente.

Tabela de ações

Regras de gravação de campos personalizados

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, Duração e Pessoas.

• Somente leitura (não podem ser escritos): campos espelhados e campos calculados/de fórmula (legíveis como contexto). 
• Campos de data que incluem um componente de horário (Wrike Labs recurso) não são compatíveis com ações de agentes de IA e não aparecem no seletor de campos. Se um campo de data passar a incluir horário após o agente ter sido salvo com esse campo, a ação falhará em todas as execuções.

Detalhes da ação e exemplos de prompts

Alterar responsável – Os agentes de IA podem ver atributos do perfil do usuário (cargo, departamento, país, fuso horário, quantidade de tarefas atribuídas) e participação em grupos. Os agentes não têm acesso a dados de carga de trabalho ou capacidade além da contagem de tarefas. (Veja Atribuir itens de trabalho com agentes de IA.)

Selecionar Link-to-Database registro:

• Ação Alterar campo L2DB: o agente de IA pode pesquisar em todo o banco de dados. Pesquise pelo valor, não pelo nome da coluna.
• Outras ações: o agente de IA vê apenas o valor atualmente selecionado.

✅ "selecionar o registro que contenha o valor"
❌ "selecionar o registro onde Nome da coluna é valor"

Alterar data de início/vencimento - 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 - dois modos:

• 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 da tarefa mencionar jurídico, compliance ou regulamentação, mova-a para a pasta Revisão Jurídica."
• "Quando a Prioridade for definida como Crítica, adicione a tarefa à pasta Fila Urgente."

Importante: Os agentes de IA só podem mover itens para pastas que você referencie explicitamente como chips de localização. Eles não podem mover itens para locais arbitrários nem criar novas pastas.

Iniciar ou gerenciar fluxo de aprovação - ações compatíveis: criar aprovação, atualizar aprovação em rascunho, adicionar/remover aprovadores, escolher autor ou responsável como aprovador, especificar usuários/grupos por meio de chips de usuário.

Prompts de exemplo:

• "Quando o status mudar para Pronto para revisão, inicie uma aprovação com o proprietário do projeto como aprovador."
• "Quando o campo Orçamento exceder 50.000, inicie uma aprovação com o grupo de usuários Equipe Financeira."

Enviar e-mail – Durante a configuração, o administrador do espaço autentica uma conta Gmail ou Outlook.

O agente de IA pode derivar endereços de: e-mail principal do responsável, e-mail do autor, valores de campos personalizados, texto do título/descrição da tarefa, endereços explícitos, regras de composição (por exemplo, "primeiroNome + ponto + sobrenome + @contoso.com").

O agente de IA não pode obter endereços de: seguidores, endereços de e-mail secundários.

Dica: Use uma linguagem inequívoca, como "Enviar um e-mail aos responsáveis resumindo o status do projeto" em vez de "Atualizar os responsáveis sobre o status do projeto."

Importante: Uma única ação de e-mail pode ter vários destinatários no campo "Para". Sem CC/BCC, sem anexos, sem e-mails secundários, sem e-mails de seguidores. O remetente exibe a conta conectada.

Notificar no Slack – Um administrador do Space conecta um workspace do Slack e seleciona um canal por meio de um chip; o canal é fixado durante a configuração.

Importante: É necessário conectar um workspace do Slack. O aplicativo do Slack deve estar instalado em qualquer canal de destino. O aplicativo do Wrike para Slack é aprovado pelo Marketplace; workspaces restritos podem exigir pré-aprovação do administrador.

Limitações: um canal por ação; sem respostas em thread; sem @menções a usuários do Slack.

Notificar no Microsoft Teams – Um administrador do espaço conecta uma conta do Teams e seleciona um canal; o canal é fixo durante a configuração. As mensagens incluem um link de volta para o item de trabalho; o log de atividades registra o status de entrega.

Limitações: somente canais dentro de uma equipe (sem DMs em grupo); sem @menções; sem mensagens em thread; um canal por ação.

Local de destino da ação

Escolha onde a atualização deve ocorrer:

Filtragem de itens de trabalho

Cada ação possui um seletor de filtro — filtre por tipo de item, status, responsável, campos personalizados, importância, nome ou qualquer combinação. Itens que não correspondem são ignorados sem consumir créditos do agente. Configurado por ação.

Dica: Se o seu agente de IA estiver atribuído a uma pasta com projetos e tarefas, use um filtro para restringir as ações aos tipos de item que importam para você.

Ações múltiplas

Como as ações múltiplas funcionam:

• As ações são independentes — o resultado de uma ação não afeta as demais.
• Ordem de execução garantida — As ações agora são executadas exatamente na ordem em que você as configurar. Como a execução é sequencial, a Ação B pode ler o que a Ação A escreveu. Basta arrastar e soltar as ações para definir a ordem delas no construtor.
• Cada ação tem sua própria instrução e destino; a instrução geral é compartilhada.
• Nomeie cada ação para facilitar a identificação na configuração e nos logs (por exemplo, "Definir prioridade", "Roteamento para equipe", "Publicar resumo").

O que isso significa para seus prompts:

• Cada prompt de ação deve ser independente.
• Não escreva "Leia o comentário publicado pela ação anterior" ou "Se a Ação 1 foi bem-sucedida…".
• Se duas ações precisarem do mesmo valor, faça com que cada uma o calcule independentemente a partir da mesma fonte.
• Se a Ação B realmente precisar da saída da Ação A → use encadeamento de agentes (veja Escrever prompts de agentes eficazes).

Bons casos de uso de múltiplas ações: definir um campo de categoria E publicar um comentário; alterar responsável E atualizar status; atualizar vários campos personalizados simultaneamente.

Quando usar a mudança de status

• Validação de intake: Mude para Pronto quando todos os campos obrigatórios estiverem completos.
• Rastreamento de atraso: Marque como Atrasado quando passar da data de vencimento.
• Detecção de dependência: Defina Bloqueado quando dependências forem mencionadas.
• Conclusão do projeto: Mova para Concluído quando todas as subtarefas estiverem finalizadas.

Observações: Os agentes respeitam as regras de transição do fluxo de trabalho e não podem pular status obrigatórios. As alterações são registradas com justificativa. Se o status já estiver correto, apenas uma entrada de log é criada. Funciona com fluxos de trabalho padrão e personalizados.

Prompts de status de exemplo:

• "Quando uma tarefa ultrapassar a data de vencimento e o status não for Concluído, altere o status para Atrasado."
• "Quando uma tarefa tiver os três campos obrigatórios preenchidos

O que vem a seguir?

• Atribuir itens de trabalho com agentes de IA