MCP Tools Reference: ces.googleapis.com

도구: update_app

지정된 앱을 업데이트합니다. 항상 입력에 업데이트 마스크를 전달해야 합니다.

다음 코드 샘플은 curl를 사용하여 update_app MCP 도구를 호출하는 방법을 보여줍니다.

curl 요청 
curl --location 'https://ces.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "update_app",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

AgentService.UpdateApp에 대한 요청 메시지입니다.

UpdateAppRequest

JSON 표현 
{
  "app": {
    object (App)
  },
  "updateMask": string
}
필드
app

object (App)

필수 항목입니다. 업데이트할 앱입니다.
updateMask

string (FieldMask format)

선택사항입니다. 필드 마스크는 업데이트할 필드를 제어하는 데 사용됩니다. 마스크가 없으면 모든 필드가 업데이트됩니다.

정규화된 필드 이름의 쉼표로 구분된 목록입니다. 예: "user.displayName,photo"

앱

JSON 표현 
{
  "name": string,
  "displayName": string,
  "description": string,
  "pinned": boolean,
  "rootAgent": string,
  "languageSettings": {
    object (LanguageSettings)
  },
  "timeZoneSettings": {
    object (TimeZoneSettings)
  },
  "audioProcessingConfig": {
    object (AudioProcessingConfig)
  },
  "loggingSettings": {
    object (LoggingSettings)
  },
  "errorHandlingSettings": {
    object (ErrorHandlingSettings)
  },
  "modelSettings": {
    object (ModelSettings)
  },
  "toolExecutionMode": enum (ToolExecutionMode),
  "evaluationMetricsThresholds": {
    object (EvaluationMetricsThresholds)
  },
  "variableDeclarations": [
    {
      object (VariableDeclaration)
    }
  ],
  "predefinedVariableDeclarations": [
    {
      object (VariableDeclaration)
    }
  ],
  "globalInstruction": string,
  "guardrails": [
    string
  ],
  "dataStoreSettings": {
    object (DataStoreSettings)
  },
  "defaultChannelProfile": {
    object (ChannelProfile)
  },
  "metadata": {
    string: string,
    ...
  },
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "deploymentCount": integer,
  "clientCertificateSettings": {
    object (ClientCertificateSettings)
  },
  "vpcScSettings": {
    object (VpcScSettings)
  },
  "locked": boolean,
  "validationErrors": [
    string
  ],
  "dashboardSettings": {
    object (DashboardSettings)
  }
}
필드
name

string

식별자. 앱의 고유 식별자입니다. 형식: projects/{project}/locations/{location}/apps/{app}
displayName

string

필수 항목입니다. 앱의 표시 이름입니다.
description

string

선택사항입니다. 인간이 읽을 수 있는 앱 설명입니다.
pinned

boolean

선택사항입니다. 앱이 앱 목록에 고정되어 있는지 여부입니다.
rootAgent

string

선택사항입니다. 루트 에이전트는 앱의 진입점입니다. 형식: projects/{project}/locations/{location}/apps/{app}/agents/{agent}
languageSettings

object (LanguageSettings)

선택사항입니다. 앱의 언어 설정입니다.
timeZoneSettings

object (TimeZoneSettings)

선택사항입니다. 앱의 TimeZone 설정입니다.
audioProcessingConfig

object (AudioProcessingConfig)

선택사항입니다. 앱의 오디오 처리 구성입니다.
loggingSettings

object (LoggingSettings)

선택사항입니다. 앱의 로깅 설정입니다.
errorHandlingSettings

object (ErrorHandlingSettings)

선택사항입니다. 앱의 오류 처리 설정
modelSettings

object (ModelSettings)

선택사항입니다. 앱의 기본 LLM 모델 설정입니다. 개별 리소스(예: 에이전트, 가드레일)는 필요에 따라 이러한 구성을 재정의할 수 있습니다.
toolExecutionMode

enum (ToolExecutionMode)

선택사항입니다. 앱의 도구 실행 모드입니다. 제공되지 않으면 기본값은 PARALLEL입니다.
evaluationMetricsThresholds

object (EvaluationMetricsThresholds)

선택사항입니다. 앱의 평가 기준입니다.
variableDeclarations[]

object (VariableDeclaration)

선택사항입니다. 변수 선언입니다.
predefinedVariableDeclarations[]

object (VariableDeclaration)

출력 전용입니다. 앱의 사전 정의된 변수 선언입니다.
globalInstruction

string

선택사항입니다. 앱의 모든 에이전트에 대한 안내입니다. 이 안내를 사용하여 모든 에이전트에서 안정적인 ID 또는 성격을 설정할 수 있습니다.
guardrails[]

string

선택사항입니다. 앱의 가드레일 목록입니다. 형식: projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}
dataStoreSettings

object (DataStoreSettings)

선택사항입니다. 앱의 데이터 스토어 설정입니다.
defaultChannelProfile

object (ChannelProfile)

선택사항입니다. 앱에서 사용하는 기본 채널 프로필입니다.
metadata

map (key: string, value: string)

선택사항입니다. 앱에 대한 메타데이터입니다. 이 필드는 앱의 세부정보 또는 의도된 사용과 관련된 추가 정보를 저장하는 데 사용할 수 있습니다.

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

string (Timestamp format)

출력 전용입니다. 앱이 생성된 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. 앱이 마지막으로 업데이트된 시점의 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
etag

string

출력 전용입니다. 읽기-수정-쓰기 작업 중에 객체가 변경되지 않았는지 확인하는 데 사용되는 Etag입니다. etag가 비어 있으면 업데이트가 동시 변경사항을 덮어씁니다.
deploymentCount

integer

출력 전용입니다. 앱의 배포 수입니다.
clientCertificateSettings

object (ClientCertificateSettings)

선택사항입니다. 앱의 기본 클라이언트 인증서 설정입니다.
vpcScSettings

object (VpcScSettings)

선택사항입니다. 앱의 VPC-SC 설정입니다.
locked

boolean

선택사항입니다. 변경사항에 대해 앱이 잠겨 있는지 여부를 나타냅니다. 앱이 잠겨 있으면 앱 리소스 수정이 거부됩니다.
validationErrors[]

string

출력 전용입니다. 앱의 구성 오류 또는 경고
dashboardSettings

object (DashboardSettings)

선택사항입니다. Contact Center Insights 대시보드를 연결하고 구성하기 위한 앱별 대시보드 설정입니다.

LanguageSettings

JSON 표현 
{
  "defaultLanguageCode": string,
  "supportedLanguageCodes": [
    string
  ],
  "enableMultilingualSupport": boolean,
  "fallbackAction": string
}
필드
defaultLanguageCode

string

선택사항입니다. 앱의 기본 언어 코드입니다.
supportedLanguageCodes[]

string

선택사항입니다. default_language_code 외에 앱에서 지원하는 언어 코드 목록입니다.
enableMultilingualSupport

boolean

선택사항입니다. 다국어 지원을 사용 설정합니다. true인 경우 앱의 에이전트가 사전 빌드된 안내를 사용하여 다국어 입력 처리를 개선합니다.
fallbackAction
(deprecated)

string

선택사항입니다. 지원 중단됨: 이 기능은 더 이상 지원되지 않습니다. 대신 enable_multilingual_support를 사용하여 다국어 입력 처리를 개선하세요. 에이전트가 지원되지 않는 언어로 입력을 받을 때 수행할 작업입니다.

이는 사전 정의된 작업 또는 커스텀 도구 호출일 수 있습니다. 유효한 값은 다음과 같습니다. - 특정 도구 실행을 트리거하는 도구의 전체 리소스 이름 - '에스컬레이션' 또는 '종료'와 같은 사전 정의된 시스템 작업으로, 해당 metadata와 함께 EndSession 신호를 트리거하여 대화를 종료합니다.

TimeZoneSettings

JSON 표현 
{
  "timeZone": string
}
필드
timeZone

string

선택사항입니다. 시간대 데이터베이스에 등록된 앱의 시간대입니다(예: America/Los_Angeles, Europe/Paris).

AudioProcessingConfig

JSON 표현 
{
  "synthesizeSpeechConfigs": {
    string: {
      object (SynthesizeSpeechConfig)
    },
    ...
  },
  "bargeInConfig": {
    object (BargeInConfig)
  },
  "inactivityTimeout": string,
  "ambientSoundConfig": {
    object (AmbientSoundConfig)
  },
  "customVoiceSamples": [
    {
      object (CustomVoiceSample)
    }
  ]
}
필드
synthesizeSpeechConfigs

map (key: string, value: object (SynthesizeSpeechConfig))

선택사항입니다. 에이전트 응답을 합성하는 방법의 구성으로, 언어 코드를 SynthesizeSpeechConfig에 매핑합니다.

지정된 언어 코드의 구성을 찾을 수 없는 경우 루트 언어 코드의 구성이 사용됩니다. 예를 들어 맵에 'en-us' 및 'en'이 포함되어 있고 지정된 언어 코드가 'en-gb'인 경우 'en' 구성이 사용됩니다.

참고: 언어 코드는 대소문자를 구분하지 않습니다.

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

object (BargeInConfig)

선택사항입니다. 사용자 끼어들기 활동에 대한 에이전트 동작을 구성합니다.
inactivityTimeout

string (Duration format)

선택사항입니다. 에이전트가 사용자에게 재참여를 요청하기 전에 사용자가 비활성 상태(음성 또는 상호작용 없음)인 시간입니다. 설정하지 않으면 에이전트가 사용자에게 재참여를 요청하지 않습니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
ambientSoundConfig

object (AmbientSoundConfig)

선택사항입니다. 대화의 자연스러움을 향상하기 위해 합성된 에이전트 응답과 함께 재생할 주변 소리 구성입니다.
customVoiceSamples[]

object (CustomVoiceSample)

선택사항입니다. 음성 클론을 위한 커스텀 음성 샘플을 구성합니다.

SynthesizeSpeechConfigsEntry

JSON 표현 
{
  "key": string,
  "value": {
    object (SynthesizeSpeechConfig)
  }
}
필드
key

string
value

object (SynthesizeSpeechConfig)

SynthesizeSpeechConfig

JSON 표현 
{
  "voice": string,
  "speakingRate": number,
  "model": string,
  "instruction": string
}
필드
voice

string

선택사항. 음성 이름입니다. 설정하지 않으면 서비스에서 language_code와 같은 다른 매개변수를 기반으로 음성을 선택합니다.

사용 가능한 음성 목록은 Cloud Text-to-Speech의 지원되는 음성 및 언어를 참고하세요.
speakingRate

number

선택사항입니다. 말하기 속도/속도(범위: [0.25, 2.0])입니다. 1.0은 특정 음성에서 지원하는 일반적인 기본 속도입니다. 2.0은 기본 속도의 2배이며 0.5는 절반입니다. [0.25, 2.0] 범위를 벗어나는 값은 오류를 반환합니다.
model

string

선택사항입니다. 오디오를 합성하는 데 사용되는 모델입니다. 현재 지원되는 값은 'gemini-3.1-flash-tts-preview'입니다. 비어 있으면 Chirp3-HD가 사용됩니다.
instruction

string

선택사항입니다. 생성 모델을 사용할 때 음성을 합성하는 데 사용되는 요청 사항입니다.

BargeInConfig

JSON 표현 
{
  "disableBargeIn": boolean,
  "bargeInAwareness": boolean
}
필드
disableBargeIn
(deprecated)

boolean

선택사항입니다. 경고: ChannelProfile에서 disable_barge_in은 disable_barge_in_control로 대체되었습니다.

에이전트가 말하는 동안 사용자 끼어들기를 사용 중지합니다. true이면 에이전트 응답 재생 중 사용자 입력이 무시됩니다.
bargeInAwareness

boolean

선택사항입니다. 사용 설정하면 에이전트는 사용자가 이전 에이전트 메시지를 완전히 듣지 못했다고 가정하고 다음 대답을 조정합니다. 에이전트 응답이 시각적으로 표시되는 시나리오에서는 사용하면 안 됩니다.

소요 시간

JSON 표현 
{
  "seconds": string,
  "nanos": integer
}
필드
seconds

string (int64 format)

기간의 부호 있는 초입니다. -315,576,000,000~+315,576,000,000(포함) 사이여야 합니다. 참고: 이 경계는 60초/분 * 60분/시간 * 24시간/일 * 365.25일/년 * 10,000년으로 계산됩니다.
nanos

integer

기간의 나노초 단위로 부호가 있는 초수입니다. 1초 미만의 기간은 0 seconds 필드와 양수 또는 음수 nanos 필드로 표시됩니다. 1초 이상의 기간의 경우 nanos 필드의 0이 아닌 값은 seconds 필드와 동일한 부호여야 합니다. -999,999,999~+999,999,999(끝값 포함) 사이여야 합니다.

AmbientSoundConfig

JSON 표현 
{
  "volumeGainDb": number,

  // Union field source can be only one of the following:
  "prebuiltAmbientNoise": enum (PrebuiltAmbientNoise),
  "gcsUri": string,
  "prebuiltAmbientSound": string
  // End of list of possible types for union field source.
}
필드
volumeGainDb

number

선택사항입니다. 주변 소음에서 지원하는 일반 기본 볼륨의 볼륨 게인(dB)입니다. 범위는 [-96.0, 16.0]입니다. 값을 설정하지 않거나 0.0(dB)으로 설정하면 일반적인 기본 신호 진폭에서 재생됩니다. 값이 -6.0(dB)이면 일반적인 기본 신호 진폭의 약 절반에서 재생됩니다. 값이 +6.0(dB)이면 일반적인 기본 신호 진폭의 약 두 배에서 재생됩니다. +10(dB)을 초과하는 값을 사용하지 않는 것이 좋습니다. 값이 +10을 초과하면 일반적으로 소리가 커지는 효과가 없기 때문입니다.
통합 필드 source. 대화의 자연스러움을 향상시키기 위해 합성된 에이전트 응답과 함께 재생되는 주변 소음입니다. source은 다음 중 하나여야 합니다.
prebuiltAmbientNoise
(deprecated)

enum (PrebuiltAmbientNoise)

선택사항입니다. 지원 중단됨: prebuilt_ambient_noise는 지원 중단되고 prebuilt_ambient_sound로 대체됩니다.
gcsUri

string

선택사항입니다. Cloud Storage에 저장된 모노 채널, 16kHz WAV 파일 형식의 주변 소음

참고: CES 서비스 에이전트 service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com에 Cloud Storage 객체에 대한 storage.objects.get 권한이 있는지 확인하세요.
prebuiltAmbientSound

string

선택사항입니다. 사전 제작된 주변 소리의 이름입니다. 유효한 값은 'coffee_shop', 'keyboard', 'keypad', 'hum', 'office_1', 'office_2', 'office_3', 'room_1', 'room_2', 'room_3', 'room_4', 'room_5', 'air_conditioner'입니다.

CustomVoiceSample

JSON 표현 
{
  "name": string,
  "voiceSampleGcsUri": string,
  "consentAudioGcsUri": string,
  "voiceInstruction": string,
  "previewAudioContent": string,
  "previewText": string,
  "warnings": [
    {
      object (Warning)
    }
  ],
  "voiceInstructionMode": enum (VoiceInstructionMode)
}
필드
name

string

선택사항입니다. 커스텀 음성 샘플의 사용자 정의 이름입니다.
voiceSampleGcsUri

string

선택사항입니다. 음성 클론을 위한 오디오 샘플의 Cloud Storage URI입니다. 오디오 샘플은 모노 채널, 24kHz WAV 파일이어야 합니다.
consentAudioGcsUri

string

선택사항입니다. 음성 클론에 대한 동의 오디오입니다.
voiceInstruction

string

선택사항입니다. 음성 스타일, 어조, 속도 또는 발음에 대한 자연어 안내입니다.
previewAudioContent

string (bytes format)

출력 전용입니다. 커스텀 음성을 위해 합성된 프리뷰 오디오로, 표준 WAV(LINEAR16, 24kHz, 16비트, 모노) 형식입니다.

base64 인코딩 문자열입니다.
previewText

string

선택사항입니다. 커스텀 음성의 미리보기 오디오를 합성하기 위한 텍스트입니다.
warnings[]

object (Warning)

출력 전용입니다. 음성 클론 처리 중에 발생한 경고 메시지입니다(예: 낮은 오디오 수준).
voiceInstructionMode

enum (VoiceInstructionMode)

선택사항입니다. 음성 샘플의 요청 사항 모드입니다. 지정하지 않으면 기본값은 NO_INSTRUCTION입니다.

경고

JSON 표현 
{
  "message": string,
  "type": enum (WarningType)
}
필드
message

string

출력 전용입니다. 인간이 읽을 수 있는 경고 설명입니다.
type

enum (WarningType)

출력 전용입니다. 경고 유형입니다.

LoggingSettings

JSON 표현 
{
  "redactionConfig": {
    object (RedactionConfig)
  },
  "audioRecordingConfig": {
    object (AudioRecordingConfig)
  },
  "unredactedAudioRecordingConfig": {
    object (AudioRecordingConfig)
  },
  "bigqueryExportSettings": {
    object (BigQueryExportSettings)
  },
  "unredactedBigqueryExportSettings": {
    object (BigQueryExportSettings)
  },
  "cloudLoggingSettings": {
    object (CloudLoggingSettings)
  },
  "conversationLoggingSettings": {
    object (ConversationLoggingSettings)
  },
  "evaluationAudioRecordingConfig": {
    object (AudioRecordingConfig)
  },
  "metricAnalysisSettings": {
    object (MetricAnalysisSettings)
  },
  "requiredRecordingConsent": boolean
}
필드
redactionConfig

object (RedactionConfig)

선택사항입니다. 민감한 정보를 수정하는 방법에 대한 구성입니다.
audioRecordingConfig

object (AudioRecordingConfig)

선택사항입니다. 오디오 상호작용을 기록하는 방법에 대한 구성입니다. 오디오는 RedactionConfig에 구성된 대로 수정됩니다.
unredactedAudioRecordingConfig

object (AudioRecordingConfig)

선택사항입니다. 수정되지 않은 오디오의 추가 녹음을 구성합니다. 이는 오디오 수정이 enabled일 때 원시 오디오 사본을 유지하는 데 사용할 수 있으며, 일반적으로 감사 또는 모니터링 목적으로 사용됩니다.
bigqueryExportSettings

object (BigQueryExportSettings)

선택사항입니다. 앱의 BigQuery Export 동작을 구성합니다. 대화 데이터는 RedactionConfig에 구성된 대로 수정됩니다.
unredactedBigqueryExportSettings

object (BigQueryExportSettings)

선택사항입니다. 앱의 BigQuery 내보내기 동작을 구성합니다. 사용 설정하면 수정되지 않은 대화 데이터가 BigQuery 테이블로 내보내집니다.
cloudLoggingSettings

object (CloudLoggingSettings)

선택사항입니다. 앱의 Cloud Logging 동작을 설명하는 설정입니다.
conversationLoggingSettings

object (ConversationLoggingSettings)

선택사항입니다. 앱의 대화 로깅 동작을 설명하는 설정입니다.
evaluationAudioRecordingConfig

object (AudioRecordingConfig)

선택사항입니다. 평가를 위해 오디오 상호작용을 녹음하는 방법에 대한 구성입니다. 기본적으로 평가 세션에는 오디오 녹음이 사용 설정되지 않습니다.
metricAnalysisSettings

object (MetricAnalysisSettings)

선택사항입니다. 앱의 LLM 분석 파이프라인에 대한 대화 데이터 수집 동작을 설명하는 설정입니다.
requiredRecordingConsent

boolean

선택사항입니다. 앱이 녹음될 수 있는 내용을 말해야 하는지 여부

true인 경우 세션은 녹음이 사용 중지된 상태로 시작되며 클라이언트가 SessionInput.recording_control를 전송할 때까지 사용 중지된 상태로 유지됩니다. 이 시점부터는 모든 차례가 결정됩니다. 여기에는 오디오 녹음, 대화 기록, BigQuery Export, Cloud Logging이 포함됩니다.

기본값인 false인 경우 위의 설정이 자체적으로 결정되며 클라이언트는 아무것도 전송할 필요가 없습니다.

RedactionConfig

JSON 표현 
{
  "enableRedaction": boolean,
  "inspectTemplate": string,
  "deidentifyTemplate": string
}
필드
enableRedaction

boolean

선택사항입니다. true인 경우 대화 기록, Cloud Logging, 오디오 녹음 등 다양한 로깅 시나리오에 수정이 적용됩니다.
inspectTemplate

string

선택사항입니다. 민감한 정보 유형 감지를 구성하는 DLP 검사 템플릿 이름입니다.

형식: projects/{project}/locations/{location}/inspectTemplates/{inspect_template}
deidentifyTemplate

string

선택사항입니다. 콘텐츠를 익명화하는 방법을 지정하는 DLP 익명화 템플릿 이름입니다.

형식: projects/{project}/locations/{location}/deidentifyTemplates/{deidentify_template}

AudioRecordingConfig

JSON 표현 
{
  "gcsBucket": string,
  "gcsPathPrefix": string
}
필드
gcsBucket

string

선택사항입니다. 세션 오디오 녹음을 저장할 Cloud Storage 버킷입니다. URI는 'gs://'로 시작해야 합니다.

데이터 레지던시 요구사항을 충족하는 버킷 위치를 선택하세요.

참고: Cloud Storage 버킷이 앱과 다른 프로젝트에 있는 경우 CES 서비스 에이전트 service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com에 storage.objects.create 권한을 부여해야 합니다.
gcsPathPrefix

string

선택사항입니다. 오디오 녹음 파일의 Cloud Storage 경로 프리픽스입니다.

이 프리픽스에는 다음 자리표시자가 포함될 수 있으며, 이 자리표시자는 서빙 시점에 동적으로 대체됩니다. - $project: 프로젝트 ID - $location: 앱 위치 - $app: 앱 ID - $date: YYYY-MM-DD 형식의 세션 날짜 - $session: 세션 ID

경로 프리픽스를 지정하지 않으면 기본 프리픽스 $project/$location/$app/$date/$session/가 사용됩니다.

BigQueryExportSettings

JSON 표현 
{
  "enabled": boolean,
  "project": string,
  "dataset": string
}
필드
enabled

boolean

선택사항입니다. BigQuery Export가 사용 설정되어 있는지 여부를 나타냅니다.
project

string

선택사항입니다. 데이터를 내보낼 BigQuery 데이터 세트의 프로젝트 ID입니다.

참고: BigQuery 데이터 세트가 앱과 다른 프로젝트에 있는 경우 CES 서비스 에이전트 service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com에 roles/bigquery.admin 역할을 부여해야 합니다.
dataset

string

선택사항입니다. 데이터를 내보낼 BigQuery 데이터 세트 ID입니다.

CloudLoggingSettings

JSON 표현 
{
  "enableCloudLogging": boolean
}
필드
enableCloudLogging

boolean

선택사항입니다. 세션에 Cloud Logging을 사용 설정할지 여부입니다.

ConversationLoggingSettings

JSON 표현 
{
  "disableConversationLogging": boolean,
  "retentionWindow": string
}
필드
disableConversationLogging

boolean

선택사항입니다. 세션의 대화 로깅을 사용 중지할지 여부입니다.
retentionWindow

string (Duration format)

선택사항입니다. 대화의 보관 기간을 제어합니다. 설정하지 않으면 대화가 365일 동안 보관됩니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

MetricAnalysisSettings

JSON 표현 
{
  "llmMetricsOptedOut": boolean
}
필드
llmMetricsOptedOut

boolean

선택사항입니다. LLM 분석 측정항목의 대화 데이터를 수집할지 여부입니다. true이면 LLM 분석 측정항목에 대한 대화 데이터가 수집되지 않습니다. 그렇지 않으면 대화 데이터가 수집됩니다.

ErrorHandlingSettings

JSON 표현 
{
  "errorHandlingStrategy": enum (ErrorHandlingStrategy),
  "fallbackResponseConfig": {
    object (FallbackResponseConfig)
  },
  "endSessionConfig": {
    object (EndSessionConfig)
  }
}
필드
errorHandlingStrategy

enum (ErrorHandlingStrategy)

선택사항입니다. 오류 처리에 사용할 전략입니다.
fallbackResponseConfig

object (FallbackResponseConfig)

선택사항입니다. 대체 응답을 처리하기 위한 구성입니다.
endSessionConfig

object (EndSessionConfig)

선택사항입니다. 시스템 오류(예: LLM 오류)가 발생할 경우 세션을 종료하기 위한 구성입니다.

FallbackResponseConfig

JSON 표현 
{
  "customFallbackMessages": {
    string: string,
    ...
  },
  "maxFallbackAttempts": integer
}
필드
customFallbackMessages

map (key: string, value: string)

선택사항입니다. 시스템 오류(예: LLM 오류)가 발생할 경우의 대체 메시지이며 지원되는 언어 코드로 매핑됩니다.

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

integer

선택사항입니다. 에이전트가 EndSession 신호를 내보내기 전에 시도할 최대 대체 시도 횟수입니다.

CustomFallbackMessagesEntry

JSON 표현 
{
  "key": string,
  "value": string
}
필드
key

string
value

string

EndSessionConfig

JSON 표현 
{

  // Union field _escalate_session can be only one of the following:
  "escalateSession": boolean
  // End of list of possible types for union field _escalate_session.
}
필드

통합 필드 _escalate_session.

_escalate_session는 다음 중 하나여야 합니다.
escalateSession

boolean

선택사항입니다. EndSession에서 세션을 에스컬레이션할지 여부 세션이 에스컬레이션되면 metadata in EndSession에 session_escalated = true이 포함됩니다. 자세한 내용은 https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/deploy/google-telephony-platform#transfer_a_call_to_a_human_agent를 참고하세요.

ModelSettings

JSON 표현 
{
  "model": string,
  "thinkingLevel": enum (ThinkingLevel),

  // Union field _temperature can be only one of the following:
  "temperature": number
  // End of list of possible types for union field _temperature.
}
필드
model

string

선택사항입니다. 에이전트가 사용해야 하는 LLM 모델입니다. 설정하지 않으면 에이전트가 상위 에이전트에서 모델을 상속합니다.
thinkingLevel

enum (ThinkingLevel)

선택사항입니다. 모델의 사고 수준입니다.

통합 필드 _temperature.

_temperature는 다음 중 하나여야 합니다.
temperature

number

선택사항입니다. 설정하면 이 온도가 LLM 모델에 사용됩니다. 온도는 모델 응답의 무작위성을 제어합니다. 온도가 낮을수록 더 예측 가능한 대답이 생성됩니다. 온도가 높을수록 더 창의적인 대답이 생성됩니다.

EvaluationMetricsThresholds

JSON 표현 
{
  "goldenEvaluationMetricsThresholds": {
    object (GoldenEvaluationMetricsThresholds)
  },
  "hallucinationMetricBehavior": enum (HallucinationMetricBehavior),
  "goldenHallucinationMetricBehavior": enum (HallucinationMetricBehavior),
  "scenarioHallucinationMetricBehavior": enum (HallucinationMetricBehavior)
}
필드
goldenEvaluationMetricsThresholds

object (GoldenEvaluationMetricsThresholds)

선택사항입니다. 골든 평가 측정항목 기준점입니다.
hallucinationMetricBehavior
(deprecated)

enum (HallucinationMetricBehavior)

선택사항입니다. 지원 중단됨: 대신 golden_hallucination_metric_behavior를 사용하세요. 할루시네이션 측정항목 동작은 현재 골든 평가에 사용됩니다.
goldenHallucinationMetricBehavior

enum (HallucinationMetricBehavior)

선택사항입니다. 골든 평가의 할루시네이션 측정항목 동작입니다.
scenarioHallucinationMetricBehavior

enum (HallucinationMetricBehavior)

선택사항입니다. 시나리오 평가의 할루시네이션 측정항목 동작입니다.

GoldenEvaluationMetricsThresholds

JSON 표현 
{
  "turnLevelMetricsThresholds": {
    object (TurnLevelMetricsThresholds)
  },
  "expectationLevelMetricsThresholds": {
    object (ExpectationLevelMetricsThresholds)
  },
  "toolMatchingSettings": {
    object (ToolMatchingSettings)
  }
}
필드
turnLevelMetricsThresholds

object (TurnLevelMetricsThresholds)

선택사항입니다. 대화 수준 측정항목 기준입니다.
expectationLevelMetricsThresholds

object (ExpectationLevelMetricsThresholds)

선택사항입니다. 기대치 수준 측정항목 기준점입니다.
toolMatchingSettings

object (ToolMatchingSettings)

선택사항입니다. 도구 일치 설정입니다. 추가 도구 호출은 실행에 있지만 골든 기대치의 도구 호출과 일치하지 않는 도구 호출입니다.

TurnLevelMetricsThresholds

JSON 표현 
{
  "semanticSimilarityChannel": enum (SemanticSimilarityChannel),

  // Union field _semantic_similarity_success_threshold can be only one of the
  // following:
  "semanticSimilaritySuccessThreshold": integer
  // End of list of possible types for union field
  // _semantic_similarity_success_threshold.

  // Union field _overall_tool_invocation_correctness_threshold can be only one
  // of the following:
  "overallToolInvocationCorrectnessThreshold": number
  // End of list of possible types for union field
  // _overall_tool_invocation_correctness_threshold.
}
필드
semanticSimilarityChannel

enum (SemanticSimilarityChannel)

선택사항입니다. 평가에 사용할 시맨틱 유사성 채널입니다.

통합 필드 _semantic_similarity_success_threshold.

_semantic_similarity_success_threshold는 다음 중 하나여야 합니다.
semanticSimilaritySuccessThreshold

integer

선택사항입니다. 의미론적 유사도의 성공 기준입니다. 0에서 4 사이의 정수여야 합니다. 기본값은 3 이상입니다.

통합 필드 _overall_tool_invocation_correctness_threshold.

_overall_tool_invocation_correctness_threshold는 다음 중 하나여야 합니다.
overallToolInvocationCorrectnessThreshold

number

선택사항입니다. 전체 도구 호출 정확성의 성공 기준점입니다. 0에서 1 사이의 부동 소수점 수여야 합니다. 기본값은 1.0입니다.

ExpectationLevelMetricsThresholds

JSON 표현 
{

  // Union field _tool_invocation_parameter_correctness_threshold can be only one
  // of the following:
  "toolInvocationParameterCorrectnessThreshold": number
  // End of list of possible types for union field
  // _tool_invocation_parameter_correctness_threshold.
}
필드

통합 필드 _tool_invocation_parameter_correctness_threshold.

_tool_invocation_parameter_correctness_threshold는 다음 중 하나여야 합니다.
toolInvocationParameterCorrectnessThreshold

number

선택사항입니다. 개별 도구 호출 매개변수 정확성의 성공 기준점입니다. 0에서 1 사이의 부동 소수점 수여야 합니다. 기본값은 1.0입니다.

ToolMatchingSettings

JSON 표현 
{
  "extraToolCallBehavior": enum (ExtraToolCallBehavior)
}
필드
extraToolCallBehavior

enum (ExtraToolCallBehavior)

선택사항입니다. 추가 도구 호출의 동작입니다. 기본값은 FAIL입니다.

VariableDeclaration

JSON 표현 
{
  "name": string,
  "description": string,
  "schema": {
    object (Schema)
  }
}
필드
name

string

필수 항목입니다. 변수 이름입니다. 이름은 영문자 또는 밑줄로 시작해야 하며 영문자, 숫자, 밑줄만 포함해야 합니다.
description

string

필수 항목입니다. 변수에 대한 설명입니다.
schema

object (Schema)

필수 항목입니다. 변수의 스키마입니다.

스키마

JSON 표현 
{
  "type": enum (Type),
  "properties": {
    string: {
      object (Schema)
    },
    ...
  },
  "required": [
    string
  ],
  "description": string,
  "items": {
    object (Schema)
  },
  "nullable": boolean,
  "uniqueItems": boolean,
  "prefixItems": [
    {
      object (Schema)
    }
  ],
  "additionalProperties": {
    object (Schema)
  },
  "anyOf": [
    {
      object (Schema)
    }
  ],
  "enum": [
    string
  ],
  "default": value,
  "ref": string,
  "defs": {
    string: {
      object (Schema)
    },
    ...
  },
  "title": string,
  "minItems": string,
  "maxItems": string,

  // Union field _minimum can be only one of the following:
  "minimum": number
  // End of list of possible types for union field _minimum.

  // Union field _maximum can be only one of the following:
  "maximum": number
  // End of list of possible types for union field _maximum.
}
필드
type

enum (Type)

필수 항목입니다. 데이터 유형입니다.
properties

map (key: string, value: object (Schema))

선택사항입니다. Type.OBJECT의 속성입니다.

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

string

선택사항입니다. Type.OBJECT의 필수 속성입니다.
description

string

선택사항입니다. 데이터의 설명입니다.
items

object (Schema)

선택사항입니다. Type.ARRAY 요소의 스키마입니다.
nullable

boolean

선택사항입니다. null 값을 나타냅니다.
uniqueItems

boolean

선택사항입니다. 배열의 항목이 고유해야 함을 나타냅니다. TYPE.ARRAY에만 적용됩니다.
prefixItems[]

object (Schema)

선택사항입니다. Type.ARRAY의 초기 요소 스키마입니다.
additionalProperties

object (Schema)

선택사항입니다. 불리언 또는 객체일 수 있으며 추가 속성의 존재를 제어합니다.
anyOf[]

object (Schema)

선택사항입니다. 값은 목록의 하위 스키마 중 하나 이상에 대해 검증되어야 합니다.
enum[]

string

선택사항입니다. enum 형식의 기본 유형 요소의 가능한 값입니다. 예: 1. 방향을 {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]}로 정의할 수 있습니다. 2. 아파트 번호를 {type:INTEGER, format:enum, enum:["101", "201", "301"]}로 정의할 수 있습니다.
default

value (Value format)

선택사항입니다. 데이터의 기본값입니다.
ref

string

선택사항입니다. 스키마 노드 간의 간접 참조를 허용합니다. 값은 루트 defs의 하위 요소에 대한 유효한 참조여야 합니다.

예를 들어 다음 스키마는 'Pet'이라는 스키마 노드에 대한 참조를 정의합니다.

type: object
properties:
  pet:
    ref: #/defs/Pet
defs:
  Pet:
    type: object
    properties:
      name:
        type: string

'pet' 속성의 값은 'Pet'이라는 스키마 노드에 대한 참조입니다. 자세한 내용은 https://json-schema.org/understanding-json-schema/structuring을 참고하세요.
defs

map (key: string, value: object (Schema))

선택사항입니다. ref에서 사용할 정의의 맵입니다. 스키마의 루트에서만 허용됩니다.

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

string

선택사항입니다. 스키마의 제목입니다.
minItems

string (int64 format)

선택사항입니다. Type.ARRAY의 최소 요소 수입니다.
maxItems

string (int64 format)

선택사항입니다. Type.ARRAY의 최대 요소 수입니다.

통합 필드 _minimum.

_minimum는 다음 중 하나여야 합니다.
minimum

number

선택사항입니다. Type.INTEGER 및 Type.NUMBER의 최솟값입니다.

통합 필드 _maximum.

_maximum는 다음 중 하나여야 합니다.
maximum

number

선택사항입니다. Type.INTEGER 및 Type.NUMBER의 최댓값입니다.

PropertiesEntry

JSON 표현 
{
  "key": string,
  "value": {
    object (Schema)
  }
}
필드
key

string
value

object (Schema)

값

JSON 표현 
{

  // Union field kind can be only one of the following:
  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
  // End of list of possible types for union field kind.
}
필드
통합 필드 kind. 값의 종류입니다. kind은 다음 중 하나여야 합니다.
nullValue

null

JSON null을 나타냅니다.
numberValue

number

JSON 숫자를 나타냅니다. JSON에서 지원되지 않으므로 NaN, Infinity 또는 -Infinity가 아니어야 합니다. 또한 JSON 형식은 일반적으로 숫자 유형에서 큰 Int64 값을 지원하지 않으므로 이를 표현할 수 없습니다.
stringValue

string

JSON 문자열을 나타냅니다.
boolValue

boolean

JSON 불리언(JSON의 true 또는 false 리터럴)을 나타냅니다.
structValue

object (Struct format)

JSON 객체를 나타냅니다.
listValue

array (ListValue format)

JSON 배열을 나타냅니다.

구조체

JSON 표현 
{
  "fields": {
    string: value,
    ...
  }
}
필드
fields

map (key: string, value: value (Value format))

동적으로 입력된 값의 정렬되지 않은 맵입니다.

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

FieldsEntry

JSON 표현 
{
  "key": string,
  "value": value
}
필드
key

string
value

value (Value format)

ListValue

JSON 표현 
{
  "values": [
    value
  ]
}
필드
values[]

value (Value format)

동적으로 입력된 값의 반복 필드입니다.

DefsEntry

JSON 표현 
{
  "key": string,
  "value": {
    object (Schema)
  }
}
필드
key

string
value

object (Schema)

DataStoreSettings

JSON 표현 
{
  "engines": [
    {
      object (Engine)
    }
  ]
}
필드
engines[]

object (Engine)

출력 전용입니다. 앱의 엔진입니다.

엔진

JSON 표현 
{
  "name": string,
  "type": enum (Type)
}
필드
name

string

출력 전용입니다. 엔진의 리소스 이름입니다. 형식: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}
type

enum (Type)

출력 전용입니다. 엔진 유형입니다.

ChannelProfile

JSON 표현 
{
  "profileId": string,
  "channelType": enum (ChannelType),
  "personaProperty": {
    object (PersonaProperty)
  },
  "webWidgetConfig": {
    object (WebWidgetConfig)
  },
  "whatsappConfig": {
    object (WhatsAppConfig)
  },
  "instagramConfig": {
    object (InstagramConfig)
  },

  // Union field _disable_dtmf can be only one of the following:
  "disableDtmf": boolean
  // End of list of possible types for union field _disable_dtmf.

  // Union field _disable_barge_in_control can be only one of the following:
  "disableBargeInControl": boolean
  // End of list of possible types for union field _disable_barge_in_control.

  // Union field _noise_suppression_level can be only one of the following:
  "noiseSuppressionLevel": string
  // End of list of possible types for union field _noise_suppression_level.
}
필드
profileId

string

선택사항입니다. 채널 프로필의 고유 식별자입니다.
channelType

enum (ChannelType)

선택사항입니다. 채널 프로필의 유형입니다.
personaProperty

object (PersonaProperty)

선택사항입니다. 채널 프로필의 캐릭터 속성입니다.
webWidgetConfig

object (WebWidgetConfig)

선택사항입니다. 웹 위젯의 구성입니다.
whatsappConfig

object (WhatsAppConfig)

선택사항입니다. WhatsApp 배포와 관련된 구성입니다.
instagramConfig

object (InstagramConfig)

선택사항입니다. Instagram 배포와 관련된 구성입니다.

통합 필드 _disable_dtmf.

_disable_dtmf는 다음 중 하나여야 합니다.
disableDtmf

boolean

선택사항입니다. DTMF(이중 톤 다중 주파수)를 사용 중지할지 여부입니다.

통합 필드 _disable_barge_in_control.

_disable_barge_in_control는 다음 중 하나여야 합니다.
disableBargeInControl

boolean

선택사항입니다. 대화에서 사용자 끼어들기 제어를 사용 중지할지 여부입니다. - true: 에이전트가 말하는 동안 사용자 중단이 사용 중지됩니다. - false: 에이전트가 사용자가 중단할 수 있는 시점을 자동으로 제어합니다.

통합 필드 _noise_suppression_level.

_noise_suppression_level는 다음 중 하나여야 합니다.
noiseSuppressionLevel

string

선택사항입니다. 채널 프로필의 노이즈 제거 수준입니다. 사용 가능한 값은 'low', 'moderate', 'high', 'very_high'입니다.

PersonaProperty

JSON 표현 
{
  "persona": enum (Persona)
}
필드
persona

enum (Persona)

선택사항입니다. 채널의 페르소나

WebWidgetConfig

JSON 표현 
{
  "modality": enum (Modality),
  "theme": enum (Theme),
  "webWidgetTitle": string,
  "securitySettings": {
    object (SecuritySettings)
  }
}
필드
modality

enum (Modality)

선택사항입니다. 웹 위젯의 형식입니다.
theme

enum (Theme)

선택사항입니다. 웹 위젯의 테마입니다.
webWidgetTitle

string

선택사항입니다. 웹 위젯의 제목입니다.
securitySettings

object (SecuritySettings)

선택사항입니다. 웹 위젯의 보안 설정입니다.

SecuritySettings

JSON 표현 
{
  "enablePublicAccess": boolean,
  "enableOriginCheck": boolean,
  "allowedOrigins": [
    string
  ],
  "enableRecaptcha": boolean
}
필드
enablePublicAccess

boolean

선택사항입니다. 웹 위젯에 대한 공개 액세스가 사용 설정되었는지 여부를 나타냅니다. true인 경우 웹 위젯에 공개적으로 액세스할 수 있습니다. false인 경우 웹 위젯은 CES 에이전트에 액세스하기 위한 유효한 사용자 인증 정보를 반환하기 위해 자체 인증 및 승인 시스템과 통합되어야 합니다.
enableOriginCheck

boolean

선택사항입니다. 웹 위젯의 출처 확인이 사용 설정되었는지 여부를 나타냅니다. true인 경우 웹 위젯은 웹 위젯을 로드하는 웹사이트의 출처를 확인하고 동일한 출처 또는 허용된 출처에서만 로드되도록 허용합니다.
allowedOrigins[]

string

선택사항입니다. 웹 위젯을 호스팅할 수 있는 출처입니다. 출처는 RFC 6454에 의해 정의됩니다. 비어 있으면 모든 출처가 허용됩니다. 출처는 최대 100개까지 허용됩니다. 예: 'https://example.com'
enableRecaptcha

boolean

선택사항입니다. 웹 위젯의 reCAPTCHA 인증이 사용 설정되어 있는지 여부를 나타냅니다.

WhatsAppConfig

JSON 표현 
{
  "wabaId": string,
  "phoneNumberId": string,
  "phoneNumber": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
필드
wabaId

string

필수 항목입니다. WhatsApp Business 계정 ID입니다.
phoneNumberId

string

필수 항목입니다. Meta 전화번호 ID입니다.
phoneNumber

string

선택사항입니다. E.164 형식의 전화번호입니다.
displayName

string

출력 전용입니다. 가져온 Meta 비즈니스 페이지 이름입니다.
thumbnailUrl

string

출력 전용입니다. 가져온 메타 비즈니스 프로필 썸네일 URL입니다.
description

string

출력 전용입니다. 메타 비즈니스 페이지 또는 프로필에 대한 설명입니다.

InstagramConfig

JSON 표현 
{
  "instagramAccountId": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
필드
instagramAccountId

string

필수 항목입니다. Instagram 계정 ID입니다.
displayName

string

출력 전용입니다. 가져온 Meta 비즈니스 페이지 이름입니다.
thumbnailUrl

string

출력 전용입니다. 가져온 메타 비즈니스 프로필 썸네일 URL입니다.
description

string

출력 전용입니다. 메타 비즈니스 페이지 또는 프로필에 대한 설명입니다.

MetadataEntry

JSON 표현 
{
  "key": string,
  "value": string
}
필드
key

string
value

string

타임스탬프

JSON 표현 
{
  "seconds": string,
  "nanos": integer
}
필드
seconds

string (int64 format)

유닉스 시간 1970-01-01T00:00:00Z 이후 경과된 UTC 시간을 초 단위로 나타냅니다. -62135596800~253402300799(양 끝값 포함) 사이여야 합니다(0001-01-01T00:00:00Z~9999-12-31T23:59:59Z에 해당).
nanos

integer

나노초 단위의 음수가 아닌 초수입니다. 이 필드는 기간의 나노초 부분이며 초를 대체하지 않습니다. 음수의 초수 값에는 시간에 반영되는 음수가 아닌 나노초 값이 있어야 합니다. 0~999,999,999(포함) 사이여야 합니다.

ClientCertificateSettings

JSON 표현 
{
  "tlsCertificate": string,
  "privateKey": string,
  "passphrase": string
}
필드
tlsCertificate

string

필수 항목입니다. PEM 형식으로 인코딩된 TLS 인증서입니다. 이 문자열에는 시작 헤더와 끝 바닥글 줄이 포함되어야 합니다.
privateKey

string

필수 항목입니다. PEM 형식으로 인코딩된 비공개 키를 저장하는 SecretManager 보안 비밀 버전 리소스의 이름입니다. 형식: projects/{project}/secrets/{secret}/versions/{version}
passphrase

string

선택사항입니다. 비공개 키를 복호화하는 암호를 저장하는 SecretManager 보안 비밀 버전 리소스의 이름입니다. 비공개 키가 암호화되지 않은 경우 설정하지 않은 상태로 두어야 합니다. 형식: projects/{project}/secrets/{secret}/versions/{version}

VpcScSettings

JSON 표현 
{
  "allowedOrigins": [
    string
  ]
}
필드
allowedOrigins[]

string

선택사항입니다. VPC 서비스 제어가 사용 설정된 경우 앱의 OpenAPI 도구가 직접 호출할 수 있는 허용된 HTTP(S) 출처입니다. 이 문자열은 포트가 지정된 경우 포트를 포함하여 출처와 정확히 일치해야 합니다. 예를 들면 'https://example.com' 또는 'https://example.com:443'입니다. 이 목록은 직접 HTTP 호출을 수행할 수 있는 Python 도구에는 아직 적용되지 않습니다.

DashboardSettings

JSON 표현 
{
  "defaultDashboard": string
}
필드
defaultDashboard

string

선택사항입니다. 앱과 연결된 기본 Contact Center Insights 대시보드의 리소스 이름입니다. 사용자가 앱의 모니터링 뷰로 이동할 때 표시되는 대시보드입니다.

형식: projects/{project}/locations/{location}/dashboards/{dashboard}

FieldMask

JSON 표현 
{
  "paths": [
    string
  ]
}
필드
paths[]

string

필드 마스크 경로 집합입니다.

PrebuiltAmbientNoise

사전 빌드된 주변 소음

열거형
PREBUILT_AMBIENT_NOISE_UNSPECIFIED 지정되지 않음
RETAIL_STORE 소매점의 주변 소음
CONVENTION_HALL 컨벤션 홀의 주변 소음
OUTDOOR 거리의 주변 소음

WarningType

음성 샘플 처리 중에 발생한 경고 유형입니다.

열거형
WARNING_TYPE_UNSPECIFIED 지정되지 않은 경고 유형입니다.
LOW_AUDIO_LEVEL 음성 샘플의 오디오 수준이 너무 낮습니다(예: 낮은 RMS 진폭).

VoiceInstructionMode

음성 샘플의 요청 사항 모드입니다.

열거형
VOICE_INSTRUCTION_MODE_UNSPECIFIED 지정되지 않은 안내 모드입니다. 기본값은 NO_INSTRUCTION입니다.
NO_INSTRUCTION 음성 안내가 사용되지 않습니다.
GENERATE_INSTRUCTION AI가 오디오 샘플을 기반으로 음성 안내를 자동으로 생성합니다.
CUSTOM_INSTRUCTION 사용자가 제공한 맞춤 음성 안내입니다.

ErrorHandlingStrategy

오류 처리 전략을 정의합니다.

열거형
ERROR_HANDLING_STRATEGY_UNSPECIFIED 지정되지 않은 오류 처리 전략입니다.
NONE 특정 처리가 사용 설정되지 않았습니다.
FALLBACK_RESPONSE 시스템 오류(예: LLM 오류)가 발생하면 대체 메시지가 사용자에게 반환됩니다.
END_SESSION 시스템 오류(예: LLM 오류)가 발생하면 EndSession 신호가 전송됩니다.

ThinkingLevel

모델의 사고 수준 구성입니다.

열거형
THINKING_LEVEL_UNSPECIFIED 사고 수준이 지정되지 않았습니다.
DEFAULT 기본 사고 수준입니다.
LOW 낮은 사고 수준
MEDIUM 중간 수준의 사고
HIGH 높은 수준의 사고

ToolExecutionMode

에이전트가 동시에 여러 도구를 선택하는 경우 도구 실행 동작을 정의합니다.

열거형
TOOL_EXECUTION_MODE_UNSPECIFIED 지정되지 않은 도구 실행 모드입니다. 기본값은 PARALLEL입니다.
PARALLEL 여러 도구가 선택되면 동일한 ToolContext를 사용하여 동시에 실행됩니다.
SEQUENTIAL 여러 도구가 선택된 경우 순차적으로 실행됩니다. 다음 도구는 이전 도구가 완료된 후에만 실행되며 이전 도구에서 업데이트된 ToolContext를 볼 수 있습니다.

SemanticSimilarityChannel

사용할 시맨틱 유사성 채널입니다.

열거형
SEMANTIC_SIMILARITY_CHANNEL_UNSPECIFIED 측정항목이 지정되지 않았습니다. 기본값은 TEXT입니다.
TEXT 텍스트 시맨틱 유사성을 사용합니다.
AUDIO 오디오 시맨틱 유사성을 사용합니다.

ExtraToolCallBehavior

추가 도구 호출이 발생할 때의 동작을 정의합니다. 추가 도구 호출은 실행에 있지만 골든 기대치의 도구 호출과 일치하지 않는 도구 호출입니다.

열거형
EXTRA_TOOL_CALL_BEHAVIOR_UNSPECIFIED 지정되지 않은 동작입니다. 기본값은 FAIL입니다.
FAIL 추가 도구 호출이 발생하면 평가에 실패합니다.
ALLOW 추가 도구 호출을 허용합니다.

HallucinationMetricBehavior

할루시네이션 측정항목 동작입니다. 동작과 관계없이 측정항목은 항상 계산됩니다. 차이점은 사용 중지하면 측정항목이 전체 평가 점수를 계산하는 데 사용되지 않는다는 것입니다.

열거형
HALLUCINATION_METRIC_BEHAVIOR_UNSPECIFIED 지정되지 않은 할루시네이션 측정항목 동작입니다.
DISABLED 할루시네이션 측정항목을 사용 중지합니다.
ENABLED 할루시네이션 측정항목을 사용 설정합니다.

유형

OpenAPI 데이터 유형

열거형
TYPE_UNSPECIFIED 유형이 지정되지 않습니다.
STRING 문자열 유형입니다.
INTEGER 정수 유형입니다.
NUMBER 숫자 유형입니다.
BOOLEAN 불리언 유형입니다.
OBJECT 객체 유형입니다.
ARRAY 배열 유형입니다.

NullValue

JSON null을 나타냅니다.

NullValue는 센티널로, 값이 하나만 있는 enum을 사용하여 Value 유형 공용체의 null 값을 나타냅니다.

0 이외의 값이 있는 NullValue 유형의 필드는 잘못된 것으로 간주됩니다. 대부분의 ProtoJSON 직렬 변환기는 정수 값과 관계없이 JSON null로 설정된 null_value가 있는 Value를 내보내므로 0 값으로 왕복합니다.

열거형
NULL_VALUE null 값입니다.

유형

엔진 유형입니다. https://cloud.google.com/generative-ai-app-builder/docs/reference/rest/v1/SolutionType 및 https://cloud.google.com/generative-ai-app-builder/docs/create-datastore-ingest에서 제공되는 문서를 참조하세요.

열거형
TYPE_UNSPECIFIED 지정되지 않은 엔진 유형입니다.
ENGINE_TYPE_CHAT 채팅 엔진 유형입니다. 앱의 SOLUTION_TYPE_CHAT 엔진입니다. 앱에 추가된 모든 커넥터 데이터 스토어가 이 엔진에 추가됩니다.

ChannelType

채널 프로필의 유형입니다.

열거형
UNKNOWN 알 수 없는 채널 유형입니다.
WEB_UI 웹 UI 채널
API API 채널입니다.
TWILIO Twilio 채널
GOOGLE_TELEPHONY_PLATFORM Google Telephony Platform 채널
CONTACT_CENTER_AS_A_SERVICE Contact Center as a Service(CCaaS) 채널
CONTACT_CENTER_AS_A_SERVICE_CHAT Contact Center as a Service(CCaaS 채팅) 채널
FIVE9 Five9 채널
CONTACT_CENTER_INTEGRATION 서드 파티 고객센터 통합 채널입니다.
WHATSAPP WhatsApp 채널
INSTAGRAM Instagram 채널

페르소나

채널의 페르소나

열거형
UNKNOWN UNKNOWN 캐릭터
CONCISE 상담사는 간결하고 요점이 명확하게 답변합니다.
CHATTY 상담사가 추가 맥락, 설명, 세부정보를 제공합니다.

형식

웹 위젯의 모달리티입니다.

열거형
MODALITY_UNSPECIFIED 알 수 없는 양식입니다.
CHAT_AND_VOICE 위젯은 채팅 및 음성 입력을 모두 지원합니다.
VOICE_ONLY 위젯은 음성 입력만 지원합니다.
CHAT_ONLY 위젯은 채팅 입력만 지원합니다.
CHAT_VOICE_AND_VIDEO 위젯은 채팅, 음성, 동영상 입력을 지원합니다.

테마

웹 위젯의 테마입니다.

열거형
THEME_UNSPECIFIED 알 수 없는 테마입니다.
LIGHT 밝은 테마
DARK 어두운 테마

출력 스키마

앱은 루트 에이전트와 하위 에이전트, 관련 구성이 포함된 에이전트 그룹의 최상위 컨테이너 역할을 합니다. 이러한 에이전트는 앱 컨텍스트 내에서 특정 목표를 달성하기 위해 함께 작동합니다.

앱

JSON 표현 
{
  "name": string,
  "displayName": string,
  "description": string,
  "pinned": boolean,
  "rootAgent": string,
  "languageSettings": {
    object (LanguageSettings)
  },
  "timeZoneSettings": {
    object (TimeZoneSettings)
  },
  "audioProcessingConfig": {
    object (AudioProcessingConfig)
  },
  "loggingSettings": {
    object (LoggingSettings)
  },
  "errorHandlingSettings": {
    object (ErrorHandlingSettings)
  },
  "modelSettings": {
    object (ModelSettings)
  },
  "toolExecutionMode": enum (ToolExecutionMode),
  "evaluationMetricsThresholds": {
    object (EvaluationMetricsThresholds)
  },
  "variableDeclarations": [
    {
      object (VariableDeclaration)
    }
  ],
  "predefinedVariableDeclarations": [
    {
      object (VariableDeclaration)
    }
  ],
  "globalInstruction": string,
  "guardrails": [
    string
  ],
  "dataStoreSettings": {
    object (DataStoreSettings)
  },
  "defaultChannelProfile": {
    object (ChannelProfile)
  },
  "metadata": {
    string: string,
    ...
  },
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "deploymentCount": integer,
  "clientCertificateSettings": {
    object (ClientCertificateSettings)
  },
  "vpcScSettings": {
    object (VpcScSettings)
  },
  "locked": boolean,
  "validationErrors": [
    string
  ],
  "dashboardSettings": {
    object (DashboardSettings)
  }
}
필드
name

string

식별자. 앱의 고유 식별자입니다. 형식: projects/{project}/locations/{location}/apps/{app}
displayName

string

필수 항목입니다. 앱의 표시 이름입니다.
description

string

선택사항입니다. 인간이 읽을 수 있는 앱 설명입니다.
pinned

boolean

선택사항입니다. 앱이 앱 목록에 고정되어 있는지 여부입니다.
rootAgent

string

선택사항입니다. 루트 에이전트는 앱의 진입점입니다. 형식: projects/{project}/locations/{location}/apps/{app}/agents/{agent}
languageSettings

object (LanguageSettings)

선택사항입니다. 앱의 언어 설정입니다.
timeZoneSettings

object (TimeZoneSettings)

선택사항입니다. 앱의 TimeZone 설정입니다.
audioProcessingConfig

object (AudioProcessingConfig)

선택사항입니다. 앱의 오디오 처리 구성입니다.
loggingSettings

object (LoggingSettings)

선택사항입니다. 앱의 로깅 설정입니다.
errorHandlingSettings

object (ErrorHandlingSettings)

선택사항입니다. 앱의 오류 처리 설정
modelSettings

object (ModelSettings)

선택사항입니다. 앱의 기본 LLM 모델 설정입니다. 개별 리소스(예: 에이전트, 가드레일)는 필요에 따라 이러한 구성을 재정의할 수 있습니다.
toolExecutionMode

enum (ToolExecutionMode)

선택사항입니다. 앱의 도구 실행 모드입니다. 제공되지 않으면 기본값은 PARALLEL입니다.
evaluationMetricsThresholds

object (EvaluationMetricsThresholds)

선택사항입니다. 앱의 평가 기준입니다.
variableDeclarations[]

object (VariableDeclaration)

선택사항입니다. 변수 선언입니다.
predefinedVariableDeclarations[]

object (VariableDeclaration)

출력 전용입니다. 앱의 사전 정의된 변수 선언입니다.
globalInstruction

string

선택사항입니다. 앱의 모든 에이전트에 대한 안내입니다. 이 안내를 사용하여 모든 에이전트에서 안정적인 ID 또는 성격을 설정할 수 있습니다.
guardrails[]

string

선택사항입니다. 앱의 가드레일 목록입니다. 형식: projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}
dataStoreSettings

object (DataStoreSettings)

선택사항입니다. 앱의 데이터 스토어 설정입니다.
defaultChannelProfile

object (ChannelProfile)

선택사항입니다. 앱에서 사용하는 기본 채널 프로필입니다.
metadata

map (key: string, value: string)

선택사항입니다. 앱에 대한 메타데이터입니다. 이 필드는 앱의 세부정보 또는 의도된 사용과 관련된 추가 정보를 저장하는 데 사용할 수 있습니다.

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

string (Timestamp format)

출력 전용입니다. 앱이 생성된 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. 앱이 마지막으로 업데이트된 시점의 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
etag

string

출력 전용입니다. 읽기-수정-쓰기 작업 중에 객체가 변경되지 않았는지 확인하는 데 사용되는 Etag입니다. etag가 비어 있으면 업데이트가 동시 변경사항을 덮어씁니다.
deploymentCount

integer

출력 전용입니다. 앱의 배포 수입니다.
clientCertificateSettings

object (ClientCertificateSettings)

선택사항입니다. 앱의 기본 클라이언트 인증서 설정입니다.
vpcScSettings

object (VpcScSettings)

선택사항입니다. 앱의 VPC-SC 설정입니다.
locked

boolean

선택사항입니다. 변경사항에 대해 앱이 잠겨 있는지 여부를 나타냅니다. 앱이 잠겨 있으면 앱 리소스 수정이 거부됩니다.
validationErrors[]

string

출력 전용입니다. 앱의 구성 오류 또는 경고
dashboardSettings

object (DashboardSettings)

선택사항입니다. Contact Center Insights 대시보드를 연결하고 구성하기 위한 앱별 대시보드 설정입니다.

LanguageSettings

JSON 표현 
{
  "defaultLanguageCode": string,
  "supportedLanguageCodes": [
    string
  ],
  "enableMultilingualSupport": boolean,
  "fallbackAction": string
}
필드
defaultLanguageCode

string

선택사항입니다. 앱의 기본 언어 코드입니다.
supportedLanguageCodes[]

string

선택사항입니다. default_language_code 외에 앱에서 지원하는 언어 코드 목록입니다.
enableMultilingualSupport

boolean

선택사항입니다. 다국어 지원을 사용 설정합니다. true인 경우 앱의 에이전트가 사전 빌드된 안내를 사용하여 다국어 입력 처리를 개선합니다.
fallbackAction
(deprecated)

string

선택사항입니다. 지원 중단됨: 이 기능은 더 이상 지원되지 않습니다. 대신 enable_multilingual_support를 사용하여 다국어 입력 처리를 개선하세요. 에이전트가 지원되지 않는 언어로 입력을 받을 때 수행할 작업입니다.

이는 사전 정의된 작업 또는 커스텀 도구 호출일 수 있습니다. 유효한 값은 다음과 같습니다. - 특정 도구 실행을 트리거하는 도구의 전체 리소스 이름 - '에스컬레이션' 또는 '종료'와 같은 사전 정의된 시스템 작업으로, 해당 metadata와 함께 EndSession 신호를 트리거하여 대화를 종료합니다.

TimeZoneSettings

JSON 표현 
{
  "timeZone": string
}
필드
timeZone

string

선택사항입니다. 시간대 데이터베이스에 등록된 앱의 시간대입니다(예: America/Los_Angeles, Europe/Paris).

AudioProcessingConfig

JSON 표현 
{
  "synthesizeSpeechConfigs": {
    string: {
      object (SynthesizeSpeechConfig)
    },
    ...
  },
  "bargeInConfig": {
    object (BargeInConfig)
  },
  "inactivityTimeout": string,
  "ambientSoundConfig": {
    object (AmbientSoundConfig)
  },
  "customVoiceSamples": [
    {
      object (CustomVoiceSample)
    }
  ]
}
필드
synthesizeSpeechConfigs

map (key: string, value: object (SynthesizeSpeechConfig))

선택사항입니다. 에이전트 응답을 합성하는 방법의 구성으로, 언어 코드를 SynthesizeSpeechConfig에 매핑합니다.

지정된 언어 코드의 구성을 찾을 수 없는 경우 루트 언어 코드의 구성이 사용됩니다. 예를 들어 맵에 'en-us' 및 'en'이 포함되어 있고 지정된 언어 코드가 'en-gb'인 경우 'en' 구성이 사용됩니다.

참고: 언어 코드는 대소문자를 구분하지 않습니다.

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

object (BargeInConfig)

선택사항입니다. 사용자 끼어들기 활동에 대한 에이전트 동작을 구성합니다.
inactivityTimeout

string (Duration format)

선택사항입니다. 에이전트가 사용자에게 재참여를 요청하기 전에 사용자가 비활성 상태(음성 또는 상호작용 없음)인 시간입니다. 설정하지 않으면 에이전트가 사용자에게 재참여를 요청하지 않습니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
ambientSoundConfig

object (AmbientSoundConfig)

선택사항입니다. 대화의 자연스러움을 향상하기 위해 합성된 에이전트 응답과 함께 재생할 주변 소리 구성입니다.
customVoiceSamples[]

object (CustomVoiceSample)

선택사항입니다. 음성 클론을 위한 커스텀 음성 샘플을 구성합니다.

SynthesizeSpeechConfigsEntry

JSON 표현 
{
  "key": string,
  "value": {
    object (SynthesizeSpeechConfig)
  }
}
필드
key

string
value

object (SynthesizeSpeechConfig)

SynthesizeSpeechConfig

JSON 표현 
{
  "voice": string,
  "speakingRate": number,
  "model": string,
  "instruction": string
}
필드
voice

string

선택사항. 음성 이름입니다. 설정하지 않으면 서비스에서 language_code와 같은 다른 매개변수를 기반으로 음성을 선택합니다.

사용 가능한 음성 목록은 Cloud Text-to-Speech의 지원되는 음성 및 언어를 참고하세요.
speakingRate

number

선택사항입니다. 말하기 속도/속도(범위: [0.25, 2.0])입니다. 1.0은 특정 음성에서 지원하는 일반적인 기본 속도입니다. 2.0은 기본 속도의 2배이며 0.5는 절반입니다. [0.25, 2.0] 범위를 벗어나는 값은 오류를 반환합니다.
model

string

선택사항입니다. 오디오를 합성하는 데 사용되는 모델입니다. 현재 지원되는 값은 'gemini-3.1-flash-tts-preview'입니다. 비어 있으면 Chirp3-HD가 사용됩니다.
instruction

string

선택사항입니다. 생성 모델을 사용할 때 음성을 합성하는 데 사용되는 요청 사항입니다.

BargeInConfig

JSON 표현 
{
  "disableBargeIn": boolean,
  "bargeInAwareness": boolean
}
필드
disableBargeIn
(deprecated)

boolean

선택사항입니다. 경고: ChannelProfile에서 disable_barge_in은 disable_barge_in_control로 대체되었습니다.

에이전트가 말하는 동안 사용자 끼어들기를 사용 중지합니다. true이면 에이전트 응답 재생 중 사용자 입력이 무시됩니다.
bargeInAwareness

boolean

선택사항입니다. 사용 설정하면 에이전트는 사용자가 이전 에이전트 메시지를 완전히 듣지 못했다고 가정하고 다음 대답을 조정합니다. 에이전트 응답이 시각적으로 표시되는 시나리오에서는 사용하면 안 됩니다.

소요 시간

JSON 표현 
{
  "seconds": string,
  "nanos": integer
}
필드
seconds

string (int64 format)

기간의 부호 있는 초입니다. -315,576,000,000~+315,576,000,000(포함) 사이여야 합니다. 참고: 이 경계는 60초/분 * 60분/시간 * 24시간/일 * 365.25일/년 * 10,000년으로 계산됩니다.
nanos

integer

기간의 나노초 단위로 부호가 있는 초수입니다. 1초 미만의 기간은 0 seconds 필드와 양수 또는 음수 nanos 필드로 표시됩니다. 1초 이상의 기간의 경우 nanos 필드의 0이 아닌 값은 seconds 필드와 동일한 부호여야 합니다. -999,999,999~+999,999,999(끝값 포함) 사이여야 합니다.

AmbientSoundConfig

JSON 표현 
{
  "volumeGainDb": number,

  // Union field source can be only one of the following:
  "prebuiltAmbientNoise": enum (PrebuiltAmbientNoise),
  "gcsUri": string,
  "prebuiltAmbientSound": string
  // End of list of possible types for union field source.
}
필드
volumeGainDb

number

선택사항입니다. 주변 소음에서 지원하는 일반 기본 볼륨의 볼륨 게인(dB)입니다. 범위는 [-96.0, 16.0]입니다. 값을 설정하지 않거나 0.0(dB)으로 설정하면 일반적인 기본 신호 진폭에서 재생됩니다. 값이 -6.0(dB)이면 일반적인 기본 신호 진폭의 약 절반에서 재생됩니다. 값이 +6.0(dB)이면 일반적인 기본 신호 진폭의 약 두 배에서 재생됩니다. +10(dB)을 초과하는 값을 사용하지 않는 것이 좋습니다. 값이 +10을 초과하면 일반적으로 소리가 커지는 효과가 없기 때문입니다.
통합 필드 source. 대화의 자연스러움을 향상시키기 위해 합성된 에이전트 응답과 함께 재생되는 주변 소음입니다. source은 다음 중 하나여야 합니다.
prebuiltAmbientNoise
(deprecated)

enum (PrebuiltAmbientNoise)

선택사항입니다. 지원 중단됨: prebuilt_ambient_noise는 지원 중단되고 prebuilt_ambient_sound로 대체됩니다.
gcsUri

string

선택사항입니다. Cloud Storage에 저장된 모노 채널, 16kHz WAV 파일 형식의 주변 소음

참고: CES 서비스 에이전트 service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com에 Cloud Storage 객체에 대한 storage.objects.get 권한이 있는지 확인하세요.
prebuiltAmbientSound

string

선택사항입니다. 사전 제작된 주변 소리의 이름입니다. 유효한 값은 'coffee_shop', 'keyboard', 'keypad', 'hum', 'office_1', 'office_2', 'office_3', 'room_1', 'room_2', 'room_3', 'room_4', 'room_5', 'air_conditioner'입니다.

CustomVoiceSample

JSON 표현 
{
  "name": string,
  "voiceSampleGcsUri": string,
  "consentAudioGcsUri": string,
  "voiceInstruction": string,
  "previewAudioContent": string,
  "previewText": string,
  "warnings": [
    {
      object (Warning)
    }
  ],
  "voiceInstructionMode": enum (VoiceInstructionMode)
}
필드
name

string

선택사항입니다. 커스텀 음성 샘플의 사용자 정의 이름입니다.
voiceSampleGcsUri

string

선택사항입니다. 음성 클론을 위한 오디오 샘플의 Cloud Storage URI입니다. 오디오 샘플은 모노 채널, 24kHz WAV 파일이어야 합니다.
consentAudioGcsUri

string

선택사항입니다. 음성 클론에 대한 동의 오디오입니다.
voiceInstruction

string

선택사항입니다. 음성 스타일, 어조, 속도 또는 발음에 대한 자연어 안내입니다.
previewAudioContent

string (bytes format)

출력 전용입니다. 커스텀 음성을 위해 합성된 프리뷰 오디오로, 표준 WAV(LINEAR16, 24kHz, 16비트, 모노) 형식입니다.

base64 인코딩 문자열입니다.
previewText

string

선택사항입니다. 커스텀 음성의 미리보기 오디오를 합성하기 위한 텍스트입니다.
warnings[]

object (Warning)

출력 전용입니다. 음성 클론 처리 중에 발생한 경고 메시지입니다(예: 낮은 오디오 수준).
voiceInstructionMode

enum (VoiceInstructionMode)

선택사항입니다. 음성 샘플의 요청 사항 모드입니다. 지정하지 않으면 기본값은 NO_INSTRUCTION입니다.

경고

JSON 표현 
{
  "message": string,
  "type": enum (WarningType)
}
필드
message

string

출력 전용입니다. 인간이 읽을 수 있는 경고 설명입니다.
type

enum (WarningType)

출력 전용입니다. 경고 유형입니다.

LoggingSettings

JSON 표현 
{
  "redactionConfig": {
    object (RedactionConfig)
  },
  "audioRecordingConfig": {
    object (AudioRecordingConfig)
  },
  "unredactedAudioRecordingConfig": {
    object (AudioRecordingConfig)
  },
  "bigqueryExportSettings": {
    object (BigQueryExportSettings)
  },
  "unredactedBigqueryExportSettings": {
    object (BigQueryExportSettings)
  },
  "cloudLoggingSettings": {
    object (CloudLoggingSettings)
  },
  "conversationLoggingSettings": {
    object (ConversationLoggingSettings)
  },
  "evaluationAudioRecordingConfig": {
    object (AudioRecordingConfig)
  },
  "metricAnalysisSettings": {
    object (MetricAnalysisSettings)
  },
  "requiredRecordingConsent": boolean
}
필드
redactionConfig

object (RedactionConfig)

선택사항입니다. 민감한 정보를 수정하는 방법에 대한 구성입니다.
audioRecordingConfig

object (AudioRecordingConfig)

선택사항입니다. 오디오 상호작용을 기록하는 방법에 대한 구성입니다. 오디오는 RedactionConfig에 구성된 대로 수정됩니다.
unredactedAudioRecordingConfig

object (AudioRecordingConfig)

선택사항입니다. 수정되지 않은 오디오의 추가 녹음을 구성합니다. 이는 오디오 수정이 enabled일 때 원시 오디오 사본을 유지하는 데 사용할 수 있으며, 일반적으로 감사 또는 모니터링 목적으로 사용됩니다.
bigqueryExportSettings

object (BigQueryExportSettings)

선택사항입니다. 앱의 BigQuery Export 동작을 구성합니다. 대화 데이터는 RedactionConfig에 구성된 대로 수정됩니다.
unredactedBigqueryExportSettings

object (BigQueryExportSettings)

선택사항입니다. 앱의 BigQuery 내보내기 동작을 구성합니다. 사용 설정하면 수정되지 않은 대화 데이터가 BigQuery 테이블로 내보내집니다.
cloudLoggingSettings

object (CloudLoggingSettings)

선택사항입니다. 앱의 Cloud Logging 동작을 설명하는 설정입니다.
conversationLoggingSettings

object (ConversationLoggingSettings)

선택사항입니다. 앱의 대화 로깅 동작을 설명하는 설정입니다.
evaluationAudioRecordingConfig

object (AudioRecordingConfig)

선택사항입니다. 평가를 위해 오디오 상호작용을 녹음하는 방법에 대한 구성입니다. 기본적으로 평가 세션에는 오디오 녹음이 사용 설정되지 않습니다.
metricAnalysisSettings

object (MetricAnalysisSettings)

선택사항입니다. 앱의 LLM 분석 파이프라인에 대한 대화 데이터 수집 동작을 설명하는 설정입니다.
requiredRecordingConsent

boolean

선택사항입니다. 앱이 녹음될 수 있는 내용을 말해야 하는지 여부

true인 경우 세션은 녹음이 사용 중지된 상태로 시작되며 클라이언트가 SessionInput.recording_control를 전송할 때까지 사용 중지된 상태로 유지됩니다. 이 시점부터는 모든 차례가 결정됩니다. 여기에는 오디오 녹음, 대화 기록, BigQuery Export, Cloud Logging이 포함됩니다.

기본값인 false인 경우 위의 설정이 자체적으로 결정되며 클라이언트는 아무것도 전송할 필요가 없습니다.

RedactionConfig

JSON 표현 
{
  "enableRedaction": boolean,
  "inspectTemplate": string,
  "deidentifyTemplate": string
}
필드
enableRedaction

boolean

선택사항입니다. true인 경우 대화 기록, Cloud Logging, 오디오 녹음 등 다양한 로깅 시나리오에 수정이 적용됩니다.
inspectTemplate

string

선택사항입니다. 민감한 정보 유형 감지를 구성하는 DLP 검사 템플릿 이름입니다.

형식: projects/{project}/locations/{location}/inspectTemplates/{inspect_template}
deidentifyTemplate

string

선택사항입니다. 콘텐츠를 익명화하는 방법을 지정하는 DLP 익명화 템플릿 이름입니다.

형식: projects/{project}/locations/{location}/deidentifyTemplates/{deidentify_template}

AudioRecordingConfig

JSON 표현 
{
  "gcsBucket": string,
  "gcsPathPrefix": string
}
필드
gcsBucket

string

선택사항입니다. 세션 오디오 녹음을 저장할 Cloud Storage 버킷입니다. URI는 'gs://'로 시작해야 합니다.

데이터 레지던시 요구사항을 충족하는 버킷 위치를 선택하세요.

참고: Cloud Storage 버킷이 앱과 다른 프로젝트에 있는 경우 CES 서비스 에이전트 service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com에 storage.objects.create 권한을 부여해야 합니다.
gcsPathPrefix

string

선택사항입니다. 오디오 녹음 파일의 Cloud Storage 경로 프리픽스입니다.

이 프리픽스에는 다음 자리표시자가 포함될 수 있으며, 이 자리표시자는 서빙 시점에 동적으로 대체됩니다. - $project: 프로젝트 ID - $location: 앱 위치 - $app: 앱 ID - $date: YYYY-MM-DD 형식의 세션 날짜 - $session: 세션 ID

경로 프리픽스를 지정하지 않으면 기본 프리픽스 $project/$location/$app/$date/$session/가 사용됩니다.

BigQueryExportSettings

JSON 표현 
{
  "enabled": boolean,
  "project": string,
  "dataset": string
}
필드
enabled

boolean

선택사항입니다. BigQuery Export가 사용 설정되어 있는지 여부를 나타냅니다.
project

string

선택사항입니다. 데이터를 내보낼 BigQuery 데이터 세트의 프로젝트 ID입니다.

참고: BigQuery 데이터 세트가 앱과 다른 프로젝트에 있는 경우 CES 서비스 에이전트 service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com에 roles/bigquery.admin 역할을 부여해야 합니다.
dataset

string

선택사항입니다. 데이터를 내보낼 BigQuery 데이터 세트 ID입니다.

CloudLoggingSettings

JSON 표현 
{
  "enableCloudLogging": boolean
}
필드
enableCloudLogging

boolean

선택사항입니다. 세션에 Cloud Logging을 사용 설정할지 여부입니다.

ConversationLoggingSettings

JSON 표현 
{
  "disableConversationLogging": boolean,
  "retentionWindow": string
}
필드
disableConversationLogging

boolean

선택사항입니다. 세션의 대화 로깅을 사용 중지할지 여부입니다.
retentionWindow

string (Duration format)

선택사항입니다. 대화의 보관 기간을 제어합니다. 설정하지 않으면 대화가 365일 동안 보관됩니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

MetricAnalysisSettings

JSON 표현 
{
  "llmMetricsOptedOut": boolean
}
필드
llmMetricsOptedOut

boolean

선택사항입니다. LLM 분석 측정항목의 대화 데이터를 수집할지 여부입니다. true이면 LLM 분석 측정항목에 대한 대화 데이터가 수집되지 않습니다. 그렇지 않으면 대화 데이터가 수집됩니다.

ErrorHandlingSettings

JSON 표현 
{
  "errorHandlingStrategy": enum (ErrorHandlingStrategy),
  "fallbackResponseConfig": {
    object (FallbackResponseConfig)
  },
  "endSessionConfig": {
    object (EndSessionConfig)
  }
}
필드
errorHandlingStrategy

enum (ErrorHandlingStrategy)

선택사항입니다. 오류 처리에 사용할 전략입니다.
fallbackResponseConfig

object (FallbackResponseConfig)

선택사항입니다. 대체 응답을 처리하기 위한 구성입니다.
endSessionConfig

object (EndSessionConfig)

선택사항입니다. 시스템 오류(예: LLM 오류)가 발생할 경우 세션을 종료하기 위한 구성입니다.

FallbackResponseConfig

JSON 표현 
{
  "customFallbackMessages": {
    string: string,
    ...
  },
  "maxFallbackAttempts": integer
}
필드
customFallbackMessages

map (key: string, value: string)

선택사항입니다. 시스템 오류(예: LLM 오류)가 발생할 경우의 대체 메시지이며 지원되는 언어 코드로 매핑됩니다.

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

integer

선택사항입니다. 에이전트가 EndSession 신호를 내보내기 전에 시도할 최대 대체 시도 횟수입니다.

CustomFallbackMessagesEntry

JSON 표현 
{
  "key": string,
  "value": string
}
필드
key

string
value

string

EndSessionConfig

JSON 표현 
{

  // Union field _escalate_session can be only one of the following:
  "escalateSession": boolean
  // End of list of possible types for union field _escalate_session.
}
필드

통합 필드 _escalate_session.

_escalate_session는 다음 중 하나여야 합니다.
escalateSession

boolean

선택사항입니다. EndSession에서 세션을 에스컬레이션할지 여부 세션이 에스컬레이션되면 metadata in EndSession에 session_escalated = true이 포함됩니다. 자세한 내용은 https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/deploy/google-telephony-platform#transfer_a_call_to_a_human_agent를 참고하세요.

ModelSettings

JSON 표현 
{
  "model": string,
  "thinkingLevel": enum (ThinkingLevel),

  // Union field _temperature can be only one of the following:
  "temperature": number
  // End of list of possible types for union field _temperature.
}
필드
model

string

선택사항입니다. 에이전트가 사용해야 하는 LLM 모델입니다. 설정하지 않으면 에이전트가 상위 에이전트에서 모델을 상속합니다.
thinkingLevel

enum (ThinkingLevel)

선택사항입니다. 모델의 사고 수준입니다.

통합 필드 _temperature.

_temperature는 다음 중 하나여야 합니다.
temperature

number

선택사항입니다. 설정하면 이 온도가 LLM 모델에 사용됩니다. 온도는 모델 응답의 무작위성을 제어합니다. 온도가 낮을수록 더 예측 가능한 대답이 생성됩니다. 온도가 높을수록 더 창의적인 대답이 생성됩니다.

EvaluationMetricsThresholds

JSON 표현 
{
  "goldenEvaluationMetricsThresholds": {
    object (GoldenEvaluationMetricsThresholds)
  },
  "hallucinationMetricBehavior": enum (HallucinationMetricBehavior),
  "goldenHallucinationMetricBehavior": enum (HallucinationMetricBehavior),
  "scenarioHallucinationMetricBehavior": enum (HallucinationMetricBehavior)
}
필드
goldenEvaluationMetricsThresholds

object (GoldenEvaluationMetricsThresholds)

선택사항입니다. 골든 평가 측정항목 기준점입니다.
hallucinationMetricBehavior
(deprecated)

enum (HallucinationMetricBehavior)

선택사항입니다. 지원 중단됨: 대신 golden_hallucination_metric_behavior를 사용하세요. 할루시네이션 측정항목 동작은 현재 골든 평가에 사용됩니다.
goldenHallucinationMetricBehavior

enum (HallucinationMetricBehavior)

선택사항입니다. 골든 평가의 할루시네이션 측정항목 동작입니다.
scenarioHallucinationMetricBehavior

enum (HallucinationMetricBehavior)

선택사항입니다. 시나리오 평가의 할루시네이션 측정항목 동작입니다.

GoldenEvaluationMetricsThresholds

JSON 표현 
{
  "turnLevelMetricsThresholds": {
    object (TurnLevelMetricsThresholds)
  },
  "expectationLevelMetricsThresholds": {
    object (ExpectationLevelMetricsThresholds)
  },
  "toolMatchingSettings": {
    object (ToolMatchingSettings)
  }
}
필드
turnLevelMetricsThresholds

object (TurnLevelMetricsThresholds)

선택사항입니다. 대화 수준 측정항목 기준입니다.
expectationLevelMetricsThresholds

object (ExpectationLevelMetricsThresholds)

선택사항입니다. 기대치 수준 측정항목 기준점입니다.
toolMatchingSettings

object (ToolMatchingSettings)

선택사항입니다. 도구 일치 설정입니다. 추가 도구 호출은 실행에 있지만 골든 기대치의 도구 호출과 일치하지 않는 도구 호출입니다.

TurnLevelMetricsThresholds

JSON 표현 
{
  "semanticSimilarityChannel": enum (SemanticSimilarityChannel),

  // Union field _semantic_similarity_success_threshold can be only one of the
  // following:
  "semanticSimilaritySuccessThreshold": integer
  // End of list of possible types for union field
  // _semantic_similarity_success_threshold.

  // Union field _overall_tool_invocation_correctness_threshold can be only one
  // of the following:
  "overallToolInvocationCorrectnessThreshold": number
  // End of list of possible types for union field
  // _overall_tool_invocation_correctness_threshold.
}
필드
semanticSimilarityChannel

enum (SemanticSimilarityChannel)

선택사항입니다. 평가에 사용할 시맨틱 유사성 채널입니다.

통합 필드 _semantic_similarity_success_threshold.

_semantic_similarity_success_threshold는 다음 중 하나여야 합니다.
semanticSimilaritySuccessThreshold

integer

선택사항입니다. 의미론적 유사도의 성공 기준입니다. 0에서 4 사이의 정수여야 합니다. 기본값은 3 이상입니다.

통합 필드 _overall_tool_invocation_correctness_threshold.

_overall_tool_invocation_correctness_threshold는 다음 중 하나여야 합니다.
overallToolInvocationCorrectnessThreshold

number

선택사항입니다. 전체 도구 호출 정확성의 성공 기준점입니다. 0에서 1 사이의 부동 소수점 수여야 합니다. 기본값은 1.0입니다.

ExpectationLevelMetricsThresholds

JSON 표현 
{

  // Union field _tool_invocation_parameter_correctness_threshold can be only one
  // of the following:
  "toolInvocationParameterCorrectnessThreshold": number
  // End of list of possible types for union field
  // _tool_invocation_parameter_correctness_threshold.
}
필드

통합 필드 _tool_invocation_parameter_correctness_threshold.

_tool_invocation_parameter_correctness_threshold는 다음 중 하나여야 합니다.
toolInvocationParameterCorrectnessThreshold

number

선택사항입니다. 개별 도구 호출 매개변수 정확성의 성공 기준점입니다. 0에서 1 사이의 부동 소수점 수여야 합니다. 기본값은 1.0입니다.

ToolMatchingSettings

JSON 표현 
{
  "extraToolCallBehavior": enum (ExtraToolCallBehavior)
}
필드
extraToolCallBehavior

enum (ExtraToolCallBehavior)

선택사항입니다. 추가 도구 호출의 동작입니다. 기본값은 FAIL입니다.

VariableDeclaration

JSON 표현 
{
  "name": string,
  "description": string,
  "schema": {
    object (Schema)
  }
}
필드
name

string

필수 항목입니다. 변수 이름입니다. 이름은 영문자 또는 밑줄로 시작해야 하며 영문자, 숫자, 밑줄만 포함해야 합니다.
description

string

필수 항목입니다. 변수에 대한 설명입니다.
schema

object (Schema)

필수 항목입니다. 변수의 스키마입니다.

스키마

JSON 표현 
{
  "type": enum (Type),
  "properties": {
    string: {
      object (Schema)
    },
    ...
  },
  "required": [
    string
  ],
  "description": string,
  "items": {
    object (Schema)
  },
  "nullable": boolean,
  "uniqueItems": boolean,
  "prefixItems": [
    {
      object (Schema)
    }
  ],
  "additionalProperties": {
    object (Schema)
  },
  "anyOf": [
    {
      object (Schema)
    }
  ],
  "enum": [
    string
  ],
  "default": value,
  "ref": string,
  "defs": {
    string: {
      object (Schema)
    },
    ...
  },
  "title": string,
  "minItems": string,
  "maxItems": string,

  // Union field _minimum can be only one of the following:
  "minimum": number
  // End of list of possible types for union field _minimum.

  // Union field _maximum can be only one of the following:
  "maximum": number
  // End of list of possible types for union field _maximum.
}
필드
type

enum (Type)

필수 항목입니다. 데이터 유형입니다.
properties

map (key: string, value: object (Schema))

선택사항입니다. Type.OBJECT의 속성입니다.

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

string

선택사항입니다. Type.OBJECT의 필수 속성입니다.
description

string

선택사항입니다. 데이터의 설명입니다.
items

object (Schema)

선택사항입니다. Type.ARRAY 요소의 스키마입니다.
nullable

boolean

선택사항입니다. null 값을 나타냅니다.
uniqueItems

boolean

선택사항입니다. 배열의 항목이 고유해야 함을 나타냅니다. TYPE.ARRAY에만 적용됩니다.
prefixItems[]

object (Schema)

선택사항입니다. Type.ARRAY의 초기 요소 스키마입니다.
additionalProperties

object (Schema)

선택사항입니다. 불리언 또는 객체일 수 있으며 추가 속성의 존재를 제어합니다.
anyOf[]

object (Schema)

선택사항입니다. 값은 목록의 하위 스키마 중 하나 이상에 대해 검증되어야 합니다.
enum[]

string

선택사항입니다. enum 형식의 기본 유형 요소의 가능한 값입니다. 예: 1. 방향을 {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]}로 정의할 수 있습니다. 2. 아파트 번호를 {type:INTEGER, format:enum, enum:["101", "201", "301"]}로 정의할 수 있습니다.
default

value (Value format)

선택사항입니다. 데이터의 기본값입니다.
ref

string

선택사항입니다. 스키마 노드 간의 간접 참조를 허용합니다. 값은 루트 defs의 하위 요소에 대한 유효한 참조여야 합니다.

예를 들어 다음 스키마는 'Pet'이라는 스키마 노드에 대한 참조를 정의합니다.

type: object
properties:
  pet:
    ref: #/defs/Pet
defs:
  Pet:
    type: object
    properties:
      name:
        type: string

'pet' 속성의 값은 'Pet'이라는 스키마 노드에 대한 참조입니다. 자세한 내용은 https://json-schema.org/understanding-json-schema/structuring을 참고하세요.
defs

map (key: string, value: object (Schema))

선택사항입니다. ref에서 사용할 정의의 맵입니다. 스키마의 루트에서만 허용됩니다.

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

string

선택사항입니다. 스키마의 제목입니다.
minItems

string (int64 format)

선택사항입니다. Type.ARRAY의 최소 요소 수입니다.
maxItems

string (int64 format)

선택사항입니다. Type.ARRAY의 최대 요소 수입니다.

통합 필드 _minimum.

_minimum는 다음 중 하나여야 합니다.
minimum

number

선택사항입니다. Type.INTEGER 및 Type.NUMBER의 최솟값입니다.

통합 필드 _maximum.

_maximum는 다음 중 하나여야 합니다.
maximum

number

선택사항입니다. Type.INTEGER 및 Type.NUMBER의 최댓값입니다.

PropertiesEntry

JSON 표현 
{
  "key": string,
  "value": {
    object (Schema)
  }
}
필드
key

string
value

object (Schema)

값

JSON 표현 
{

  // Union field kind can be only one of the following:
  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
  // End of list of possible types for union field kind.
}
필드
통합 필드 kind. 값의 종류입니다. kind은 다음 중 하나여야 합니다.
nullValue

null

JSON null을 나타냅니다.
numberValue

number

JSON 숫자를 나타냅니다. JSON에서 지원되지 않으므로 NaN, Infinity 또는 -Infinity가 아니어야 합니다. 또한 JSON 형식은 일반적으로 숫자 유형에서 큰 Int64 값을 지원하지 않으므로 이를 표현할 수 없습니다.
stringValue

string

JSON 문자열을 나타냅니다.
boolValue

boolean

JSON 불리언(JSON의 true 또는 false 리터럴)을 나타냅니다.
structValue

object (Struct format)

JSON 객체를 나타냅니다.
listValue

array (ListValue format)

JSON 배열을 나타냅니다.

구조체

JSON 표현 
{
  "fields": {
    string: value,
    ...
  }
}
필드
fields

map (key: string, value: value (Value format))

동적으로 입력된 값의 정렬되지 않은 맵입니다.

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

FieldsEntry

JSON 표현 
{
  "key": string,
  "value": value
}
필드
key

string
value

value (Value format)

ListValue

JSON 표현 
{
  "values": [
    value
  ]
}
필드
values[]

value (Value format)

동적으로 입력된 값의 반복 필드입니다.

DefsEntry

JSON 표현 
{
  "key": string,
  "value": {
    object (Schema)
  }
}
필드
key

string
value

object (Schema)

DataStoreSettings

JSON 표현 
{
  "engines": [
    {
      object (Engine)
    }
  ]
}
필드
engines[]

object (Engine)

출력 전용입니다. 앱의 엔진입니다.

엔진

JSON 표현 
{
  "name": string,
  "type": enum (Type)
}
필드
name

string

출력 전용입니다. 엔진의 리소스 이름입니다. 형식: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}
type

enum (Type)

출력 전용입니다. 엔진 유형입니다.

ChannelProfile

JSON 표현 
{
  "profileId": string,
  "channelType": enum (ChannelType),
  "personaProperty": {
    object (PersonaProperty)
  },
  "webWidgetConfig": {
    object (WebWidgetConfig)
  },
  "whatsappConfig": {
    object (WhatsAppConfig)
  },
  "instagramConfig": {
    object (InstagramConfig)
  },

  // Union field _disable_dtmf can be only one of the following:
  "disableDtmf": boolean
  // End of list of possible types for union field _disable_dtmf.

  // Union field _disable_barge_in_control can be only one of the following:
  "disableBargeInControl": boolean
  // End of list of possible types for union field _disable_barge_in_control.

  // Union field _noise_suppression_level can be only one of the following:
  "noiseSuppressionLevel": string
  // End of list of possible types for union field _noise_suppression_level.
}
필드
profileId

string

선택사항입니다. 채널 프로필의 고유 식별자입니다.
channelType

enum (ChannelType)

선택사항입니다. 채널 프로필의 유형입니다.
personaProperty

object (PersonaProperty)

선택사항입니다. 채널 프로필의 캐릭터 속성입니다.
webWidgetConfig

object (WebWidgetConfig)

선택사항입니다. 웹 위젯의 구성입니다.
whatsappConfig

object (WhatsAppConfig)

선택사항입니다. WhatsApp 배포와 관련된 구성입니다.
instagramConfig

object (InstagramConfig)

선택사항입니다. Instagram 배포와 관련된 구성입니다.

통합 필드 _disable_dtmf.

_disable_dtmf는 다음 중 하나여야 합니다.
disableDtmf

boolean

선택사항입니다. DTMF(이중 톤 다중 주파수)를 사용 중지할지 여부입니다.

통합 필드 _disable_barge_in_control.

_disable_barge_in_control는 다음 중 하나여야 합니다.
disableBargeInControl

boolean

선택사항입니다. 대화에서 사용자 끼어들기 제어를 사용 중지할지 여부입니다. - true: 에이전트가 말하는 동안 사용자 중단이 사용 중지됩니다. - false: 에이전트가 사용자가 중단할 수 있는 시점을 자동으로 제어합니다.

통합 필드 _noise_suppression_level.

_noise_suppression_level는 다음 중 하나여야 합니다.
noiseSuppressionLevel

string

선택사항입니다. 채널 프로필의 노이즈 제거 수준입니다. 사용 가능한 값은 'low', 'moderate', 'high', 'very_high'입니다.

PersonaProperty

JSON 표현 
{
  "persona": enum (Persona)
}
필드
persona

enum (Persona)

선택사항입니다. 채널의 페르소나

WebWidgetConfig

JSON 표현 
{
  "modality": enum (Modality),
  "theme": enum (Theme),
  "webWidgetTitle": string,
  "securitySettings": {
    object (SecuritySettings)
  }
}
필드
modality

enum (Modality)

선택사항입니다. 웹 위젯의 형식입니다.
theme

enum (Theme)

선택사항입니다. 웹 위젯의 테마입니다.
webWidgetTitle

string

선택사항입니다. 웹 위젯의 제목입니다.
securitySettings

object (SecuritySettings)

선택사항입니다. 웹 위젯의 보안 설정입니다.

SecuritySettings

JSON 표현 
{
  "enablePublicAccess": boolean,
  "enableOriginCheck": boolean,
  "allowedOrigins": [
    string
  ],
  "enableRecaptcha": boolean
}
필드
enablePublicAccess

boolean

선택사항입니다. 웹 위젯에 대한 공개 액세스가 사용 설정되었는지 여부를 나타냅니다. true인 경우 웹 위젯에 공개적으로 액세스할 수 있습니다. false인 경우 웹 위젯은 CES 에이전트에 액세스하기 위한 유효한 사용자 인증 정보를 반환하기 위해 자체 인증 및 승인 시스템과 통합되어야 합니다.
enableOriginCheck

boolean

선택사항입니다. 웹 위젯의 출처 확인이 사용 설정되었는지 여부를 나타냅니다. true인 경우 웹 위젯은 웹 위젯을 로드하는 웹사이트의 출처를 확인하고 동일한 출처 또는 허용된 출처에서만 로드되도록 허용합니다.
allowedOrigins[]

string

선택사항입니다. 웹 위젯을 호스팅할 수 있는 출처입니다. 출처는 RFC 6454에 의해 정의됩니다. 비어 있으면 모든 출처가 허용됩니다. 출처는 최대 100개까지 허용됩니다. 예: 'https://example.com'
enableRecaptcha

boolean

선택사항입니다. 웹 위젯의 reCAPTCHA 인증이 사용 설정되어 있는지 여부를 나타냅니다.

WhatsAppConfig

JSON 표현 
{
  "wabaId": string,
  "phoneNumberId": string,
  "phoneNumber": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
필드
wabaId

string

필수 항목입니다. WhatsApp Business 계정 ID입니다.
phoneNumberId

string

필수 항목입니다. Meta 전화번호 ID입니다.
phoneNumber

string

선택사항입니다. E.164 형식의 전화번호입니다.
displayName

string

출력 전용입니다. 가져온 Meta 비즈니스 페이지 이름입니다.
thumbnailUrl

string

출력 전용입니다. 가져온 메타 비즈니스 프로필 썸네일 URL입니다.
description

string

출력 전용입니다. 메타 비즈니스 페이지 또는 프로필에 대한 설명입니다.

InstagramConfig

JSON 표현 
{
  "instagramAccountId": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
필드
instagramAccountId

string

필수 항목입니다. Instagram 계정 ID입니다.
displayName

string

출력 전용입니다. 가져온 Meta 비즈니스 페이지 이름입니다.
thumbnailUrl

string

출력 전용입니다. 가져온 메타 비즈니스 프로필 썸네일 URL입니다.
description

string

출력 전용입니다. 메타 비즈니스 페이지 또는 프로필에 대한 설명입니다.

MetadataEntry

JSON 표현 
{
  "key": string,
  "value": string
}
필드
key

string
value

string

타임스탬프

JSON 표현 
{
  "seconds": string,
  "nanos": integer
}
필드
seconds

string (int64 format)

유닉스 시간 1970-01-01T00:00:00Z 이후 경과된 UTC 시간을 초 단위로 나타냅니다. -62135596800~253402300799(양 끝값 포함) 사이여야 합니다(0001-01-01T00:00:00Z~9999-12-31T23:59:59Z에 해당).
nanos

integer

나노초 단위의 음수가 아닌 초수입니다. 이 필드는 기간의 나노초 부분이며 초를 대체하지 않습니다. 음수의 초수 값에는 시간에 반영되는 음수가 아닌 나노초 값이 있어야 합니다. 0~999,999,999(포함) 사이여야 합니다.

ClientCertificateSettings

JSON 표현 
{
  "tlsCertificate": string,
  "privateKey": string,
  "passphrase": string
}
필드
tlsCertificate

string

필수 항목입니다. PEM 형식으로 인코딩된 TLS 인증서입니다. 이 문자열에는 시작 헤더와 끝 바닥글 줄이 포함되어야 합니다.
privateKey

string

필수 항목입니다. PEM 형식으로 인코딩된 비공개 키를 저장하는 SecretManager 보안 비밀 버전 리소스의 이름입니다. 형식: projects/{project}/secrets/{secret}/versions/{version}
passphrase

string

선택사항입니다. 비공개 키를 복호화하는 암호를 저장하는 SecretManager 보안 비밀 버전 리소스의 이름입니다. 비공개 키가 암호화되지 않은 경우 설정하지 않은 상태로 두어야 합니다. 형식: projects/{project}/secrets/{secret}/versions/{version}

VpcScSettings

JSON 표현 
{
  "allowedOrigins": [
    string
  ]
}
필드
allowedOrigins[]

string

선택사항입니다. VPC 서비스 제어가 사용 설정된 경우 앱의 OpenAPI 도구가 직접 호출할 수 있는 허용된 HTTP(S) 출처입니다. 이 문자열은 포트가 지정된 경우 포트를 포함하여 출처와 정확히 일치해야 합니다. 예를 들면 'https://example.com' 또는 'https://example.com:443'입니다. 이 목록은 직접 HTTP 호출을 수행할 수 있는 Python 도구에는 아직 적용되지 않습니다.

DashboardSettings

JSON 표현 
{
  "defaultDashboard": string
}
필드
defaultDashboard

string

선택사항입니다. 앱과 연결된 기본 Contact Center Insights 대시보드의 리소스 이름입니다. 사용자가 앱의 모니터링 뷰로 이동할 때 표시되는 대시보드입니다.

형식: projects/{project}/locations/{location}/dashboards/{dashboard}

PrebuiltAmbientNoise

사전 빌드된 주변 소음

열거형
PREBUILT_AMBIENT_NOISE_UNSPECIFIED 지정되지 않음
RETAIL_STORE 소매점의 주변 소음
CONVENTION_HALL 컨벤션 홀의 주변 소음
OUTDOOR 거리의 주변 소음

WarningType

음성 샘플 처리 중에 발생한 경고 유형입니다.

열거형
WARNING_TYPE_UNSPECIFIED 지정되지 않은 경고 유형입니다.
LOW_AUDIO_LEVEL 음성 샘플의 오디오 수준이 너무 낮습니다(예: 낮은 RMS 진폭).

VoiceInstructionMode

음성 샘플의 요청 사항 모드입니다.

열거형
VOICE_INSTRUCTION_MODE_UNSPECIFIED 지정되지 않은 안내 모드입니다. 기본값은 NO_INSTRUCTION입니다.
NO_INSTRUCTION 음성 안내가 사용되지 않습니다.
GENERATE_INSTRUCTION AI가 오디오 샘플을 기반으로 음성 안내를 자동으로 생성합니다.
CUSTOM_INSTRUCTION 사용자가 제공한 맞춤 음성 안내입니다.

ErrorHandlingStrategy

오류 처리 전략을 정의합니다.

열거형
ERROR_HANDLING_STRATEGY_UNSPECIFIED 지정되지 않은 오류 처리 전략입니다.
NONE 특정 처리가 사용 설정되지 않았습니다.
FALLBACK_RESPONSE 시스템 오류(예: LLM 오류)가 발생하면 대체 메시지가 사용자에게 반환됩니다.
END_SESSION 시스템 오류(예: LLM 오류)가 발생하면 EndSession 신호가 전송됩니다.

ThinkingLevel

모델의 사고 수준 구성입니다.

열거형
THINKING_LEVEL_UNSPECIFIED 사고 수준이 지정되지 않았습니다.
DEFAULT 기본 사고 수준입니다.
LOW 낮은 사고 수준
MEDIUM 중간 수준의 사고
HIGH 높은 수준의 사고

ToolExecutionMode

에이전트가 동시에 여러 도구를 선택하는 경우 도구 실행 동작을 정의합니다.

열거형
TOOL_EXECUTION_MODE_UNSPECIFIED 지정되지 않은 도구 실행 모드입니다. 기본값은 PARALLEL입니다.
PARALLEL 여러 도구가 선택되면 동일한 ToolContext를 사용하여 동시에 실행됩니다.
SEQUENTIAL 여러 도구가 선택된 경우 순차적으로 실행됩니다. 다음 도구는 이전 도구가 완료된 후에만 실행되며 이전 도구에서 업데이트된 ToolContext를 볼 수 있습니다.

SemanticSimilarityChannel

사용할 시맨틱 유사성 채널입니다.

열거형
SEMANTIC_SIMILARITY_CHANNEL_UNSPECIFIED 측정항목이 지정되지 않았습니다. 기본값은 TEXT입니다.
TEXT 텍스트 시맨틱 유사성을 사용합니다.
AUDIO 오디오 시맨틱 유사성을 사용합니다.

ExtraToolCallBehavior

추가 도구 호출이 발생할 때의 동작을 정의합니다. 추가 도구 호출은 실행에 있지만 골든 기대치의 도구 호출과 일치하지 않는 도구 호출입니다.

열거형
EXTRA_TOOL_CALL_BEHAVIOR_UNSPECIFIED 지정되지 않은 동작입니다. 기본값은 FAIL입니다.
FAIL 추가 도구 호출이 발생하면 평가에 실패합니다.
ALLOW 추가 도구 호출을 허용합니다.

HallucinationMetricBehavior

할루시네이션 측정항목 동작입니다. 동작과 관계없이 측정항목은 항상 계산됩니다. 차이점은 사용 중지하면 측정항목이 전체 평가 점수를 계산하는 데 사용되지 않는다는 것입니다.

열거형
HALLUCINATION_METRIC_BEHAVIOR_UNSPECIFIED 지정되지 않은 할루시네이션 측정항목 동작입니다.
DISABLED 할루시네이션 측정항목을 사용 중지합니다.
ENABLED 할루시네이션 측정항목을 사용 설정합니다.

유형

OpenAPI 데이터 유형

열거형
TYPE_UNSPECIFIED 유형이 지정되지 않습니다.
STRING 문자열 유형입니다.
INTEGER 정수 유형입니다.
NUMBER 숫자 유형입니다.
BOOLEAN 불리언 유형입니다.
OBJECT 객체 유형입니다.
ARRAY 배열 유형입니다.

NullValue

JSON null을 나타냅니다.

NullValue는 센티널로, 값이 하나만 있는 enum을 사용하여 Value 유형 공용체의 null 값을 나타냅니다.

0 이외의 값이 있는 NullValue 유형의 필드는 잘못된 것으로 간주됩니다. 대부분의 ProtoJSON 직렬 변환기는 정수 값과 관계없이 JSON null로 설정된 null_value가 있는 Value를 내보내므로 0 값으로 왕복합니다.

열거형
NULL_VALUE null 값입니다.

유형

엔진 유형입니다. https://cloud.google.com/generative-ai-app-builder/docs/reference/rest/v1/SolutionType 및 https://cloud.google.com/generative-ai-app-builder/docs/create-datastore-ingest에서 제공되는 문서를 참조하세요.

열거형
TYPE_UNSPECIFIED 지정되지 않은 엔진 유형입니다.
ENGINE_TYPE_CHAT 채팅 엔진 유형입니다. 앱의 SOLUTION_TYPE_CHAT 엔진입니다. 앱에 추가된 모든 커넥터 데이터 스토어가 이 엔진에 추가됩니다.

ChannelType

채널 프로필의 유형입니다.

열거형
UNKNOWN 알 수 없는 채널 유형입니다.
WEB_UI 웹 UI 채널
API API 채널입니다.
TWILIO Twilio 채널
GOOGLE_TELEPHONY_PLATFORM Google Telephony Platform 채널
CONTACT_CENTER_AS_A_SERVICE Contact Center as a Service(CCaaS) 채널
CONTACT_CENTER_AS_A_SERVICE_CHAT Contact Center as a Service(CCaaS 채팅) 채널
FIVE9 Five9 채널
CONTACT_CENTER_INTEGRATION 서드 파티 고객센터 통합 채널입니다.
WHATSAPP WhatsApp 채널
INSTAGRAM Instagram 채널

페르소나

채널의 페르소나

열거형
UNKNOWN UNKNOWN 캐릭터
CONCISE 상담사는 간결하고 요점이 명확하게 답변합니다.
CHATTY 상담사가 추가 맥락, 설명, 세부정보를 제공합니다.

형식

웹 위젯의 모달리티입니다.

열거형
MODALITY_UNSPECIFIED 알 수 없는 양식입니다.
CHAT_AND_VOICE 위젯은 채팅 및 음성 입력을 모두 지원합니다.
VOICE_ONLY 위젯은 음성 입력만 지원합니다.
CHAT_ONLY 위젯은 채팅 입력만 지원합니다.
CHAT_VOICE_AND_VIDEO 위젯은 채팅, 음성, 동영상 입력을 지원합니다.

테마

웹 위젯의 테마입니다.

열거형
THEME_UNSPECIFIED 알 수 없는 테마입니다.
LIGHT 밝은 테마
DARK 어두운 테마

도구 주석

도구 주석은 특정 도구의 기본 위험을 설명하기 위해 MCP 클라이언트에 전송됩니다. 대부분의 클라이언트는 이러한 힌트를 신뢰할 수 없는 것으로 취급하지만, 사용자에게 확인 메시지를 보낼 시점을 결정하는 데 사용할 수 있습니다.

제목 문자열과 함께 다음 불리언 힌트가 정의됩니다.

  • readOnlyHint: true인 경우 도구가 환경을 수정하지 않습니다. 기본값: false.
  • destructiveHint: true인 경우 도구에서 파괴적인 작업을 수행할 수 있습니다. false이면 도구는 추가 작업만 수행할 수 있습니다. 기본값은 true입니다.
  • idempotentHint: true인 경우 동일한 인수로 도구를 반복적으로 호출해도 환경에 추가적인 영향을 미치지 않습니다. 기본값: false.
  • openWorldHint: true인 경우 도구는 외부 항목의 '오픈 월드'와 상호작용할 수 있습니다. false이면 도구는 내부 항목과만 상호작용할 수 있습니다. 예를 들어 웹 검색 도구는 오픈 월드이지만 메모리 도구는 오픈 월드가 아닙니다.

Destructive Hint: ✅ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ❌