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

TL;DR

Os agentes de IA automatizam atualizações de itens de trabalho, criação, aprovações, atribuições e notificações. As ações são executadas sequencialmente com filtros e destinos configuráveis. Integrações e atualizações de campos possuem limites específicos, e fluxos de trabalho atrasados exigem vários agentes.

• Visão geral
• Tabela de ações
• Regras de gravação de campos personalizados
• Criar itens com a ação Criar item
  • Formatar descrições de itens
  • Criar um item com base em um blueprint
• Pausar fluxos de trabalho com automações de vários agentes
• 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 admin de espaço conecta uma conta do Teams e seleciona o destino — que pode ser um canal, um chat 1:1 existente ou um chat em grupo existente — definido no momento da configuração. Uma única ação também pode publicar simultaneamente em um chat e em um canal. As mensagens incluem um link de retorno ao item de trabalho.

Limitações e capacidades:

• Destinos com suporte:
  • Canais (dentro de uma equipe por vez): é possível direcionar vários canais dentro de uma única equipe. Para publicar em canais de equipes diferentes, adicione uma ação separada para cada equipe.
  • Chats 1:1 existentes
  • Chats em grupo existentes
• Não compatível: criar novos chats, chats de reunião, publicar em vários chats e canais com uma única ação, respostas em tópicos, @menções e formatação avançada além do markdown básico do Teams.
• Detalhes da mensagem: as mensagens sempre incluem um link para o item de trabalho.

Local de destino da ação

Escolha onde a atualização deve ocorrer:

Criar itens com a ação Criar item

Use a ação Criar item 1 para criar um item (tarefa, projeto ou pasta) 2 sempre que o agente for acionado. Para criar um item a partir de um blueprint, selecione Criar item a partir de blueprint (localizado logo abaixo desta ação).

Formatar descrições de itens

A ação oferece suporte a descrições em rich text, incluindo:

• Cabeçalhos
• Listas de verificação
• Listas com marcadores e numeradas
• Cores de texto

Limitações: alinhamento de texto e tamanhos de fonte personalizados não são compatíveis. 

Prompts de exemplo:

• “Quando uma solicitação for enviada, crie um projeto com um cabeçalho de resumo e uma lista de verificação dos próximos passos.”
• “Quando chegar uma nova solicitação de campanha, crie uma tarefa com uma lista numerada das ações necessárias.”

Criar um item com base em um blueprint

1. Adicione a ação Criar item a partir de blueprint 1 durante a configuração do agente.
2. Abra o seletor de blueprint 2.
3. Selecione o blueprint que você quer que o agente use 3.
4. Adicione instruções que indiquem ao agente quando criar o item 4.
5. Selecione onde esse item deve ser criado 5.
6. Salvar 6 o agente.

O agente cria um item por gatilho e inclui todas as subtarefas do blueprint selecionado.

Prompt de exemplo:

“Quando uma solicitação for enviada, crie um projeto a partir do blueprint ‘Client Onboarding’."

Pausar fluxos de trabalho com automações de vários agentes

Em processos de human-in-the-loop, os fluxos de trabalho automatizados geralmente precisam pausar para que os membros da equipe tenham tempo de fornecer detalhes ausentes antes de prosseguir. Embora um único agente personalizado não possa pausar no meio da execução e retomar mais tarde na mesma sessão, é possível alcançar essa lógica combinando um agente acionado por evento com um agente de acompanhamento agendado.

Entendendo as capacidades dos agentes

• O que os agentes podem fazer: reagir imediatamente a atualizações (como alterações de campos) ou executar tarefas em um cronograma baseado em tempo definido.
• O que os agentes não podem fazer: pausar no meio da execução, manter estado ativo durante um atraso e retomar automaticamente dentro de uma única execução.

Abordagem alternativa: automação com vários agentes

Para reproduzir um fluxo de trabalho pausado, configure dois agentes para trabalhar juntos:

1. Agente baseado em gatilho: reage assim que um usuário preenche o campo personalizado obrigatório, permitindo que o fluxo de trabalho principal continue imediatamente.
2. Agente de verificação agendada: é executado após um período especificado (por exemplo, 1 hora após a criação do item). Se o campo obrigatório ainda estiver vazio, esse agente atualizará o status do item automaticamente.

Lista de verificação de configuração

Antes de configurar seus agentes, defina os seguintes elementos:

• Campo obrigatório: o campo personalizado que deve conter dados.
• Duração da espera: o intervalo de tempo a aguardar antes de executar a verificação agendada. Como não há elementos dedicados na interface para essa configuração, especifique todos os elementos relevantes e detalhes de tempo diretamente nas instruções da ação.
• Ação de sucesso: a etapa ou gatilho que será executado se o campo for preenchido a tempo.
• Ação de tempo esgotado: a alteração de status a ser aplicada se o campo permanecer vazio após a duração de espera.

Resultado

Embora essa configuração use dois gatilhos separados em vez de uma única execução pausada, ela automatiza com sucesso os atrasos de human-in-the-loop mantendo a precisão dos dados.

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 que contenha projetos e tarefas, aplique um filtro para limitar suas ações aos tipos de item relevantes. Uso típico: filtrar itens concluídos para evitar desperdiçar ações do agente neles.

Ações múltiplas

Como as ações múltiplas funcionam:

• As ações são independentes — por padrão, 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