MCP Tools Reference: ces.googleapis.com

도구: list_apps

지정된 프로젝트와 위치의 앱을 나열합니다.

다음 코드 샘플은 curl를 사용하여 list_apps 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": "list_apps", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }'

입력 스키마

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

ListAppsRequest

JSON 표현
{ "parent": string, "pageSize": integer, "pageToken": string, "filter": string, "orderBy": string }

필드
parent	string 필수 항목입니다. 앱을 나열할 위치의 리소스 이름입니다.
pageSize	integer (선택사항) 요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.
pageToken	string (선택사항) 이전 목록 AgentService.ListApps 호출에서 반환된 next_page_token 값입니다.
filter	string (선택사항) 앱을 나열할 때 적용할 필터입니다. 자세한 내용은 https://google.aip.dev/160을 참조하세요.
orderBy	string 선택사항입니다. 정렬할 필드입니다. 'name' 및 'create_time'만 지원됩니다. 자세한 내용은 https://google.aip.dev/132#ordering을 참조하세요.

출력 스키마

AgentService.ListApps의 응답 메시지입니다.

ListAppsResponse

JSON 표현
{ "apps": [ { object (App) } ], "nextPageToken": string, "unreachable": [ string ] }

필드
apps[]	object (App) 앱 목록입니다.
nextPageToken	string 다음 페이지를 검색하기 위해 ListAppsRequest.page_token으로 전송할 수 있는 토큰입니다. 이 필드가 없으면 후속 페이지가 없음을 나타냅니다.
unreachable[]	string 순서가 지정되지 않은 목록 도달할 수 없는 위치입니다.

앱

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) (선택사항) 앱의 시간대 설정입니다.
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) (선택사항) 고객센터 통계 대시보드를 연결하고 구성하기 위한 앱별 대시보드 설정입니다.

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) } }

필드
redactionConfig	object (RedactionConfig) (선택사항) 민감한 정보를 수정하는 방법에 관한 구성입니다.
audioRecordingConfig	object (AudioRecordingConfig) (선택사항) 오디오 상호작용을 녹음하는 방법에 관한 구성입니다. 오디오는 RedactionConfig에 구성된 대로 수정됩니다.
unredactedAudioRecordingConfig	object (AudioRecordingConfig) (선택사항) 수정되지 않은 오디오의 추가 녹음을 구성합니다. 이는 오디오 수정이 enabled인 경우 원시 오디오 사본을 유지하는 데 사용할 수 있으며, 일반적으로 감사 또는 모니터링 목적으로 사용됩니다.
bigqueryExportSettings	object (BigQueryExportSettings) (선택사항) 앱의 BigQuery 내보내기 동작을 구성합니다. 대화 데이터는 RedactionConfig에 구성된 대로 수정됩니다.
unredactedBigqueryExportSettings	object (BigQueryExportSettings) (선택사항) 앱의 BigQuery 내보내기 동작을 구성합니다. 사용 설정된 경우 수정되지 않은 대화 데이터가 BigQuery 테이블로 내보내집니다.
cloudLoggingSettings	object (CloudLoggingSettings) (선택사항) 앱의 Cloud Logging 동작을 설명하는 설정입니다.
conversationLoggingSettings	object (ConversationLoggingSettings) (선택사항) 앱의 대화 로깅 동작을 설명하는 설정입니다.
evaluationAudioRecordingConfig	object (AudioRecordingConfig) (선택사항) 평가를 위해 오디오 상호작용을 녹음하는 방법에 관한 구성입니다. 기본적으로 평가 세션에는 오디오 녹음이 사용 설정되어 있지 않습니다.
metricAnalysisSettings	object (MetricAnalysisSettings) (선택사항) 앱의 LLM 분석 파이프라인의 대화 데이터 수집 동작을 설명하는 설정입니다.

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 내보내기가 사용 설정되어 있는지 여부를 나타냅니다.
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 출력 전용입니다. 가져온 Meta 비즈니스 프로필 썸네일 URL입니다.
description	string 출력 전용입니다. Meta 비즈니스 페이지 또는 프로필의 설명입니다.

InstagramConfig

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

필드
instagramAccountId	string 필수 항목입니다. Instagram 계정 ID입니다.
displayName	string 출력 전용입니다. 가져온 Meta 비즈니스 페이지 이름입니다.
thumbnailUrl	string 출력 전용입니다. 가져온 Meta 비즈니스 프로필 썸네일 URL입니다.
description	string 출력 전용입니다. Meta 비즈니스 페이지 또는 프로필의 설명입니다.

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 (선택사항) 앱과 연결된 기본 고객센터 통계 대시보드의 리소스 이름입니다. 사용자가 앱의 모니터링 보기로 이동할 때 표시되는 대시보드입니다. 형식: 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는 Value 유형 결합의 null 값을 나타내기 위해 값이 하나만 있는 enum을 사용하는 센티널입니다.

0 이외의 값이 있는 NullValue 유형의 필드는 잘못된 것으로 간주됩니다. 대부분의 ProtoJSON 직렬화 프로그램은 정수 값과 관계없이 null_value이 JSON null로 설정된 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_SEARCH	앱의 SOLUTION_TYPE_SEARCH 엔진입니다. 앱에 추가된 모든 커넥터 데이터 스토어가 이 엔진에 추가됩니다.
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 Chat) 채널
FIVE9	Five9 채널
CONTACT_CENTER_INTEGRATION	서드 파티 고객센터 통합 채널입니다.
WHATSAPP	WhatsApp 채널
INSTAGRAM	Instagram 채널입니다.

페르소나

채널의 페르소나입니다.

열거형
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인 경우 도구는 내부 항목과만 상호작용할 수 있습니다. 예를 들어 웹 검색 도구는 오픈 월드이지만 메모리 도구는 오픈 월드가 아닙니다.

파괴적 힌트: ❌ | 멱등성 힌트: ✅ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌