MCP Tools Reference: ces.googleapis.com

도구: create_deployment

지정된 앱에 새 배포를 만듭니다.

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

입력 스키마

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

CreateDeploymentRequest

JSON 표현 
{
  "parent": string,
  "deploymentId": string,
  "deployment": {
    object (Deployment)
  }
}
필드
parent

string

필수 항목입니다. 상위 앱입니다. 형식: projects/{project}/locations/{location}/apps/{app}
deploymentId

string

선택사항입니다. 배포에 사용할 ID이며, 배포의 리소스 이름에서 마지막 구성요소가 됩니다. 제공되지 않으면 배포에 고유 ID가 자동으로 할당됩니다.
deployment

object (Deployment)

필수 항목입니다. 생성할 배포입니다.

배포

JSON 표현 
{
  "name": string,
  "displayName": string,
  "appVersion": string,
  "channelProfile": {
    object (ChannelProfile)
  },
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "experimentConfig": {
    object (ExperimentConfig)
  }
}
필드
name

string

식별자. 배포의 리소스 이름입니다. 형식: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}
displayName

string

필수 항목입니다. 배포의 표시 이름입니다.
appVersion

string

선택사항입니다. 배포할 앱 버전의 리소스 이름입니다. 형식: projects/{project}/locations/{location}/apps/{app}/versions/{version} 초안 앱을 사용하려면 projects/{project}/locations/{location}/apps/{app}/versions/-을 사용하세요.
channelProfile

object (ChannelProfile)

필수 항목입니다. 배포에 사용되는 채널 프로필입니다.
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가 비어 있으면 업데이트가 동시에 이루어진 변경사항을 덮어씁니다.
experimentConfig

object (ExperimentConfig)

선택사항입니다. 배포의 실험 구성입니다.

ChannelProfile

JSON 표현 
{
  "profileId": string,
  "channelType": enum (ChannelType),
  "personaProperty": {
    object (PersonaProperty)
  },
  "disableDtmf": boolean,
  "disableBargeInControl": boolean,
  "webWidgetConfig": {
    object (WebWidgetConfig)
  },
  "noiseSuppressionLevel": string
}
필드
profileId

string

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

enum (ChannelType)

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

object (PersonaProperty)

선택사항입니다. 채널 프로필의 페르소나 속성입니다.
disableDtmf

boolean

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

boolean

선택사항입니다. 대화에서 사용자 끼어들기 제어를 사용 중지할지 여부입니다. - true: 에이전트가 말하는 동안 사용자 방해가 사용 중지됩니다. - false: 사용자가 인터럽트할 수 있는 시점에 대한 자동 제어가 에이전트에 유지됩니다.
webWidgetConfig

object (WebWidgetConfig)

선택사항입니다. 웹 위젯의 구성입니다.
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 인증이 사용 설정되어 있는지 여부를 나타냅니다.

타임스탬프

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

string (int64 format)

Unix epoch 1970-01-01T00:00:00Z 이후 UTC 시간의 초 단위로 표현합니다. -62135596800~253402300799 (0001-01-01T00:00:00Z~9999-12-31T23:59:59Z) 사이여야 합니다.
nanos

integer

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

ExperimentConfig

JSON 표현 
{
  "versionRelease": {
    object (VersionRelease)
  }
}
필드
versionRelease

object (VersionRelease)

선택사항입니다. 실험의 버전 출시입니다.

VersionRelease

JSON 표현 
{
  "state": enum (State),
  "trafficAllocations": [
    {
      object (TrafficAllocation)
    }
  ]
}
필드
state

enum (State)

선택사항입니다. 버전 출시 상태입니다.
trafficAllocations[]

object (TrafficAllocation)

선택사항입니다. 버전 출시의 트래픽 할당입니다.

TrafficAllocation

JSON 표현 
{
  "id": string,
  "trafficPercentage": integer,
  "appVersion": string
}
필드
id

string

선택사항입니다. 트래픽 할당의 ID입니다. 최대 128자의 자유 형식 문자열입니다.
trafficPercentage

integer

선택사항입니다. 트래픽 할당의 트래픽 비율입니다. 0~100 사이여야 합니다.
appVersion

string

선택사항입니다. 트래픽 할당의 앱 버전입니다. 형식: projects/{project}/locations/{location}/apps/{app}/versions/{version}

ChannelType

채널 프로필 유형입니다.

열거형
UNKNOWN 알 수 없는 채널 유형입니다.
WEB_UI 웹 UI 채널입니다.
API API 채널
TWILIO Twilio 채널입니다.
GOOGLE_TELEPHONY_PLATFORM Google 전화 통신 플랫폼 채널
CONTACT_CENTER_AS_A_SERVICE Contact Center as a Service (CCaaS) 채널입니다.
FIVE9 Five9 채널
CONTACT_CENTER_INTEGRATION 서드 파티 고객센터 통합 채널입니다.

페르소나

채널의 페르소나입니다.

열거형
UNKNOWN 알 수 없는 페르소나입니다.
CONCISE 상담사는 간결하고 요점이 명확하게 대답합니다.
CHATTY 상담사가 추가 컨텍스트, 설명, 세부정보를 제공합니다.

형식

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

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

테마

웹 위젯의 테마입니다.

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

주

실험의 상태입니다.

열거형
STATE_UNSPECIFIED 지정되지 않은 상태입니다.
PENDING 대기 상태입니다. 실험이 대기 중이며 유효하지 않습니다.
RUNNING 실행 상태입니다. 실험이 진행 중이며 유효합니다.
DONE 완료 상태입니다. 실험이 완료되어 더 이상 유효하지 않습니다.
EXPIRED 만료된 상태입니다. 실험이 만료되어 더 이상 유효하지 않습니다.

출력 스키마

배포는 변경할 수 없고 쿼리할 수 있는 앱 버전을 나타냅니다. 특정 채널 프로필로 앱 버전을 배포하는 데 사용됩니다.

배포

JSON 표현 
{
  "name": string,
  "displayName": string,
  "appVersion": string,
  "channelProfile": {
    object (ChannelProfile)
  },
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "experimentConfig": {
    object (ExperimentConfig)
  }
}
필드
name

string

식별자. 배포의 리소스 이름입니다. 형식: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}
displayName

string

필수 항목입니다. 배포의 표시 이름입니다.
appVersion

string

선택사항입니다. 배포할 앱 버전의 리소스 이름입니다. 형식: projects/{project}/locations/{location}/apps/{app}/versions/{version} 초안 앱을 사용하려면 projects/{project}/locations/{location}/apps/{app}/versions/-을 사용하세요.
channelProfile

object (ChannelProfile)

필수 항목입니다. 배포에 사용되는 채널 프로필입니다.
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가 비어 있으면 업데이트가 동시에 이루어진 변경사항을 덮어씁니다.
experimentConfig

object (ExperimentConfig)

선택사항입니다. 배포의 실험 구성입니다.

ChannelProfile

JSON 표현 
{
  "profileId": string,
  "channelType": enum (ChannelType),
  "personaProperty": {
    object (PersonaProperty)
  },
  "disableDtmf": boolean,
  "disableBargeInControl": boolean,
  "webWidgetConfig": {
    object (WebWidgetConfig)
  },
  "noiseSuppressionLevel": string
}
필드
profileId

string

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

enum (ChannelType)

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

object (PersonaProperty)

선택사항입니다. 채널 프로필의 페르소나 속성입니다.
disableDtmf

boolean

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

boolean

선택사항입니다. 대화에서 사용자 끼어들기 제어를 사용 중지할지 여부입니다. - true: 에이전트가 말하는 동안 사용자 방해가 사용 중지됩니다. - false: 사용자가 인터럽트할 수 있는 시점에 대한 자동 제어가 에이전트에 유지됩니다.
webWidgetConfig

object (WebWidgetConfig)

선택사항입니다. 웹 위젯의 구성입니다.
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 인증이 사용 설정되어 있는지 여부를 나타냅니다.

타임스탬프

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

string (int64 format)

Unix epoch 1970-01-01T00:00:00Z 이후 UTC 시간의 초 단위로 표현합니다. -62135596800~253402300799 (0001-01-01T00:00:00Z~9999-12-31T23:59:59Z) 사이여야 합니다.
nanos

integer

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

ExperimentConfig

JSON 표현 
{
  "versionRelease": {
    object (VersionRelease)
  }
}
필드
versionRelease

object (VersionRelease)

선택사항입니다. 실험의 버전 출시입니다.

VersionRelease

JSON 표현 
{
  "state": enum (State),
  "trafficAllocations": [
    {
      object (TrafficAllocation)
    }
  ]
}
필드
state

enum (State)

선택사항입니다. 버전 출시 상태입니다.
trafficAllocations[]

object (TrafficAllocation)

선택사항입니다. 버전 출시의 트래픽 할당입니다.

TrafficAllocation

JSON 표현 
{
  "id": string,
  "trafficPercentage": integer,
  "appVersion": string
}
필드
id

string

선택사항입니다. 트래픽 할당의 ID입니다. 최대 128자의 자유 형식 문자열입니다.
trafficPercentage

integer

선택사항입니다. 트래픽 할당의 트래픽 비율입니다. 0~100 사이여야 합니다.
appVersion

string

선택사항입니다. 트래픽 할당의 앱 버전입니다. 형식: projects/{project}/locations/{location}/apps/{app}/versions/{version}

ChannelType

채널 프로필 유형입니다.

열거형
UNKNOWN 알 수 없는 채널 유형입니다.
WEB_UI 웹 UI 채널입니다.
API API 채널
TWILIO Twilio 채널입니다.
GOOGLE_TELEPHONY_PLATFORM Google 전화 통신 플랫폼 채널
CONTACT_CENTER_AS_A_SERVICE Contact Center as a Service (CCaaS) 채널입니다.
FIVE9 Five9 채널
CONTACT_CENTER_INTEGRATION 서드 파티 고객센터 통합 채널입니다.

페르소나

채널의 페르소나입니다.

열거형
UNKNOWN 알 수 없는 페르소나입니다.
CONCISE 상담사는 간결하고 요점이 명확하게 대답합니다.
CHATTY 상담사가 추가 컨텍스트, 설명, 세부정보를 제공합니다.

형식

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

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

테마

웹 위젯의 테마입니다.

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

주

실험의 상태입니다.

열거형
STATE_UNSPECIFIED 지정되지 않은 상태입니다.
PENDING 대기 상태입니다. 실험이 대기 중이며 유효하지 않습니다.
RUNNING 실행 상태입니다. 실험이 진행 중이며 유효합니다.
DONE 완료 상태입니다. 실험이 완료되어 더 이상 유효하지 않습니다.
EXPIRED 만료된 상태입니다. 실험이 만료되어 더 이상 유효하지 않습니다.

도구 주석

파괴적 힌트: ✅ | 동일한 힌트: ❌ | 읽기 전용 힌트: ❌ | 오픈 월드 힌트: ❌