- 리소스: App
- JSON 표현
- LanguageSettings
- TimeZoneSettings
- AudioProcessingConfig
- SynthesizeSpeechConfig
- BargeInConfig
- AmbientSoundConfig
- AmbientSoundConfig.PrebuiltAmbientNoise
- CustomVoiceSample
- CustomVoiceSample.Warning
- CustomVoiceSample.Warning.WarningType
- CustomVoiceSample.VoiceInstructionMode
- LoggingSettings
- RedactionConfig
- AudioRecordingConfig
- BigQueryExportSettings
- CloudLoggingSettings
- ConversationLoggingSettings
- MetricAnalysisSettings
- ErrorHandlingSettings
- ErrorHandlingSettings.ErrorHandlingStrategy
- ErrorHandlingSettings.FallbackResponseConfig
- ErrorHandlingSettings.EndSessionConfig
- App.ToolExecutionMode
- App.VariableDeclaration
- DataStoreSettings
- DataStoreSettings.Engine
- DataStoreSettings.Engine.Type
- ClientCertificateSettings
- VpcScSettings
- EvaluationSettings
- EvaluationSettings.ScenarioConversationInitiator
- DashboardSettings
- 메서드
리소스: App
앱은 루트 에이전트와 하위 에이전트, 관련 구성이 포함된 에이전트 그룹의 최상위 컨테이너 역할을 합니다. 이러한 에이전트는 앱 컨텍스트 내에서 특정 목표를 달성하기 위해 함께 작동합니다.
| JSON 표현 |
|---|
{ "name": string, "displayName": string, "description": string, "pinned": boolean, "rootAgent": string, "languageSettings": { object ( |
| 필드 | |
|---|---|
name |
식별자. 앱의 고유 식별자입니다. 형식: |
displayName |
필수 항목입니다. 앱의 표시 이름입니다. |
description |
선택사항입니다. 인간이 읽을 수 있는 앱 설명입니다. |
pinned |
선택사항입니다. 앱이 앱 목록에 고정되어 있는지 여부입니다. |
rootAgent |
선택사항입니다. 루트 에이전트는 앱의 진입점입니다. 형식: |
languageSettings |
선택사항입니다. 앱의 언어 설정입니다. |
timeZoneSettings |
선택사항입니다. 앱의 TimeZone 설정입니다. |
audioProcessingConfig |
선택사항입니다. 앱의 오디오 처리 구성입니다. |
loggingSettings |
선택사항입니다. 앱의 로깅 설정입니다. |
errorHandlingSettings |
선택사항입니다. 앱의 오류 처리 설정 |
modelSettings |
선택사항입니다. 앱의 기본 LLM 모델 설정입니다. 개별 리소스(예: 에이전트, 가드레일)는 필요에 따라 이러한 구성을 재정의할 수 있습니다. |
toolExecutionMode |
선택사항입니다. 앱의 도구 실행 모드입니다. 제공되지 않으면 기본값은 PARALLEL입니다. |
evaluationMetricsThresholds |
선택사항입니다. 앱의 평가 기준입니다. |
variableDeclarations[] |
선택사항입니다. 변수 선언입니다. |
predefinedVariableDeclarations[] |
출력 전용입니다. 앱의 사전 정의된 변수 선언입니다. |
globalInstruction |
선택사항입니다. 앱의 모든 에이전트에 대한 안내입니다. 이 안내를 사용하여 모든 에이전트에서 안정적인 ID 또는 성격을 설정할 수 있습니다. |
guardrails[] |
선택사항입니다. 앱의 가드레일 목록입니다. 형식: |
dataStoreSettings |
선택사항입니다. 앱의 데이터 스토어 설정입니다. |
defaultChannelProfile |
선택사항입니다. 앱에서 사용하는 기본 채널 프로필입니다. |
metadata |
선택사항입니다. 앱에 대한 메타데이터입니다. 이 필드는 앱의 세부정보 또는 의도된 사용과 관련된 추가 정보를 저장하는 데 사용할 수 있습니다.
|
createTime |
출력 전용입니다. 앱이 생성된 타임스탬프입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
updateTime |
출력 전용입니다. 앱이 마지막으로 업데이트된 시점의 타임스탬프입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
etag |
출력 전용입니다. 읽기-수정-쓰기 작업 중에 객체가 변경되지 않았는지 확인하는 데 사용되는 Etag입니다. etag가 비어 있으면 업데이트가 동시 변경사항을 덮어씁니다. |
deploymentCount |
출력 전용입니다. 앱의 배포 수입니다. |
clientCertificateSettings |
선택사항입니다. 앱의 기본 클라이언트 인증서 설정입니다. |
vpcScSettings |
선택사항입니다. 앱의 VPC-SC 설정입니다. |
locked |
선택사항입니다. 변경사항에 대해 앱이 잠겨 있는지 여부를 나타냅니다. 앱이 잠겨 있으면 앱 리소스 수정이 거부됩니다. |
evaluationPersonas[] |
선택사항입니다. 앱의 평가 페르소나입니다. 이 필드는 평가에 사용할 수 있는 페르소나를 정의하는 데 사용됩니다. 최대 30개의 캐릭터를 정의할 수 있습니다. |
evaluationSettings |
선택사항입니다. 앱의 평가 설정입니다. |
validationErrors[] |
출력 전용입니다. 앱의 구성 오류 또는 경고 |
dashboardSettings |
선택사항입니다. Contact Center Insights 대시보드를 연결하고 구성하기 위한 앱별 대시보드 설정입니다. |
LanguageSettings
앱의 언어 설정입니다.
| JSON 표현 |
|---|
{ "defaultLanguageCode": string, "supportedLanguageCodes": [ string ], "enableMultilingualSupport": boolean, "fallbackAction": string } |
| 필드 | |
|---|---|
defaultLanguageCode |
선택사항입니다. 앱의 기본 언어 코드입니다. |
supportedLanguageCodes[] |
선택사항입니다. |
enableMultilingualSupport |
선택사항입니다. 다국어 지원을 사용 설정합니다. |
fallbackAction |
선택사항입니다. 지원 중단됨: 이 기능은 더 이상 지원되지 않습니다. 대신 이는 사전 정의된 작업 또는 커스텀 도구 호출일 수 있습니다. 유효한 값은 다음과 같습니다. - 특정 도구 실행을 트리거하는 도구의 전체 리소스 이름 - '에스컬레이션' 또는 '종료'와 같은 사전 정의된 시스템 작업으로, 해당 |
TimeZoneSettings
앱의 TimeZone 설정입니다.
| JSON 표현 |
|---|
{ "timeZone": string } |
| 필드 | |
|---|---|
timeZone |
선택사항입니다. 시간대 데이터베이스에 등록된 앱의 시간대입니다(예: America/Los_Angeles, Europe/Paris). |
AudioProcessingConfig
입력 및 출력 오디오를 처리하고 전송하는 방법에 대한 구성입니다.
| JSON 표현 |
|---|
{ "synthesizeSpeechConfigs": { string: { object ( |
| 필드 | |
|---|---|
synthesizeSpeechConfigs |
선택사항입니다. 에이전트 응답을 합성하는 방법의 구성으로, 언어 코드를 지정된 언어 코드의 구성을 찾을 수 없는 경우 루트 언어 코드의 구성이 사용됩니다. 예를 들어 맵에 'en-us' 및 'en'이 포함되어 있고 지정된 언어 코드가 'en-gb'인 경우 'en' 구성이 사용됩니다. 참고: 언어 코드는 대소문자를 구분하지 않습니다.
|
bargeInConfig |
선택사항입니다. 사용자 끼어들기 활동에 대한 에이전트 동작을 구성합니다. |
inactivityTimeout |
선택사항입니다. 에이전트가 사용자에게 재참여를 요청하기 전에 사용자가 비활성 상태(음성 또는 상호작용 없음)인 시간입니다. 설정하지 않으면 에이전트가 사용자에게 재참여를 요청하지 않습니다. 소수점 아래가 최대 9자리까지이고 ' |
ambientSoundConfig |
선택사항입니다. 대화의 자연스러움을 향상하기 위해 합성된 에이전트 응답과 함께 재생할 주변 소리 구성입니다. |
customVoiceSamples[] |
선택사항입니다. 음성 클론을 위한 커스텀 음성 샘플을 구성합니다. |
SynthesizeSpeechConfig
에이전트 응답을 합성하는 방법에 대한 구성입니다.
| JSON 표현 |
|---|
{ "voice": string, "speakingRate": number, "model": string, "instruction": string } |
| 필드 | |
|---|---|
voice |
선택사항. 음성 이름입니다. 설정하지 않으면 서비스에서 languageCode와 같은 다른 매개변수를 기반으로 음성을 선택합니다. 사용 가능한 음성 목록은 Cloud Text-to-Speech의 지원되는 음성 및 언어를 참고하세요. |
speakingRate |
선택사항입니다. 말하기 속도/속도(범위: [0.25, 2.0])입니다. 1.0은 특정 음성에서 지원하는 일반적인 기본 속도입니다. 2.0은 기본 속도의 2배이며 0.5는 절반입니다. [0.25, 2.0] 범위를 벗어나는 값은 오류를 반환합니다. |
model |
선택사항입니다. 오디오를 합성하는 데 사용되는 모델입니다. 현재 지원되는 값은 'gemini-3.1-flash-tts-preview'입니다. 비어 있으면 Chirp3-HD가 사용됩니다. |
instruction |
선택사항입니다. 생성 모델을 사용할 때 음성을 합성하는 데 사용되는 요청 사항입니다. |
BargeInConfig
사용자 끼어들기 활동을 처리하는 방법에 대한 구성입니다.
| JSON 표현 |
|---|
{ "disableBargeIn": boolean, "bargeInAwareness": boolean } |
| 필드 | |
|---|---|
disableBargeIn |
선택사항입니다. 경고: ChannelProfile에서 에이전트가 말하는 동안 사용자 끼어들기를 사용 중지합니다. true이면 에이전트 응답 재생 중 사용자 입력이 무시됩니다. |
bargeInAwareness |
선택사항입니다. 사용 설정하면 에이전트는 사용자가 이전 에이전트 메시지를 완전히 듣지 못했다고 가정하고 다음 대답을 조정합니다. 에이전트 응답이 시각적으로 표시되는 시나리오에서는 사용하면 안 됩니다. |
AmbientSoundConfig
대화의 자연스러움을 향상하기 위해 합성된 에이전트 응답과 함께 재생할 주변 소리 구성입니다.
| JSON 표현 |
|---|
{
"volumeGainDb": number,
// The following is a list of mutually exclusive fields. At most one of the
// fields will be set in a response:
"prebuiltAmbientNoise": enum ( |
| 필드 | |
|---|---|
volumeGainDb |
선택사항입니다. 주변 소음에서 지원하는 일반 기본 볼륨의 볼륨 게인(dB)입니다. 범위는 [-96.0, 16.0]입니다. 값을 설정하지 않거나 0.0(dB)으로 설정하면 일반적인 기본 신호 진폭에서 재생됩니다. 값이 -6.0(dB)이면 일반적인 기본 신호 진폭의 약 절반에서 재생됩니다. 값이 +6.0(dB)이면 일반적인 기본 신호 진폭의 약 두 배에서 재생됩니다. +10(dB)을 초과하는 값을 사용하지 않는 것이 좋습니다. 값이 +10을 초과하면 일반적으로 소리가 커지는 효과가 없기 때문입니다. |
| 대화의 자연스러움을 향상시키기 위해 합성된 에이전트 응답과 함께 재생되는 주변 소음입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다. | |
prebuiltAmbientNoise |
선택사항입니다. 지원 중단됨: |
gcsUri |
선택사항입니다. Cloud Storage에 저장된 모노 채널, 16kHz WAV 파일 형식의 주변 소음 참고: CES 서비스 에이전트 |
prebuiltAmbientSound |
선택사항입니다. 사전 제작된 주변 소리의 이름입니다. 유효한 값은 'coffee_shop', 'keyboard', 'keypad', 'hum', 'office_1', 'office_2', 'office_3', 'room_1', 'room_2', 'room_3', 'room_4', 'room_5', 'air_conditioner'입니다. |
| 상호 배타적 필드의 끝입니다. | |
AmbientSoundConfig.PrebuiltAmbientNoise
사전 빌드된 주변 소음
| 열거형 | |
|---|---|
PREBUILT_AMBIENT_NOISE_UNSPECIFIED |
지정되지 않음 |
RETAIL_STORE |
소매점의 주변 소음 |
CONVENTION_HALL |
컨벤션 홀의 주변 소음 |
OUTDOOR |
거리의 주변 소음 |
CustomVoiceSample
음성 클론에 사용되는 커스텀 음성 샘플의 구성입니다.
| JSON 표현 |
|---|
{ "name": string, "voiceSampleGcsUri": string, "consentAudioGcsUri": string, "voiceInstruction": string, "previewAudioContent": string, "previewText": string, "warnings": [ { object ( |
| 필드 | |
|---|---|
name |
선택사항입니다. 커스텀 음성 샘플의 사용자 정의 이름입니다. |
voiceSampleGcsUri |
선택사항입니다. 음성 클론을 위한 오디오 샘플의 Cloud Storage URI입니다. 오디오 샘플은 모노 채널, 24kHz WAV 파일이어야 합니다. |
consentAudioGcsUri |
선택사항입니다. 음성 클론에 대한 동의 오디오입니다. |
voiceInstruction |
선택사항입니다. 음성 스타일, 어조, 속도 또는 발음에 대한 자연어 안내입니다. |
previewAudioContent |
출력 전용입니다. 커스텀 음성을 위해 합성된 프리뷰 오디오로, 표준 WAV(LINEAR16, 24kHz, 16비트, 모노) 형식입니다. base64 인코딩 문자열입니다. |
previewText |
선택사항입니다. 커스텀 음성의 미리보기 오디오를 합성하기 위한 텍스트입니다. |
warnings[] |
출력 전용입니다. 음성 클론 처리 중에 발생한 경고 메시지입니다(예: 낮은 오디오 수준). |
voiceInstructionMode |
선택사항입니다. 음성 샘플의 요청 사항 모드입니다. 지정하지 않으면 기본값은 NO_INSTRUCTION입니다. |
CustomVoiceSample.Warning
음성 샘플 처리 중에 발생한 경고 메시지입니다.
| JSON 표현 |
|---|
{
"message": string,
"type": enum ( |
| 필드 | |
|---|---|
message |
출력 전용입니다. 인간이 읽을 수 있는 경고 설명입니다. |
type |
출력 전용입니다. 경고 유형입니다. |
CustomVoiceSample.Warning.WarningType
음성 샘플 처리 중에 발생한 경고 유형입니다.
| 열거형 | |
|---|---|
WARNING_TYPE_UNSPECIFIED |
지정되지 않은 경고 유형입니다. |
LOW_AUDIO_LEVEL |
음성 샘플의 오디오 수준이 너무 낮습니다(예: 낮은 RMS 진폭). |
CustomVoiceSample.VoiceInstructionMode
음성 샘플의 요청 사항 모드입니다.
| 열거형 | |
|---|---|
VOICE_INSTRUCTION_MODE_UNSPECIFIED |
지정되지 않은 안내 모드입니다. 기본값은 NO_INSTRUCTION입니다. |
NO_INSTRUCTION |
음성 안내가 사용되지 않습니다. |
GENERATE_INSTRUCTION |
AI가 오디오 샘플을 기반으로 음성 안내를 자동으로 생성합니다. |
CUSTOM_INSTRUCTION |
사용자가 제공한 맞춤 음성 안내입니다. |
LoggingSettings
앱의 로깅 동작을 설명하는 설정입니다.
| JSON 표현 |
|---|
{ "redactionConfig": { object ( |
| 필드 | |
|---|---|
redactionConfig |
선택사항입니다. 민감한 정보를 수정하는 방법에 대한 구성입니다. |
audioRecordingConfig |
선택사항입니다. 오디오 상호작용을 기록하는 방법에 대한 구성입니다. 오디오는 |
unredactedAudioRecordingConfig |
선택사항입니다. 수정되지 않은 오디오의 추가 녹음을 구성합니다. 이는 오디오 수정이 |
bigqueryExportSettings |
선택사항입니다. 앱의 BigQuery Export 동작을 구성합니다. 대화 데이터는 |
unredactedBigqueryExportSettings |
선택사항입니다. 앱의 BigQuery 내보내기 동작을 구성합니다. 사용 설정하면 수정되지 않은 대화 데이터가 BigQuery 테이블로 내보내집니다. |
cloudLoggingSettings |
선택사항입니다. 앱의 Cloud Logging 동작을 설명하는 설정입니다. |
conversationLoggingSettings |
선택사항입니다. 앱의 대화 로깅 동작을 설명하는 설정입니다. |
evaluationAudioRecordingConfig |
선택사항입니다. 평가를 위해 오디오 상호작용을 녹음하는 방법에 대한 구성입니다. 기본적으로 평가 세션에는 오디오 녹음이 사용 설정되지 않습니다. |
metricAnalysisSettings |
선택사항입니다. 앱의 LLM 분석 파이프라인에 대한 대화 데이터 수집 동작을 설명하는 설정입니다. |
requiredRecordingConsent |
선택사항입니다. 앱이 녹음될 수 있는 내용을 말해야 하는지 여부 true인 경우 세션은 녹음이 사용 중지된 상태로 시작되며 클라이언트가 기본값인 |
RedactionConfig
민감한 정보를 처리하는 방법을 지정하는 구성입니다.
| JSON 표현 |
|---|
{ "enableRedaction": boolean, "inspectTemplate": string, "deidentifyTemplate": string } |
| 필드 | |
|---|---|
enableRedaction |
선택사항입니다. |
inspectTemplate |
선택사항입니다. 민감한 정보 유형 감지를 구성하는 DLP 검사 템플릿 이름입니다. 형식: |
deidentifyTemplate |
선택사항입니다. 콘텐츠를 익명화하는 방법을 지정하는 DLP 익명화 템플릿 이름입니다. 형식: |
AudioRecordingConfig
오디오 상호작용을 기록하는 방법에 대한 구성입니다.
| JSON 표현 |
|---|
{ "gcsBucket": string, "gcsPathPrefix": string } |
| 필드 | |
|---|---|
gcsBucket |
선택사항입니다. 세션 오디오 녹음을 저장할 Cloud Storage 버킷입니다. URI는 'gs://'로 시작해야 합니다. 데이터 레지던시 요구사항을 충족하는 버킷 위치를 선택하세요. 참고: Cloud Storage 버킷이 앱과 다른 프로젝트에 있는 경우 CES 서비스 에이전트 |
gcsPathPrefix |
선택사항입니다. 오디오 녹음 파일의 Cloud Storage 경로 프리픽스입니다. 이 프리픽스에는 다음 자리표시자가 포함될 수 있으며, 이 자리표시자는 서빙 시점에 동적으로 대체됩니다. - $project: 프로젝트 ID - $location: 앱 위치 - $app: 앱 ID - $date: YYYY-MM-DD 형식의 세션 날짜 - $session: 세션 ID 경로 프리픽스를 지정하지 않으면 기본 프리픽스 |
BigQueryExportSettings
앱의 BigQuery 내보내기 동작을 설명하는 설정입니다.
| JSON 표현 |
|---|
{ "enabled": boolean, "project": string, "dataset": string } |
| 필드 | |
|---|---|
enabled |
선택사항입니다. BigQuery Export가 사용 설정되어 있는지 여부를 나타냅니다. |
project |
선택사항입니다. 데이터를 내보낼 BigQuery 데이터 세트의 프로젝트 ID입니다. 참고: BigQuery 데이터 세트가 앱과 다른 프로젝트에 있는 경우 CES 서비스 에이전트 |
dataset |
선택사항입니다. 데이터를 내보낼 BigQuery 데이터 세트 ID입니다. |
CloudLoggingSettings
앱의 Cloud Logging 동작을 설명하는 설정입니다.
| JSON 표현 |
|---|
{ "enableCloudLogging": boolean } |
| 필드 | |
|---|---|
enableCloudLogging |
선택사항입니다. 세션에 Cloud Logging을 사용 설정할지 여부입니다. |
ConversationLoggingSettings
앱의 대화 로깅 동작을 설명하는 설정입니다.
| JSON 표현 |
|---|
{ "disableConversationLogging": boolean, "retentionWindow": string } |
| 필드 | |
|---|---|
disableConversationLogging |
선택사항입니다. 세션의 대화 로깅을 사용 중지할지 여부입니다. |
retentionWindow |
선택사항입니다. 대화의 보관 기간을 제어합니다. 설정하지 않으면 대화가 365일 동안 보관됩니다. 소수점 아래가 최대 9자리까지이고 ' |
MetricAnalysisSettings
LLM 분석 측정항목 파이프라인의 대화 데이터 수집 동작을 설명하는 설정입니다.
| JSON 표현 |
|---|
{ "llmMetricsOptedOut": boolean } |
| 필드 | |
|---|---|
llmMetricsOptedOut |
선택사항입니다. LLM 분석 측정항목의 대화 데이터를 수집할지 여부입니다. true이면 LLM 분석 측정항목에 대한 대화 데이터가 수집되지 않습니다. 그렇지 않으면 대화 데이터가 수집됩니다. |
ErrorHandlingSettings
앱에서 오류를 처리하는 방법을 설명하는 설정입니다.
| JSON 표현 |
|---|
{ "errorHandlingStrategy": enum ( |
| 필드 | |
|---|---|
errorHandlingStrategy |
선택사항입니다. 오류 처리에 사용할 전략입니다. |
fallbackResponseConfig |
선택사항입니다. 대체 응답을 처리하기 위한 구성입니다. |
endSessionConfig |
선택사항입니다. 시스템 오류(예: LLM 오류)가 발생할 경우 세션을 종료하기 위한 구성입니다. |
ErrorHandlingSettings.ErrorHandlingStrategy
오류 처리 전략을 정의합니다.
| 열거형 | |
|---|---|
ERROR_HANDLING_STRATEGY_UNSPECIFIED |
지정되지 않은 오류 처리 전략입니다. |
NONE |
특정 처리가 사용 설정되지 않았습니다. |
FALLBACK_RESPONSE |
시스템 오류(예: LLM 오류)가 발생하면 대체 메시지가 사용자에게 반환됩니다. |
END_SESSION |
시스템 오류(예: LLM 오류)가 발생하면 EndSession 신호가 전송됩니다. |
ErrorHandlingSettings.FallbackResponseConfig
대체 응답을 처리하기 위한 구성입니다.
| JSON 표현 |
|---|
{ "customFallbackMessages": { string: string, ... }, "maxFallbackAttempts": integer } |
| 필드 | |
|---|---|
customFallbackMessages |
선택사항입니다. 시스템 오류(예: LLM 오류)가 발생할 경우의 대체 메시지이며 지원되는 언어 코드로 매핑됩니다.
|
maxFallbackAttempts |
선택사항입니다. 에이전트가 |
ErrorHandlingSettings.EndSessionConfig
시스템 오류(예: LLM 오류)가 발생할 경우 세션을 종료하기 위한 구성입니다.
| JSON 표현 |
|---|
{ "escalateSession": boolean } |
| 필드 | |
|---|---|
escalateSession |
선택사항입니다. |
App.ToolExecutionMode
에이전트가 동시에 여러 도구를 선택하는 경우 도구 실행 동작을 정의합니다.
| 열거형 | |
|---|---|
TOOL_EXECUTION_MODE_UNSPECIFIED |
지정되지 않은 도구 실행 모드입니다. 기본값은 PARALLEL입니다. |
PARALLEL |
여러 도구가 선택되면 동일한 ToolContext를 사용하여 동시에 실행됩니다. |
SEQUENTIAL |
여러 도구가 선택된 경우 순차적으로 실행됩니다. 다음 도구는 이전 도구가 완료된 후에만 실행되며 이전 도구에서 업데이트된 ToolContext를 볼 수 있습니다. |
App.VariableDeclaration
변수의 구조와 메타데이터를 정의합니다.
| JSON 표현 |
|---|
{
"name": string,
"description": string,
"schema": {
object ( |
| 필드 | |
|---|---|
name |
필수 항목입니다. 변수 이름입니다. 이름은 영문자 또는 밑줄로 시작해야 하며 영문자, 숫자, 밑줄만 포함해야 합니다. |
description |
필수 항목입니다. 변수에 대한 설명입니다. |
schema |
필수 항목입니다. 변수의 스키마입니다. |
DataStoreSettings
앱의 데이터 스토어 관련 설정입니다.
| JSON 표현 |
|---|
{
"engines": [
{
object ( |
| 필드 | |
|---|---|
engines[] |
출력 전용입니다. 앱의 엔진입니다. |
DataStoreSettings.Engine
데이터 스토어가 연결된 엔진입니다. Vertex AI Search: https://cloud.google.com/generative-ai-app-builder/docs/enterprise-search-introduction을 참조하세요.
| JSON 표현 |
|---|
{
"name": string,
"type": enum ( |
| 필드 | |
|---|---|
name |
출력 전용입니다. 엔진의 리소스 이름입니다. 형식: |
type |
출력 전용입니다. 엔진 유형입니다. |
DataStoreSettings.Engine.Type
엔진 유형입니다. 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 엔진입니다. 앱에 추가된 모든 커넥터 데이터 스토어가 이 엔진에 추가됩니다. |
ClientCertificateSettings
커스텀 클라이언트 인증서 설정
| JSON 표현 |
|---|
{ "tlsCertificate": string, "privateKey": string, "passphrase": string } |
| 필드 | |
|---|---|
tlsCertificate |
필수 항목입니다. PEM 형식으로 인코딩된 TLS 인증서입니다. 이 문자열에는 시작 헤더와 끝 바닥글 줄이 포함되어야 합니다. |
privateKey |
필수 항목입니다. PEM 형식으로 인코딩된 비공개 키를 저장하는 SecretManager 보안 비밀 버전 리소스의 이름입니다. 형식: |
passphrase |
선택사항입니다. 비공개 키를 복호화하는 암호를 저장하는 SecretManager 보안 비밀 버전 리소스의 이름입니다. 비공개 키가 암호화되지 않은 경우 설정하지 않은 상태로 두어야 합니다. 형식: |
VpcScSettings
앱의 VPC-SC 설정입니다.
| JSON 표현 |
|---|
{ "allowedOrigins": [ string ] } |
| 필드 | |
|---|---|
allowedOrigins[] |
선택사항입니다. VPC 서비스 제어가 사용 설정된 경우 앱의 OpenAPI 도구가 직접 호출할 수 있는 허용된 HTTP(S) 출처입니다. 이 문자열은 포트가 지정된 경우 포트를 포함하여 출처와 정확히 일치해야 합니다. 예를 들면 'https://example.com' 또는 'https://example.com:443'입니다. 이 목록은 직접 HTTP 호출을 수행할 수 있는 Python 도구에는 아직 적용되지 않습니다. |
EvaluationSettings
평가 설정입니다.
| JSON 표현 |
|---|
{ "scenarioConversationInitiator": enum ( |
| 필드 | |
|---|---|
scenarioConversationInitiator |
선택사항입니다. 시나리오 평가에서 대화를 시작하는 사람입니다. |
goldenRunMethod |
선택사항입니다. 골든 평가를 실행하는 데 사용되는 기본 메서드입니다. RunEvaluationRequest에 goldenRunMethod가 지정되지 않은 경우에 사용됩니다. |
goldenEvaluationToolCallBehaviour |
선택사항입니다. 골든 평가의 기본 도구 호출 동작을 구성합니다. |
scenarioEvaluationToolCallBehaviour |
선택사항입니다. 시나리오 평가의 기본 도구 호출 동작을 구성합니다. |
metricsConfig |
선택사항입니다. 평가의 기본 측정항목을 구성합니다. |
scenarioExecutionMode |
선택사항입니다. 시나리오 평가의 실행 모드입니다. 제공하지 않으면 QUALITY_OPTIMIZED로 기본 설정됩니다. |
evaluationRunCachingSettings |
선택사항입니다. 평가 실행에 사용할 캐싱 설정입니다. |
EvaluationSettings.ScenarioConversationInitiator
시나리오 평가 세션에서 대화를 시작하는 사람을 결정합니다.
| 열거형 | |
|---|---|
SCENARIO_CONVERSATION_INITIATOR_UNSPECIFIED |
지정되지 않음. 기본값은 USER입니다. |
USER |
사용자가 대화를 시작합니다. |
AGENT |
상담사가 대화를 시작합니다. |
DashboardSettings
모니터링 뷰에 표시되는 앱과 연결된 대시보드의 설정입니다.
| JSON 표현 |
|---|
{ "defaultDashboard": string } |
| 필드 | |
|---|---|
defaultDashboard |
선택사항입니다. 앱과 연결된 기본 Contact Center Insights 대시보드의 리소스 이름입니다. 사용자가 앱의 모니터링 뷰로 이동할 때 표시되는 대시보드입니다. 형식: |
메서드 |
|
|---|---|
|
지정된 어시스턴트 세션에 대해 AI 어시스턴트인 Arc를 실행합니다. |
|
특정 프로젝트와 위치에 새 앱을 만듭니다. |
|
지정된 앱을 삭제합니다. |
|
지정된 인수를 사용하여 지정된 도구를 실행합니다. |
|
지정된 앱을 내보냅니다. |
|
특정 리소스(예: |
|
Arc 제로 상태에 대한 맞춤 온보딩 추천을 생성합니다. 앱의 어시스턴트 세션 기록에서 요청하는 사용자(신규/탐색/재방문)를 분류하고 메시지가 전송되기 전에 렌더링할 추천 쿼리 칩(세션 재개, 작업 계속, 새로운 작업 시작)을 반환합니다. |
|
지정된 앱의 세부정보를 가져옵니다. |
|
인증된 에이전트의 확장 에이전트 카드를 가져옵니다. |
|
지정된 앱을 가져옵니다. |
|
평가를 앱으로 가져옵니다. |
|
지정된 프로젝트 및 위치의 앱을 나열합니다. |
|
지정된 앱을 업데이트합니다. |
|
지정된 도구의 스키마를 가져옵니다. |
|
지정된 어시스턴트 세션의 어시스턴트 에이전트를 실행합니다. |
|
앱 평가를 실행합니다. |
|
페르소나의 음성을 테스트합니다. |