Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]
La memoria permette a un agente alimentato dall'imbracatura Customer Conversation di trasportare il contesto approvato dalle conversazioni precedenti nella successiva, così un cliente di ritorno viene ricevuto con continuità invece che con un avvio a freddo. L'agente può riconoscere intenti aperti, ricordare ciò che è stato discusso e riprendere da dove si è conclusa l'ultima conversazione.
La memoria per gli agenti alimentati dal Customer Conversation harness è una capacità distinta rispetto a Memory (preview), che si applica agli agenti alimentati dal GitHub Copilot harness. Invece del richiamo libero, la memoria Customer Conversation sfrutta il contesto strutturato attraverso uno schema definito di parametri integrati e personalizzati, e copre solo il contesto di conversazione a breve termine, con un periodo di conservazione di 30 giorni.
La memoria viene configurata una volta a livello di agente e si applica all'agente radice e a ogni agente figlio sottostante. Funziona sia nelle conversazioni vocali che in quelle di chat e, quando un identificatore di contatto condiviso è configurato, il contesto registrato in un canale è disponibile nell'altro.
Cosa ricorda il tuo agente
Tipi di contesto integrati
Due tipi di contesto integrati sono attivi ogni volta che la Memoria è attivata. Ognuno ha uno schema definito, quindi puoi fare riferimento ai suoi valori nelle istruzioni senza ulteriori configurazioni.
| Tipo di contesto | Variables | Cosa acquisisce |
|---|---|---|
| Profilo del cliente | /customerName |
Dettagli dei clienti catturati durante le conversazioni, usati per personalizzare le interazioni future. |
| Cronologia della conversazione |
/pastOpenIntentList, /pastConversationSummary |
Dettagli chiave delle conversazioni passate, come intenti aperti e un riassunto, sono stati portati nelle interazioni future. |
Parametri personalizzati
Oltre ai tipi integrati, puoi definire parametri per i dettagli da cui dipende la tua azienda, come un livello di membership, un'azione di servizio richiesta o un flag che guida il routing. Ogni parametro personalizzato è definito da:
- Un nome univoco.
- Un tipo di dato di stringa, numero o booleano.
- Una descrizione in modo semplice che dice all'agente cosa cercare. La descrizione fa la maggior parte del lavoro, quindi scrivila come un'istruzione esplicita piuttosto che come un'etichetta.
- L'insieme di valori che il parametro può mantenere.
I seguenti limiti si applicano quando crei o modifichi un parametro personalizzato:
| Impostazione | Requirement |
|---|---|
| Name | Unico all'interno dell'agente. Gli spazi vengono accettati e rimossi automaticamente quando il nome viene usato come variabile. |
| Tipo di dati | Stringa, numero o booleana. |
| Description | Required. Tra i 30 e i 300 caratteri. |
| Valori consentiti | Required. Fino a 10 valori, ciascuno fino a 30 caratteri. |
| Numero di parametri | Fino a 5 parametri personalizzati. |
Scegliere come aggiornare un valore
Ogni parametro personalizzato utilizza una delle due modalità di consolidamento, che determinano come un valore appena estratto si fonde con la memoria già presente per quel parametro tra le conversazioni. Scegli la modalità quando crei il parametro.
- Sostituisci: Valori di Suit con una sola verità attuale, come un livello di iscrizione o una segnalazione di frode. Ogni nuovo valore estratto sovrascrive quello memorizzato, e viene mantenuto solo il valore più recente. Se una conversazione non produce nuovo valore, il valore precedentemente memorizzato rimane al suo posto invece di essere eliminato.
- Append: Adatto a valori che si accumulano, come le azioni di servizio richieste da un cliente. Ogni estrazione viene aggiunta a una lista corrente come una voce con timestamp a sé stante, e i valori ripetuti vengono mantenuti separatamente affinché la sequenza rimanga accurata. L'agente legge la voce più recente per un dato valore come lo stato attuale. Se una conversazione non produce nuovo valore, la lista rimane invariata e le voci vengono potate man mano che invecchiano oltre la finestra di conservazione, così le liste non crescono senza limiti.
Attivare o disattivare la memoria
Un singolo controllo a livello di agente attiva o disattiva la Memoria. Governa tutto: generare contesto, memorizzarlo, recuperarlo, risolvere le variabili di memoria nelle istruzioni e far emergere il contesto agli agenti umani. L'impostazione copre l'agente root e tutti i suoi agenti figli, e la sua modifica viene confermata prima che entri in gioco.
Quando la memoria è disattiva, nessun contesto viene generato, memorizzato, recuperato o riferito in nessuna parte dell'agente. Riattivandolo riprende il comportamento normale per le nuove conversazioni; il contesto precedentemente memorizzato torna disponibile solo se è ancora nella finestra di conservazione.
Istruzioni per l'autore con variabili di memoria
Fai riferimento direttamente ai parametri integrati e personalizzati nelle istruzioni dell'agente. I riferimenti ai parametri di sistema hanno un aspetto simile a pastOpenIntentList e pastConversationSummary.
Continuità tra canali
Il contesto è associato a un identificatore specifico per il canale, come il numero di telefono del chiamante per la voce e un identificatore di sessione autenticato per la chat web. Da solo, questo mantiene separata la memoria di ogni canale.
La configurazione di un identificativo di contatto condiviso associa le identità di quei canali a un unico cliente, in modo che il contesto registrato durante una chiamata telefonica sia disponibile nella chat successiva del cliente, e viceversa. Il contesto viene rilasciato solo una volta che il cliente è stato identificato: i canali di chat autenticano prima l'utente e la voce si basa sul numero di telefono del chiamante.
Questo significa che un cliente che interagisce con il tuo agente su un canale può continuare la stessa conversazione su un canale diverso, e l'agente mantiene il contesto rilevante, incluse preferenze o dettagli condivisi in precedenza, come un metodo di contatto preferito o un identificatore di account.
Come per ogni contesto di Memoria, ogni agente mantiene un archivio di memoria separato per ogni utente, quindi il contesto e le preferenze di un cliente non vengono mai condivisi con un altro.