Una sessione rappresenta una conversazione tra un agente Dialogflow e un utente finale. Crei una sessione all'inizio di una conversazione e la utilizzi a ogni suo turno. Al termine della conversazione, smetti di usare la sessione.
Non usare 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 da un ID sessione generato dal sistema. Puoi creare una nuova sessione fornendo un nuovo ID sessione in una richiesta di rilevamento di intent e in altri metodi di sessione. Un ID sessione è una stringa di massimo 36 byte. La generazione di ID sessione univoci è responsabilità del sistema. Possono essere numeri casuali, identificatori dell'utente finale sottoposti ad hashing o qualsiasi altro valore che puoi generare.
Consulta la documentazione relativa alla regionalizzazione per informazioni sul valore ID località nel nome della sessione.
Sessioni di lunga durata
Per impostazione predefinita, Dialogflow conserva i dati delle sessioni 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
inDetectIntentRequest
.Ecco un esempio di flusso di lavoro:
- L'utente finale dialoga con l'agente nella sessione A.
- Il codice registra lo stato associato alla sessione A restituita 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 dialoga di nuovo con l'agente.
- Il codice invia l'input utente finale, insieme a
QueryParameters.current_page
eQueryParameters.parameters
registrati in precedenza nella richiesta, per rilevare l'intent 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 la pagina dei prezzi.
Per ulteriori informazioni sulle sessioni:
Seleziona un protocollo e la versione come riferimento per la sessione:
Protocollo | V3 | Versione 3 beta 1 |
---|---|---|
REST | Risorsa sessione | Risorsa sessione |
RPC | Interfaccia della sessione | Interfaccia della sessione |
C++ | SessionsClient | Non disponibile |
C# | SessionsClient | Non disponibile |
Go | SessionsClient | Non disponibile |
Java | SessionsClient | SessionsClient |
Node.js | SessionsClient | SessionsClient |
PHP | Non disponibile | Non disponibile |
Python | SessionsClient | SessionsClient |
Ruby | Non disponibile | Non disponibile |