MCP Tools Reference: ces.googleapis.com

도구: get_deployment

지정된 배포의 세부정보를 가져옵니다.

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

입력 스키마

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

GetDeploymentRequest

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

string

필수 항목입니다. 배포 이름입니다. 형식: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}

출력 스키마

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

배포

JSON 표현 
{
  "name": string,
  "displayName": string,
  "appVersion": string,
  "channelProfile": {
    object (ChannelProfile)
  },
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "experimentConfig": {
    object (ExperimentConfig)
  },
  "whatsappCredentials": {
    object (WhatsAppCredentials)
  },
  "instagramCredentials": {
    object (InstagramCredentials)
  },
  "modelSettings": {
    object (ModelSettings)
  },
  "modality": enum (Modality)
}
필드
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)

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

object (WhatsAppCredentials)

선택사항입니다. 입력 전용입니다. WhatsApp 채널 프로필을 구성할 때 일시적인 WhatsApp 사용자 인증 정보가 필요합니다.
instagramCredentials

object (InstagramCredentials)

선택사항입니다. 입력 전용입니다. Instagram 채널 프로필을 구성할 때 임시 Instagram 사용자 인증 정보가 필요합니다.
modelSettings

object (ModelSettings)

선택사항입니다. 배포의 모델 설정입니다. 앱/에이전트 수준에서 구성된 모델 설정을 재정의합니다. 참고: 배포 수준 모델 설정 재정의는 허용 목록에 따라 관리됩니다. 이 필드를 사용 설정하려면 CXAS팀에 문의하세요.
modality

enum (Modality)

선택사항입니다. 배포의 모달리티입니다. 참고: 배포 수준 모달리티 재정의는 허용 목록 뒤에 있습니다. 이 필드를 사용 설정하려면 CXAS팀에 문의하세요.

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 비즈니스 페이지 또는 프로필의 설명입니다.

타임스탬프

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}

WhatsAppCredentials

JSON 표현 
{
  "authCode": string,
  "pin": string,
  "phoneNumber": string,
  "businessAccountId": string,
  "wabaId": string,
  "conversationProfileId": string
}
필드
authCode

string

필수 항목입니다. 삽입된 가입 흐름에서 제공하는 Meta 승인 코드입니다.
pin

string

필수 항목입니다. 사용자가 2단계 인증을 위해 만든 6자리 PIN입니다.
phoneNumber

string

필수 항목입니다. WhatsApp에 등록할 전화번호입니다.
businessAccountId

string

필수 항목입니다. 전화번호에 사용할 비즈니스 계정 ID입니다.
wabaId

string

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

string

선택사항입니다. 배포에 사용할 대화 프로필 ID입니다.

InstagramCredentials

JSON 표현 
{
  "authCode": string,
  "conversationProfileId": string
}
필드
authCode

string

필수 항목입니다. 삽입된 가입 흐름에서 제공하는 Meta 승인 코드입니다.
conversationProfileId

string

선택사항입니다. 배포에 사용할 대화 프로필 ID입니다.

ModelSettings

JSON 표현 
{
  "model": string,

  // 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 모델입니다. 설정하지 않으면 에이전트가 상위 에이전트의 모델을 상속합니다.

통합 필드 _temperature.

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

number

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

ChannelType

채널 프로필 유형입니다.

열거형
UNKNOWN 알 수 없는 채널 유형입니다.
WEB_UI 웹 UI 채널입니다.
API API 채널입니다.
TWILIO Twilio 채널입니다.
GOOGLE_TELEPHONY_PLATFORM Google 전화 통신 플랫폼 채널
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 어두운 테마

주

실험의 상태입니다.

열거형
STATE_UNSPECIFIED 지정되지 않은 상태입니다.
PENDING 지원 중단됨: 이 상태는 더 이상 사용되지 않습니다.
RUNNING 실행 상태입니다. 실험이 진행 중이며 유효합니다.
DONE 지원 중단됨: 이 상태는 더 이상 사용되지 않습니다.
EXPIRED 지원 중단됨: 이 상태는 더 이상 사용되지 않습니다.

형식

배포의 모달리티입니다.

열거형
MODALITY_UNSPECIFIED 알 수 없는 모달리티입니다.
MODALITY_TEXT 텍스트 형식입니다.
MODALITY_VOICE 음성 모달리티입니다.
MODALITY_VIDEO 동영상 모달입니다.

도구 주석

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

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

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

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