Come rivedere le istruzioni dell'Agente AI

Rivedi le istruzioni del tuo Agente AI per individuare problemi di configurazione prima di pubblicare o aggiornare l'Agente.

La revisione verifica le tue Istruzioni e le istruzioni delle azioni dell'Agente AI abilitate rispetto alla configurazione del Workspace. Può identificare riferimenti non validi, azioni configurate in modo errato, istruzioni non supportate, istruzioni in conflitto e altri problemi che possono influire sul funzionamento del tuo Agente AI.

Come rivedere il tuo Agente AI

1. Vai a Agenti AI.

2. Crea un nuovo Agente AI o seleziona uno esistente da modificare.

3. Fai clic su Rivedi.

4. Attendi che la revisione sia completata.

5. Se vengono rilevati problemi, seleziona Rivedi problemi per visualizzarli.

Puoi esaminare i problemi e le correzioni suggerite prima di apportare modifiche al tuo Agente AI.

Cosa verifica la revisione

La revisione controlla diverse parti della configurazione del tuo Agente AI.

Riferimenti e token

La revisione verifica che gli elementi del Workspace referenziati nelle tue istruzioni esistano e siano usati correttamente.

Questo include:

• Campi del contatto:$FieldName

• Workflow: !WorkflowName

• Utenti e team: @UserName e @TeamName

• Tag: %TagName

Ad esempio, potrebbe essere rilevato un problema se le tue istruzioni fanno riferimento a un Campo del contatto o a un Tag che non esiste più.

Per i Campi del contatto, la revisione può anche rilevare quando il valore di un campo è usato senza sufficiente contesto affinché l'Agente AI capisca cosa rappresenta.

Azioni dell'Agente AI

La revisione verifica se le azioni dell'Agente AI descritte nelle tue istruzioni corrispondono alle azioni configurate per l'Agente AI.

Possono essere rilevati problemi quando:

• Le tue istruzioni fanno riferimento a un'azione che non è abilitata.

• Un'azione abilitata, a cui fanno riferimento le tue istruzioni, non ha istruzioni associate.

• Le tue istruzioni fanno riferimento a un'azione che non è disponibile.

• Un'Azione utilizza una destinazione non valida, come ad esempio un

  Un'azione Assegna ad agente o team senza destinazione oppure un'azione Aggiungi commento che menziona un team o un Agente AI invece di un utente.

• Le tue istruzioni si contraddicono su quando o come dovrebbe essere utilizzata un'azione.

Per saperne di più su come configurare e usare le azioni dell'Agente AI. La guida esistente sulle azioni spiega già il comportamento delle azioni, come l'esecuzione delle azioni prima delle risposte e la necessità di usare esattamente i nomi degli elementi del Workspace.

Istruzioni non supportate

La revisione può rilevare istruzioni che chiedono all'Agente AI di eseguire attività non supportate.

Per esempio:

• Lettura dei Tag esistenti di un contatto.

• Lettura dei commenti interni.

• Trovare informazioni in una Knowledge Source basandosi sul titolo del documento invece che sul suo contenuto.

• Invio di tipi di allegati non supportati come video, note vocali o sticker.

Per maggiori informazioni su ciò a cui gli Agenti AI possono e non possono accedere, consulta Agenti AI: limitazioni note e soluzioni alternative.

Istruzioni di follow-up e limiti

La revisione verifica se le tue istruzioni rientrano nei limiti supportati dall'Agente AI.

Possono essere rilevati problemi per:

• Più di 5 passaggi di follow-up.

• Un follow-up programmato a più di 24 ore dal messaggio precedente.

• Ramificazioni o più sequenze di follow-up parallele.

• Istruzioni che chiedono all'Agente AI di fare riferimento a più dei ultimi 20 messaggi in una conversazione.

Chiarezza e coerenza delle istruzioni

La revisione verifica anche se le tue istruzioni forniscono un flusso chiaro e coerente che l'Agente AI possa seguire.

Può identificare:

• Istruzioni in conflitto per la stessa situazione.

• Un obiettivo mancante o poco chiaro.

• Nessuna condizione di uscita chiara.

• Istruzioni che non hanno abbastanza struttura per il flusso previsto.

Per indicazioni su come strutturare le tue istruzioni, consulta Come scrivere prompt efficaci per Agenti AI.

Rivedi e risolvi i problemi

Quando vengono rilevati problemi, seleziona Rivedi per vederli più nel dettaglio.

I problemi sono raggruppati in base a dove compaiono, ad esempio nelle tue principali Istruzioni o in una singola Azione.

Per i problemi con una correzione suggerita:

1. Seleziona i problemi che vuoi correggere.

2. Esamina le modifiche suggerite.

3. Seleziona Applica correzioni.

4. Controlla le modifiche proposte prima di confermarle.

Le tue istruzioni non vengono modificate finché non confermi le correzioni. Dopo l'applicazione delle correzioni, le istruzioni vengono riesaminate per eventuali problemi restanti.

Ignora un problema

Seleziona Ignora se non vuoi affrontare un problema durante la revisione corrente.

Ignorare un problema:

• Lo rimuove dall'elenco corrente dei problemi aperti.

• Non modifica le istruzioni del tuo Agente AI.

• Non segna il problema come risolto in modo permanente.

I problemi ignorati vengono cancellati quando esegui una nuova revisione, quindi un problema può riapparire se viene ancora rilevato.