1. All Collections >
  2. Prodotto >
  3. Agenti di intelligenza artificiale >
  4. Come rivedere le istruzioni dell'Agente AI

Come rivedere le istruzioni dell'Agente AI

Avatar
Shing-Yi Tan
3 min di lettura

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

La revisione confronta le tue Istruzioni e le AIistruzioni delle skill abilitate con la configurazione del tuo spazio di lavoro. Può identificare riferimenti non validi, skill AI 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 Pubblica (se l'agente non è ancora pubblicato) o su Salva (se è già pubblicato) — questo avvierà automaticamente la revisione delle tue istruzioni.

  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.

Skill AI

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

Possono essere rilevati problemi quando:

  • Le tue istruzioni fanno riferimento a una skill che non è abilitata.

  • Una skill abilitata, a cui fanno riferimento le tue istruzioni, non ha istruzioni associate.

  • Le tue istruzioni fanno riferimento a una skill che non è disponibile.

  • Una skill AI utilizza una destinazione non valida, come ad esempio un

Una skill Assegna ad agente o team senza destinazione oppure una skill 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 una skill.

Scopri di più su come configurare e usare le skill dell'Agente AI. La guida esistente sulle skill spiega già il comportamento delle skill, ad esempio l'esecuzione delle skill prima delle risposte e la necessità di usare esattamente i nomi degli elementi dello spazio di lavoro.

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.

  • Fare riferimento a una sorgente di conoscenza tramite il nome del file, come refund.pdf, invece che al nome visualizzato.

  • 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 30 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.

FAQ e risoluzione dei problemi

La revisione modifica automaticamente le istruzioni del tuo Agente AI?

No. La revisione individua i problemi e può suggerire correzioni, ma le tue istruzioni non vengono modificate finché non esamini e confermi le modifiche proposte.

La revisione testa come il tuo Agente AI risponde ai contatti?

No. La revisione controlla le istruzioni e la configurazione del tuo Agente AI. Non testa conversazioni in tempo reale né il comportamento effettivo in fase di esecuzione.

La revisione controlla il contenuto della tua Knowledge Source?

No. La revisione non legge il contenuto delle tue fonti di conoscenza. Controlla invece le istruzioni dell'Agente AI, le istruzioni della skill AI e la configurazione rilevante dello spazio di lavoro.

La revisione verifica se un Workflow è pubblicato?

No. La revisione può verificare se il Workflow referenziato esiste, ma non controlla se quel Workflow sia pubblicato.

Condividi questo articolo
Telegram
Facebook
Linkedin
Twitter

Non riesci a trovare quello che stai cercando? 🔎