Gemini Enterprise for Customer Experience API

서비스: ces.googleapis.com

이 서비스를 호출하려면 Google에서 제공하는 클라이언트 라이브러리를 사용하는 것이 좋습니다. 애플리케이션에서 자체 라이브러리를 사용하여 이 서비스를 호출해야 한다면 API 요청을 실행할 때 다음 정보를 사용해야 합니다.

검색 문서

탐색 문서는 머신에서 읽을 수 있는 사양이며 REST API를 설명하고 사용하는 데 참고할 수 있습니다. 또한 클라이언트 라이브러리, IDE 플러그인, 기타 Google API와 상호작용하는 도구를 빌드하는 데 사용됩니다. 하나의 서비스는 여러 개의 탐색 문서를 제공할 수 있습니다. 이 서비스는 다음 검색 문서를 제공합니다.

서비스 엔드포인트

서비스 엔드포인트는 API 서비스의 네트워크 주소를 지정하는 기준 URL입니다. 하나의 서비스는 여러 서비스 엔드포인트를 포함할 수 있습니다. 이 서비스에는 다음 서비스 엔드포인트가 포함되고, 그 아래의 모든 URI가 이 서비스 엔드포인트와 관련됩니다.

  • https://ces.googleapis.com

REST 리소스: tasks

메서드
cancel POST /tasks/{id}:cancel
진행 중인 작업을 취소합니다.
get GET /tasks/{id}
작업의 최신 상태를 가져옵니다.
list GET /tasks
지정된 필터와 일치하는 작업을 나열합니다.
subscribe GET /tasks/{id}:subscribe
종료 상태가 아닌 작업의 작업 업데이트를 구독합니다.

REST 리소스: tasks.pushNotificationConfigs

메서드
create POST /tasks/{taskId}/pushNotificationConfigs
작업의 푸시 알림 구성을 만듭니다.
delete DELETE /tasks/{taskId}/pushNotificationConfigs/{id}
작업의 푸시 알림 구성을 삭제합니다.
get GET /tasks/{taskId}/pushNotificationConfigs/{id}
작업의 푸시 알림 구성을 가져옵니다.
list GET /tasks/{taskId}/pushNotificationConfigs
작업에 대해 구성된 푸시 알림 목록을 가져옵니다.

REST 리소스: v1.projects.locations

메서드
get GET /v1/{name=projects/*/locations/*}
위치 정보를 가져옵니다.
list GET /v1/{name=projects/*}/locations
이 서비스에 지원되는 위치 정보를 나열합니다.

REST 리소스: v1.projects.locations.apps

메서드
create POST /v1/{parent=projects/*/locations/*}/apps
지정된 프로젝트와 위치에 새 앱을 만듭니다.
delete DELETE /v1/{name=projects/*/locations/*/apps/*}
지정된 앱을 삭제합니다.
executeTool POST /v1/{parent=projects/*/locations/*/apps/*}:executeTool
지정된 인수를 사용하여 지정된 도구를 실행합니다.
exportApp POST /v1/{name=projects/*/locations/*/apps/*}:exportApp
지정된 앱을 내보냅니다.
get GET /v1/{name=projects/*/locations/*/apps/*}
지정된 앱의 세부정보를 가져옵니다.
getExtendedAgentCard GET /v1/{tenant=projects/*/locations/*/apps/*}/extendedAgentCard
인증된 에이전트의 확장된 에이전트 카드를 가져옵니다.
importApp POST /v1/{parent=projects/*/locations/*}/apps:importApp
지정된 앱을 가져옵니다.
list GET /v1/{parent=projects/*/locations/*}/apps
지정된 프로젝트와 위치의 앱을 나열합니다.
patch PATCH /v1/{app.name=projects/*/locations/*/apps/*}
지정된 앱을 업데이트합니다.
retrieveToolSchema POST /v1/{parent=projects/*/locations/*/apps/*}:retrieveToolSchema
지정된 도구의 스키마를 가져옵니다.

REST 리소스: v1.projects.locations.apps.agents

메서드
create POST /v1/{parent=projects/*/locations/*/apps/*}/agents
지정된 앱에 새 에이전트를 만듭니다.
delete DELETE /v1/{name=projects/*/locations/*/apps/*/agents/*}
지정된 에이전트를 삭제합니다.
get GET /v1/{name=projects/*/locations/*/apps/*/agents/*}
지정된 에이전트의 세부정보를 가져옵니다.
list GET /v1/{parent=projects/*/locations/*/apps/*}/agents
지정된 앱의 에이전트를 나열합니다.
patch PATCH /v1/{agent.name=projects/*/locations/*/apps/*/agents/*}
지정된 에이전트를 업데이트합니다.

REST 리소스: v1.projects.locations.apps.changelogs

메서드
get GET /v1/{name=projects/*/locations/*/apps/*/changelogs/*}
지정된 변경 로그를 가져옵니다.
list GET /v1/{parent=projects/*/locations/*/apps/*}/changelogs
지정된 앱의 변경 로그를 나열합니다.

REST 리소스: v1.projects.locations.apps.conversations

메서드
batchDelete POST /v1/{parent=projects/*/locations/*/apps/*}/conversations:batchDelete
지정된 대화를 일괄 삭제합니다.
delete DELETE /v1/{name=projects/*/locations/*/apps/*/conversations/*}
지정된 대화를 삭제합니다.
get GET /v1/{name=projects/*/locations/*/apps/*/conversations/*}
지정된 대화의 세부정보를 가져옵니다.
list GET /v1/{parent=projects/*/locations/*/apps/*}/conversations
지정된 앱의 대화를 나열합니다.

REST 리소스: v1.projects.locations.apps.deployments

메서드
create POST /v1/{parent=projects/*/locations/*/apps/*}/deployments
지정된 앱에 새 배포를 만듭니다.
delete DELETE /v1/{name=projects/*/locations/*/apps/*/deployments/*}
지정된 배포를 삭제합니다.
get GET /v1/{name=projects/*/locations/*/apps/*/deployments/*}
지정된 배포의 세부정보를 가져옵니다.
getExtendedAgentCard GET /v1/{tenant=projects/*/locations/*/apps/*/deployments/*}/extendedAgentCard
인증된 에이전트의 확장된 에이전트 카드를 가져옵니다.
list GET /v1/{parent=projects/*/locations/*/apps/*}/deployments
지정된 앱의 배포를 나열합니다.
patch PATCH /v1/{deployment.name=projects/*/locations/*/apps/*/deployments/*}
지정된 배포를 업데이트합니다.

REST 리소스: v1.projects.locations.apps.deployments.message

메서드
send POST /v1/{tenant=projects/*/locations/*/apps/*/deployments/*}/message:send
에이전트에게 메시지를 보냅니다.
stream POST /v1/{tenant=projects/*/locations/*/apps/*/deployments/*}/message:stream
상담사에게 스트리밍 메시지를 전송하여 실시간 상호작용 및 상태 업데이트를 지원합니다.

REST 리소스: v1.projects.locations.apps.examples

메서드
create POST /v1/{parent=projects/*/locations/*/apps/*}/examples
지정된 앱에 새 예시를 만듭니다.
delete DELETE /v1/{name=projects/*/locations/*/apps/*/examples/*}
지정된 예시를 삭제합니다.
get GET /v1/{name=projects/*/locations/*/apps/*/examples/*}
지정된 예의 세부정보를 가져옵니다.
list GET /v1/{parent=projects/*/locations/*/apps/*}/examples
지정된 앱의 예시를 나열합니다.
patch PATCH /v1/{example.name=projects/*/locations/*/apps/*/examples/*}
지정된 예시를 업데이트합니다.

REST 리소스: v1.projects.locations.apps.guardrails

메서드
create POST /v1/{parent=projects/*/locations/*/apps/*}/guardrails
지정된 앱에 새로운 가드레일을 만듭니다.
delete DELETE /v1/{name=projects/*/locations/*/apps/*/guardrails/*}
지정된 가드레일을 삭제합니다.
get GET /v1/{name=projects/*/locations/*/apps/*/guardrails/*}
지정된 가드레일의 세부정보를 가져옵니다.
list GET /v1/{parent=projects/*/locations/*/apps/*}/guardrails
지정된 앱의 가이드라인을 나열합니다.
patch PATCH /v1/{guardrail.name=projects/*/locations/*/apps/*/guardrails/*}
지정된 가드레일을 업데이트합니다.

REST 리소스: v1.projects.locations.apps.message

메서드
send POST /v1/{tenant=projects/*/locations/*/apps/*}/message:send
에이전트에게 메시지를 보냅니다.
stream POST /v1/{tenant=projects/*/locations/*/apps/*}/message:stream
상담사에게 스트리밍 메시지를 전송하여 실시간 상호작용 및 상태 업데이트를 지원합니다.

REST 리소스: v1.projects.locations.apps.sessions

메서드
generateChatToken POST /v1/{name=projects/*/locations/*/apps/*/sessions/*}:generateChatToken
세션 API로 인증할 채팅 위젯의 세션 범위 토큰을 생성합니다.
runSession POST /v1/{config.session=projects/*/locations/*/apps/*/sessions/*}:runSession
세션 내에서 CES 에이전트와의 단일 턴 상호작용을 시작합니다.
streamRunSession POST /v1/{config.session=projects/*/locations/*/apps/*/sessions/*}:streamRunSession
CES 에이전트와의 단일 턴 상호작용을 시작합니다.

REST 리소스: v1.projects.locations.apps.tools

메서드
create POST /v1/{parent=projects/*/locations/*/apps/*}/tools
지정된 앱에 새 도구를 만듭니다.
delete DELETE /v1/{name=projects/*/locations/*/apps/*/tools/*}
지정된 도구를 삭제합니다.
get GET /v1/{name=projects/*/locations/*/apps/*/tools/*}
지정된 도구의 세부정보를 가져옵니다.
list GET /v1/{parent=projects/*/locations/*/apps/*}/tools
지정된 앱의 도구를 나열합니다.
patch PATCH /v1/{tool.name=projects/*/locations/*/apps/*/tools/*}
지정된 도구를 업데이트합니다.

REST 리소스: v1.projects.locations.apps.toolsets

메서드
create POST /v1/{parent=projects/*/locations/*/apps/*}/toolsets
지정된 앱에 새 도구 모음을 만듭니다.
delete DELETE /v1/{name=projects/*/locations/*/apps/*/toolsets/*}
지정된 도구 모음을 삭제합니다.
get GET /v1/{name=projects/*/locations/*/apps/*/toolsets/*}
지정된 도구 모음의 세부정보를 가져옵니다.
list GET /v1/{parent=projects/*/locations/*/apps/*}/toolsets
지정된 앱의 툴셋을 나열합니다.
patch PATCH /v1/{toolset.name=projects/*/locations/*/apps/*/toolsets/*}
지정된 도구 모음을 업데이트합니다.
retrieveTools POST /v1/{toolset=projects/*/locations/*/apps/*/toolsets/*}:retrieveTools
지정된 도구 세트에 포함된 도구 목록을 가져옵니다.

REST 리소스: v1.projects.locations.apps.versions

메서드
create POST /v1/{parent=projects/*/locations/*/apps/*}/versions
지정된 앱에 새 앱 버전을 만듭니다.
delete DELETE /v1/{name=projects/*/locations/*/apps/*/versions/*}
지정된 앱 버전을 삭제합니다.
get GET /v1/{name=projects/*/locations/*/apps/*/versions/*}
지정된 앱 버전의 세부정보를 가져옵니다.
getExtendedAgentCard GET /v1/{tenant=projects/*/locations/*/apps/*/versions/*}/extendedAgentCard
인증된 에이전트의 확장된 에이전트 카드를 가져옵니다.
list GET /v1/{parent=projects/*/locations/*/apps/*}/versions
지정된 앱의 모든 앱 버전을 나열합니다.
restore POST /v1/{name=projects/*/locations/*/apps/*/versions/*}:restore
지정된 앱 버전을 복원합니다.

REST 리소스: v1.projects.locations.apps.versions.message

메서드
send POST /v1/{tenant=projects/*/locations/*/apps/*/versions/*}/message:send
에이전트에게 메시지를 보냅니다.
stream POST /v1/{tenant=projects/*/locations/*/apps/*/versions/*}/message:stream
상담사에게 스트리밍 메시지를 전송하여 실시간 상호작용 및 상태 업데이트를 지원합니다.

REST 리소스: v1.projects.locations.operations

메서드
cancel POST /v1/{name=projects/*/locations/*/operations/*}:cancel
장기 실행 작업에 대한 비동기 취소를 시작합니다.
delete DELETE /v1/{name=projects/*/locations/*/operations/*}
장기 실행 작업을 삭제합니다.
get GET /v1/{name=projects/*/locations/*/operations/*}
장기 실행 작업의 최신 상태를 가져옵니다.
list GET /v1/{name=projects/*/locations/*}/operations
요청에 지정된 필터와 일치하는 작업을 나열합니다.