SessionConfig

La configurazione della sessione.

Rappresentazione JSON
{
  "session": string,
  "inputAudioConfig": {
    object (InputAudioConfig)
  },
  "outputAudioConfig": {
    object (OutputAudioConfig)
  },
  "historicalContexts": [
    {
      object (Message)
    }
  ],
  "entryAgent": string,
  "deployment": string,
  "timeZone": string,
  "useToolFakes": boolean,
  "remoteDialogflowQueryParameters": {
    object (SessionConfig.RemoteDialogflowQueryParameters)
  },
  "enableTextStreaming": boolean,
  "excludeDiagnosticInfo": boolean
}
Campi
session

string

Obbligatorio. L'identificatore univoco della sessione. Formato: projects/{project}/locations/{location}/apps/{app}/sessions/{session}

inputAudioConfig

object (InputAudioConfig)

Facoltativo. Configurazione per l'elaborazione dell'audio di input.

outputAudioConfig

object (OutputAudioConfig)

Facoltativo. Configurazione per la generazione dell'audio di output.

historicalContexts[]

object (Message)

Facoltativo. Il contesto storico della sessione, inclusi input dell'utente, risposte dell'agente e altri messaggi. In genere, l'agente CES gestisce automaticamente la sessione, quindi il client non deve compilare esplicitamente questo campo. Tuttavia, il client può facoltativamente sostituire i contesti storici per forzare l'avvio della sessione da un determinato stato.

entryAgent

string

Facoltativo. L'agente di ingresso per gestire la sessione. Se non specificato, la sessione verrà gestita dal root agent dell'app. Formato: projects/{project}/locations/{location}/apps/{app}/agents/{agent}

deployment

string

Facoltativo. Il deployment dell'app da utilizzare per la sessione. Formato: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}

timeZone

string

Facoltativo. Il fuso orario dell'utente. Se fornito, l'agente utilizzerà il fuso orario per le variabili relative a data e ora. In caso contrario, l'agente utilizzerà il fuso orario specificato in App.time_zone_settings.

Il formato è il fuso orario del database dei fusi orari IANA, ad es. "America/Los_Angeles".

useToolFakes

boolean

Facoltativo. Indica se utilizzare simulazioni di strumenti per la sessione. Se questo campo è impostato, l'agente tenterà di utilizzare simulazioni di strumenti anziché chiamare gli strumenti reali.

remoteDialogflowQueryParameters

object (SessionConfig.RemoteDialogflowQueryParameters)

Facoltativo. QueryParameters da inviare all'agente Dialogflow remoto quando il controllo della sessione viene trasferito all'agente remoto.

enableTextStreaming

boolean

Facoltativo. Indica se attivare lo streaming degli output di testo del modello. Per impostazione predefinita, gli output di testo del modello vengono raccolti prima di essere inviati al client. NOTA: questa funzionalità è supportata solo per le sessioni di testo (non vocali) tramite StreamRunSession o BidiRunSession.

excludeDiagnosticInfo

boolean

Facoltativo. Indica se escludere le informazioni diagnostiche dall'output della sessione.

InputAudioConfig

InputAudioConfig configura il modo in cui l'agente CES deve interpretare i dati audio in entrata.

Rappresentazione JSON
{
  "audioEncoding": enum (AudioEncoding),
  "sampleRateHertz": integer,
  "noiseSuppressionLevel": string
}
Campi
audioEncoding

enum (AudioEncoding)

Obbligatorio. La codifica dei dati audio di input.

sampleRateHertz

integer

Obbligatorio. La frequenza di campionamento (in Hertz) dei dati audio di input.

noiseSuppressionLevel

string

Facoltativo. Indica se attivare l'eliminazione dei rumori sull'audio di input. I valori disponibili sono "low", "moderate", "high", "very_high".

AudioEncoding

AudioEncoding specifica il formato di codifica per i dati audio.

Enum
AUDIO_ENCODING_UNSPECIFIED Codifica audio non specificata.
LINEAR16 Codifica audio PCM lineare a 16 bit.
MULAW Campioni a 8 bit che comprimono campioni audio a 14 bit utilizzando G.711 PCMU/mu-law.
ALAW Campioni a 8 bit che comprimono campioni audio a 14 bit utilizzando G.711 PCMU/A-law.

OutputAudioConfig

OutputAudioConfig configura il modo in cui l'agente CES deve sintetizzare le risposte audio in uscita.

Rappresentazione JSON
{
  "audioEncoding": enum (AudioEncoding),
  "sampleRateHertz": integer
}
Campi
audioEncoding

enum (AudioEncoding)

Obbligatorio. La codifica dei dati audio di output.

sampleRateHertz

integer

Obbligatorio. La frequenza di campionamento (in Hertz) dei dati audio di output.

SessionConfig.RemoteDialogflowQueryParameters

QueryParameters da inviare all'agente Dialogflow remoto quando il controllo della sessione viene trasferito all'agente remoto.

Rappresentazione JSON
{
  "webhookHeaders": {
    string: string,
    ...
  },
  "payload": {
    object
  },
  "endUserMetadata": {
    object
  }
}
Campi
webhookHeaders

map (key: string, value: string)

Facoltativo. Le intestazioni HTTP da inviare come webhookHeaders in QueryParameters.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

payload

object (Struct format)

Facoltativo. Il payload da inviare in QueryParameters.

endUserMetadata

object (Struct format)

Facoltativo. I metadati dell'utente finale da inviare in QueryParameters.