Una sessione rappresenta una conversazione tra un agente di agenti di conversazione (Dialogflow CX) e un utente finale. Crei una sessione all'inizio di una conversazione e utilizzarlo per ogni turno della conversazione. Al termine della conversazione, interrompi l'utilizzo della sessione.
Non utilizzare la stessa sessione per conversazioni simultanee con utenti finali diversi. Una sessione rimane attiva e i suoi dati archiviati per 30 minuti dopo l'invio dell'ultima richiesta per la sessione.
Ogni sessione è determinata in modo univoco da un ID sessione generato dal tuo sistema. Puoi creare una nuova sessione fornendo un nuovo ID sessione in una richiesta di rilevamento dell'intenzione e in altri metodi di sessione. Un ID sessione è una stringa di massimo 36 byte. Il sistema è responsabile della generazione di ID sessione univoci. Possono essere numeri casuali, identificatori dell'utente finale sottomessi ad hashing o qualsiasi altro valore che ti è comodo generare.
Controlla la regionalizzazione documentazione per informazioni sul valore ID località nel nome sessione.
Sessioni durature
Per impostazione predefinita, gli agenti conversazionali (Dialogflow CX) conservano i dati della sessione per 30 minuti. Esistono due modi per estendere la durata delle sessioni:
- (Opzione preferita) Imposta il TTL della sessione utilizzando
QueryParameters.session_ttl
. Il valore massimo consentito è 24 ore. Puoi ripristinare lo stato della sessione precedente impostando
QueryParameters.current_page
eQueryParameters.parameters
aDetectIntentRequest
.Un esempio di flusso di lavoro è il seguente:
- L'utente finale parla con l'agente nella sessione A.
- Il codice registra lo stato associato alla sessione A restituito nella risposta dell'API, ovvero
QueryResult.current_page
eQueryResult.parameters
. - L'utente finale smette di interagire con l'agente dopo 50 minuti.
- L'utente finale parla di nuovo con l'agente.
- Il codice invia l'input dell'utente finale, insieme a
QueryParameters.current_page
eQueryParameters.parameters
registrati in precedenza nella richiesta, per rilevare l'intenzione con lo stato della sessione precedente. Non è necessario utilizzare lo stesso ID sessione utilizzato dalla sessione A.
Riferimenti
Per informazioni sui prezzi delle sessioni, consulta pagina dei prezzi.
Per ulteriori informazioni sulle sessioni:
Seleziona un protocollo e una versione per il riferimento sessione:
Protocollo | V3 | V3beta1 |
---|---|---|
REST | Risorsa sessione | Risorsa sessione |
RPC | Interfaccia di sessione | Interfaccia di sessione |
C++ | SessionsClient | Non disponibile |
C# | SessionsClient | Non disponibile |
Vai | SessionsClient | Non disponibile |
Java | SessionsClient | SessionsClient |
Node.js | SessionsClient | SessionsClient |
PHP | Non disponibile | Non disponibile |
Python | SessionsClient | SessionsClient |
Ruby | Non disponibile | Non disponibile |