Riferimento alle azioni degli agenti AI

TL;DR

Gli agenti AI di Wrike eseguono azioni quando vengono attivati: pubblicano commenti, aggiornano campi, modificano assegnatari/stato/date, spostano elementi, inviano email o inviano notifiche tramite Slack/Teams. Puoi aggiungere più azioni per ogni agente (eseguite in ordine), filtrare gli elementi su cui agiscono e definire le destinazioni.

• Panoramica
• Tabella delle azioni
• Regole di scrittura dei campi personalizzati
• Dettagli delle azioni ed esempi di prompt
• Destinazione dell'azione
• Filtraggio degli elementi di lavoro
• Azioni multiple
• Quando utilizzare il cambio di stato
• Cosa succede dopo?

Panoramica

Le azioni definiscono cosa fa un agente AI quando viene attivato. Puoi aggiungere più azioni per ogni agente.

Tabella delle azioni

Regole di scrittura dei campi personalizzati

Gli agenti AI possono aggiornare questi tipi di campi personalizzati: Testo, Selezione singola, Selezione multipla, Numero, Percentuale, Valuta, Link to Database, Casella di controllo, Data, Durata e Persone.

• Sola lettura (non modificabili): campi Mirror e campi Calcolati/Formule (leggibili come contesto). 
• I campi Data che includono un componente orario (funzionalità di Wrike Labs) non sono supportati nelle azioni degli agenti AI e non verranno visualizzati nel selettore dei campi. Se un campo Data viene modificato per includere l'ora dopo che un agente è stato salvato con quel campo, l'azione non riuscirà a ogni esecuzione.

Dettagli delle azioni ed esempi di prompt

Modifica assegnatario - Gli agenti AI possono vedere gli attributi del profilo utente (titolo professionale, reparto, paese, fuso orario, numero di attività assegnate) e l'appartenenza ai gruppi. Gli agenti non possono accedere ai dati di carico di lavoro o capacità oltre al conteggio delle attività. (Vedi Assegnare elementi di lavoro con gli agenti AI.)

Seleziona il record Link-to-Database:

• Azione Cambia campo L2DB: l'agente AI può cercare in tutto il database. Cerca per valore, non per nome della colonna.
• Altre azioni: l'agente AI vede solo il valore attualmente selezionato.

✅ \"seleziona il record che contiene il valore\"
❌ \"seleziona il record dove Nome colonna è valore\"

Modifica data di inizio/scadenza - esempi di prompt:

• \"Quando lo stato cambia in Blocked, posticipa la data di scadenza di 5 giorni lavorativi.\"
• \"Quando tutti i campi obbligatori sono compilati, imposta la data di inizio a oggi.\"

Posizione - due modalità:

• Sposta nella posizione: rimuove l'elemento dalla cartella corrente e lo inserisce esclusivamente nella destinazione.
• Aggiungi alla posizione: mantiene l'elemento nella cartella corrente e lo aggiunge a una cartella aggiuntiva.

Esempi di prompt:

• \"Quando la descrizione di un'attività menziona legal, compliance o regulatory, spostala nella cartella Legal Review.\"
• \"Quando la Priorità è impostata su Critical, aggiungi l'attività alla cartella Urgent Queue.\"

Importante: Gli agenti AI possono spostare elementi solo nelle cartelle che fai riferimento esplicito come chip di posizione. Non possono spostare elementi in posizioni arbitrarie né creare nuove cartelle.

Avvia o gestisci il flusso di approvazione - azioni supportate: crea approvazione, aggiorna bozza di approvazione, aggiungi/rimuovi responsabili dell'approvazione, scegli autore o assegnatario come responsabile dell'approvazione, specifica utenti/gruppi tramite chip utente.

Esempi di prompt:

• \"Quando lo stato cambia in Ready for Review, avvia un'approvazione con il proprietario del progetto come responsabile dell'approvazione.\"
• \"Quando il campo Budget supera 50.000, avvia un'approvazione con il gruppo utenti Finance Team.\"

Invia email - Durante la configurazione, l'amministratore dello spazio autentica un account Gmail o Outlook.

L'agente AI può ricavare indirizzi da: email primaria dell'assegnatario, email dell'autore, valori dei campi personalizzati, testo del titolo/descrizione dell'attività, indirizzi espliciti, regole di composizione (es. \"nome + punto + cognome + @contoso.com\").

L'agente AI non può ottenere indirizzi da: follower, indirizzi email secondari.

Suggerimento: Usa un linguaggio non ambiguo come \"Invia un'email agli assegnatari riassumendo lo stato del progetto\" invece di \"Aggiorna gli assegnatari sullo stato del progetto\".

Importante: Una singola azione email può indirizzare più destinatari "A". Niente CC/BCC, nessun allegato, nessuna email secondaria, nessuna email ai follower. Il mittente mostra l'account connesso.

Notifica su Slack - Un amministratore dello spazio collega un workspace Slack e seleziona un canale tramite un chip; il canale è fissato in fase di configurazione.

Importante: Richiede il collegamento di un workspace Slack. L'app Slack deve essere installata in tutti i canali di destinazione. L'app Wrike per Slack è approvata dal Marketplace; i workspace con restrizioni possono richiedere l'approvazione preventiva di un amministratore.

Limitazioni: un solo canale per azione; nessuna risposta in thread; nessun @mention degli utenti Slack.

Notifica su Microsoft Teams - Un amministratore dello spazio collega un account Teams e seleziona un canale; fissato in fase di configurazione. I messaggi includono un link all'elemento di lavoro; il registro attività registra lo stato di consegna.

Limitazioni: solo canali all'interno di un team (niente DM di gruppo); nessun @mention; nessun messaggio in thread; un canale per azione.

Destinazione dell'azione

Scegli dove deve avvenire l'aggiornamento:

Filtraggio degli elementi di lavoro

Ogni azione dispone di un selettore di filtro: filtra per tipo di elemento, stato, assegnatario, campi personalizzati, importanza, nome o qualsiasi combinazione. Gli elementi che non corrispondono vengono ignorati senza consumare crediti dell'agente. Configurato per azione.

Suggerimento: Se il tuo agente AI è assegnato a una cartella con progetti e attività, usa un filtro per limitare le azioni ai tipi di elementi di tuo interesse.

Azioni multiple

Come funzionano le azioni multiple:

• Le azioni sono indipendenti: il risultato di un'azione non influisce sulle altre.
• Ordine di esecuzione garantito: le azioni ora vengono eseguite nell'ordine esatto in cui le configuri. Poiché l'esecuzione è sequenziale, l'Azione B può leggere ciò che ha scritto l'Azione A. Trascina e rilascia le azioni per impostarne l'ordine nel builder.
• Ogni azione ha le proprie istruzioni e destinazione; l'istruzione Generale è condivisa.
• Assegna un nome a ogni azione per facilitarne l'identificazione nella configurazione e nei log (es. \"Imposta priorità\", \"Instrada al team\", \"Pubblica riepilogo\").

Cosa significa per i tuoi prompt:

• Ogni prompt di azione deve essere autonomo.
• Non scrivere \"Leggi il commento pubblicato dall'azione precedente\" o \"Se l'azione 1 è riuscita…\".
• Se due azioni necessitano dello stesso valore, fai sì che ognuna lo calcoli indipendentemente dalla stessa fonte.
• Se l'Azione B ha davvero bisogno dell'output dell'Azione A → usa il collegamento tra agenti (vedi Scrivere prompt efficaci per gli agenti).

Buoni casi d'uso multi-azione: impostare un campo categoria E pubblicare un commento; cambiare l'assegnatario E aggiornare lo stato; aggiornare più campi personalizzati contemporaneamente.

Quando utilizzare il cambio di stato

• Validazione di intake: passa a Ready quando tutti i campi obbligatori sono compilati.
• Monitoraggio scadenze: contrassegna come Overdue quando si supera la data di scadenza.
• Rilevamento dipendenze: imposta Blocked quando vengono menzionate dipendenze.
• Completamento progetto: passa a Complete quando tutte le sottoattività sono concluse.

Note: Gli agenti rispettano le regole di transizione del flusso di lavoro e non possono saltare gli stati obbligatori. Le modifiche vengono registrate con la motivazione. Se lo stato è già corretto, viene creatata solo una voce di log. Funziona con flussi di lavoro standard e personalizzati.

Esempi di prompt sullo stato:

• \"Quando un'attività supera la sua data di scadenza e lo stato non è Completed, cambia lo stato in Overdue.\"
• \"Quando un'attività ha tutti e tre i campi obbligatori compilati

Cosa succede dopo?

• Assegnare elementi di lavoro con gli agenti AI