Le variabili vengono utilizzate per archiviare e recuperare i dati della conversazione in fase di runtime. In questo modo, gli agenti possono ricordare le informazioni durante i turni di conversazione, il che porta a interazioni più contestuali.
Dati variabili
Le variabili contengono i seguenti dati:
- Nome: nome della variabile utilizzando la notazione snake case
- Tipo: tipo di variabile:
- Testo: valori stringa
- Numero: valori numerici
- Sì/No: valori booleani
- Oggetto personalizzato: fornisci uno schema per l'oggetto
- Elenco: elenco delle variabili. Fornisci i valori come elenco separato da virgole.
- Valore predefinito: valore predefinito per la variabile
- Descrizione: descrizione facoltativa della variabile
Riferimenti alle variabili nelle istruzioni
Per fare riferimento a una variabile per nome nelle istruzioni,
utilizza le parentesi graffe: {variable_name}.
Risoluzione delle variabili
Quando genera un prompt per il modello, CX Agent Studio sostituisce i riferimenti alle variabili con i valori di runtime effettivi.
Aggiornamento dei valori delle variabili
L'agente stesso non può aggiornare il valore di una variabile, ma strumenti e callback possono aggiornare i valori delle variabili.
Le variabili dell'agente utilizzano lo
stato del contesto dell'ADK,
che può essere utilizzato per aggiornare le variabili.
Una variabile globale denominata context è disponibile per l'utilizzo nel codice dello strumento Python.
Ad esempio,
puoi utilizzare la seguente istruzione in uno strumento Python per aggiornare una variabile
utilizzando le funzionalità dell'ADK:
context.state["variable_name"] = value