Sessioni

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 e QueryParameters.parameters a DetectIntentRequest.

    Un esempio di flusso di lavoro è il seguente:

    1. L'utente finale parla con l'agente nella sessione A.
    2. Il codice registra lo stato associato alla sessione A restituito nella risposta dell'API, ovvero QueryResult.current_page e QueryResult.parameters.
    3. L'utente finale smette di interagire con l'agente dopo 50 minuti.
    4. L'utente finale parla di nuovo con l'agente.
    5. Il codice invia l'input dell'utente finale, insieme a QueryParameters.current_page e QueryParameters.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