SessionConfig

세션의 구성입니다.

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
}
필드
session

string

필수 항목입니다. 세션의 고유 식별자입니다. 형식: projects/{project}/locations/{location}/apps/{app}/sessions/{session}

inputAudioConfig

object (InputAudioConfig)

선택사항입니다. 입력 오디오를 처리하기 위한 구성입니다.

outputAudioConfig

object (OutputAudioConfig)

선택사항입니다. 출력 오디오를 생성하기 위한 구성입니다.

historicalContexts[]

object (Message)

선택사항입니다. 사용자 입력, 에이전트 응답, 기타 메시지를 포함한 세션의 이전 컨텍스트입니다. 일반적으로 CES 에이전트는 세션을 자동으로 관리하므로 클라이언트가 이 필드를 명시적으로 채울 필요가 없습니다. 그러나 클라이언트는 선택적으로 이전 컨텍스트를 재정의하여 특정 상태에서 세션을 강제로 시작할 수 있습니다.

entryAgent

string

선택사항입니다. 세션을 처리할 진입 에이전트입니다. 지정하지 않으면 세션은 앱의 root agent에서 처리합니다. 형식: projects/{project}/locations/{location}/apps/{app}/agents/{agent}

deployment

string

선택사항입니다. 세션에 사용할 앱의 배포입니다. 형식: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}

timeZone

string

선택사항입니다. 사용자의 시간대입니다. 제공된 경우 에이전트는 날짜 및 시간 관련 변수에 시간대를 사용합니다. 그렇지 않으면 에이전트는 App.time_zone_settings에 지정된 시간대를 사용합니다.

형식은 IANA 시간대 데이터베이스 시간대입니다(예: 'America/Los_Angeles').

useToolFakes

boolean

선택사항입니다. 세션에 도구 가짜를 사용할지 여부입니다. 이 필드가 설정되면 에이전트는 실제 도구를 호출하는 대신 도구 가짜를 사용하려고 시도합니다.

remoteDialogflowQueryParameters

object (SessionConfig.RemoteDialogflowQueryParameters)

선택사항입니다. QueryParameters 세션 제어가 원격 에이전트로 전송될 때 원격 Dialogflow 에이전트로 전송할 항목입니다.

enableTextStreaming

boolean

선택사항입니다. 모델에서 스트리밍 텍스트 출력을 사용 설정할지 여부입니다. 기본적으로 모델의 텍스트 출력은 클라이언트로 전송되기 전에 수집됩니다. 참고: 이는 StreamRunSession 또는 BidiRunSession을 통한 텍스트 (음성이 아닌) 세션에서만 지원됩니다.

excludeDiagnosticInfo

boolean

선택사항입니다. 세션 출력에서 진단 정보를 제외할지 여부입니다.

InputAudioConfig

InputAudioConfig는 CES 에이전트가 수신 오디오 데이터를 해석하는 방법을 구성합니다.

JSON 표현
{
  "audioEncoding": enum (AudioEncoding),
  "sampleRateHertz": integer,
  "noiseSuppressionLevel": string
}
필드
audioEncoding

enum (AudioEncoding)

필수 항목입니다. 입력 오디오 데이터의 인코딩입니다.

sampleRateHertz

integer

필수 항목입니다. 입력 오디오 데이터의 샘플링 속도 (헤르츠)입니다.

noiseSuppressionLevel

string

선택사항입니다. 입력 오디오에서 노이즈 제거를 사용 설정할지 여부입니다. 사용 가능한 값은 'low', 'moderate', 'high', 'very_high'입니다.

AudioEncoding

AudioEncoding은 오디오 데이터의 인코딩 형식을 지정합니다.

열거형
AUDIO_ENCODING_UNSPECIFIED 지정되지 않은 오디오 인코딩입니다.
LINEAR16 16비트 선형 PCM 오디오 인코딩입니다.
MULAW G.711 PCMU/mu-law를 사용하여 14비트 오디오 샘플을 압축하는 8비트 샘플입니다.
ALAW G.711 PCMU/A-law를 사용하여 14비트 오디오 샘플을 압축하는 8비트 샘플입니다.

OutputAudioConfig

OutputAudioConfig는 CES 에이전트가 발신 오디오 응답을 합성하는 방법을 구성합니다.

JSON 표현
{
  "audioEncoding": enum (AudioEncoding),
  "sampleRateHertz": integer
}
필드
audioEncoding

enum (AudioEncoding)

필수 항목입니다. 출력 오디오 데이터의 인코딩입니다.

sampleRateHertz

integer

필수 항목입니다. 출력 오디오 데이터의 샘플링 속도 (헤르츠)입니다.

SessionConfig.RemoteDialogflowQueryParameters

QueryParameters 세션 제어가 원격 에이전트로 전송될 때 원격 Dialogflow 에이전트로 전송할 항목입니다.

JSON 표현
{
  "webhookHeaders": {
    string: string,
    ...
  },
  "payload": {
    object
  },
  "endUserMetadata": {
    object
  }
}
필드
webhookHeaders

map (key: string, value: string)

선택사항입니다. QueryParameters에서 webhookHeaders로 전송할 HTTP 헤더입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

payload

object (Struct format)

선택사항입니다. QueryParameters에서 전송할 페이로드입니다.

endUserMetadata

object (Struct format)

선택사항입니다. QueryParameters에서 전송할 최종 사용자 메타데이터입니다.