이 가이드에서는 에이전트 애플리케이션을 Google Cloud CCaaS 인스턴스에 연결하는 과정을 안내합니다.
시작하기 전에
- 설정 및 정리 페이지의 단계에 따라 배포에 사용할 프로젝트를 만들거나 구성합니다. 이 프로젝트는 에이전트 애플리케이션 및 Google Cloud CCaaS 인스턴스와 연결되어 있어야 하며 동일한
region에 있어야 합니다. 프로젝트에서 다음 사항을 확인하세요.Dialogflow API이 사용 설정되어 있습니다.- 배포에 사용할 서비스 계정에
Dialogflow API Admin(roles/dialogflow.admin) 권한이 있습니다.
- 배포에 사용할 CX Agent Studio 에이전트 애플리케이션을 만들고 구성합니다.
- 배포에 사용할 Google Cloud CCaaS 고객센터를 만들고 구성합니다.
- CX Agent Studio Google Cloud CCaaS 통합 문서에 안내된 대로 고객센터 인스턴스에서 양방향 스트리밍이 사용 설정되어 있는지 확인합니다.
- 이 가이드의 코드 스니펫에서는 gcloud CLI가 설치되어 있고 필요한 권한이 구성되어 있다고 가정합니다.
에이전트 애플리케이션을 새 대화 프로필에 연결
Google Cloud CCaaS는 useBidiStreaming가 사용 설정된 대화 프로필을 사용하여 CX Agent Studio와 통신합니다.
요청 예시
다음 샘플에서는 useBidiStreaming로 대화 프로필을 만듭니다.
- PROJECT_ID: Google Cloud 프로젝트 ID입니다.
- REGION:
us및eu멀티 리전만 지원됩니다. - DEPLOYMENT_ID: 대화 프로필과 연결할 CX Agent Studio 배포의 ID 값입니다.
- CONVERSATION_PROFILE_NAME: 이 값을 대화 프로필에 지정할 이름으로 바꿉니다.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "X-Goog-User-Project: PROJECT_ID" \ -H "Content-Type: application/json; charset=utf-8" \ -d '{ "displayName": "CONVERSATION_PROFILE_NAME", "languageCode": "en-US", "useBidiStreaming": true, "automatedAgentConfig": { "agent": "DEPLOYMENT_ID" } }' \ https://REGION-dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/REGION/conversationProfiles
응답 예시
{
"name": "projects/ccaip-apps-incub-0fcb/locations/global/conversationProfiles/bAp81fGqTg-sp3TUNYTZlw",
"displayName": "CONVERSATION_PROFILE_NAME",
"automatedAgentConfig": {
"agent": "projects/ccaip-apps-incub-0fcb/locations/global/apps/6afaa63d-49a3-4b89-8923-18cbe9b48ae5"
},
"languageCode": "en-US",
"createTime": "2025-08-21T22:11:12.782515Z",
"updateTime": "2025-08-21T22:11:12.782515Z",
"useBidiStreaming": true
}기존 대화 프로필에 에이전트 애플리케이션 연결
대화 프로필은 에이전트 애플리케이션과 연결되어야 하며 useBidiStreaming을 사용 설정하도록 구성되어야 합니다.
다음 샘플에서는 useBidiStreaming로 대화 프로필을 만듭니다.
Connect 에이전트 애플리케이션 샘플 요청
- PROJECT_ID: Google Cloud 프로젝트 ID입니다.
- INTEGRATION_ID: 응답에 반환됩니다. 새 대화 프로필의 통합 ID입니다.
- REGION:
us및eu멀티 리전만 지원됩니다. - APP_ID: 대화 프로필과 연결할 CX Agent Studio 에이전트 애플리케이션의 ID 값입니다.
curl -X PATCH \ -H "x-goog-user-project: PROJECT_ID" \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d '{"automatedAgentConfig": {"agent": "APP_ID"}}' "https://REGION-dialogflow.googleapis.com/v2beta1/INTEGRATION_ID?updateMask=automatedAgentConfig.agent"
Connect 에이전트 애플리케이션 샘플 응답
{
"name": "projects/ccaip-apps-incub-0fcb/locations/us/conversationProfiles/FRDHwh2gS-O1n5SpoxKLfg",
"displayName": "bdsac_us_polysynth_agent",
"automatedAgentConfig": {
"agent": "projects/ccaip-apps-incub-0fcb/locations/us/apps/6afaa63d-49a3-4b89-8923-18cbe9b48ae5"
},
"humanAgentAssistantConfig": {
"humanAgentSuggestionConfig": {},
"messageAnalysisConfig": {}
},
"sttConfig": {
"model": "telephony",
"useLongFormModel": true
},
"languageCode": "en-US",
"updateTime": "2025-08-06T21:35:13.388052Z",
"telephonySttConfig": {}
}useBidiStreaming 샘플 요청 사용 설정
- PROJECT_ID: Google Cloud 프로젝트 ID입니다.
- INTEGRATION_ID: 응답에 반환됩니다. 새 대화 프로필의 통합 ID입니다.
- REGION:
us및eu멀티 리전만 지원됩니다.
curl -X PATCH \ -H "x-goog-user-project:PROJECT_ID" \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -d '{ "useBidiStreaming": true }' "https://REGION-dialogflow.googleapis.com/v2beta1/INTEGRATION_ID?updateMask=useBidiStreaming"
useBidiStreaming 샘플 대답 사용 설정
{
"name": "projects/ccaip-apps-incub-0fcb/locations/us/conversationProfiles/FRDHwh2gS-O1n5SpoxKLfg",
"displayName": "bdsac_us_polysynth_agent",
"automatedAgentConfig": {
"agent": "projects/ccaip-apps-incub-0fcb/locations/us/apps/6afaa63d-49a3-4b89-8923-18cbe9b48ae5"
},
"humanAgentAssistantConfig": {
"humanAgentSuggestionConfig": {},
"messageAnalysisConfig": {}
},
"sttConfig": {
"model": "telephony",
"useLongFormModel": true
},
"languageCode": "en-US",
"updateTime": "2025-08-06T21:54:12.206269Z",
"telephonySttConfig": {},
"useBidiStreaming": true
}