MCP Tools Reference: ces.googleapis.com

도구: list_deployments

지정된 앱의 배포를 나열합니다.

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

입력 스키마

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

ListDeploymentsRequest

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

string

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

integer

(선택사항) 반환할 최대 배포 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 배포가 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다.
pageToken

string

(선택사항) 이전 ListDeployments 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListDeployments에 제공된 다른 모든 매개 변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.
orderBy

string

(선택사항) 정렬할 필드입니다. 'name' 및 'create_time'만 지원됩니다. 자세한 내용은 https://google.aip.dev/132#ordering을 참조하세요.

출력 스키마

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

ListDeploymentsResponse

JSON 표현 
{
  "deployments": [
    {
      object (Deployment)
    }
  ],
  "nextPageToken": string
}
필드
deployments[]

object (Deployment)

배포 목록입니다.
nextPageToken

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

배포

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),
  "agentRegistryDeployment": {
    object (AgentRegistryDeployment)
  }
}
필드
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팀에 문의하세요.
agentRegistryDeployment

object (AgentRegistryDeployment)

(선택사항) 이 배포를 Agent Registry에 배포하기 위한 구성입니다. 있는 경우 이 배포가 Agent Registry에 게시됩니다.

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)

유닉스 시간 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,
  "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 모델에 사용됩니다. 온도는 모델 응답의 무작위성을 제어합니다. 온도가 낮을수록 더 예측 가능한 대답이 생성됩니다. 온도가 높을수록 더 창의적인 대답이 생성됩니다.

AgentRegistryDeployment

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

string

(선택사항) 출력 전용입니다. 배포된 Agent Registry 서비스의 리소스 이름입니다. 형식: projects/{project}/locations/{location}/services/{service}

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 어두운 테마

주

실험 상태입니다.

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

ThinkingLevel

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

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

형식

배포의 모달리티입니다.

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

도구 주석

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

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

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

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