Gemini Enterprise for Customer Experience API

서비스: ces.googleapis.com

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

검색 문서

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

서비스 엔드포인트

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

  • https://ces.googleapis.com

REST 리소스: v1beta.projects.locations

메서드
get GET /v1beta/{name=projects/*/locations/*}
위치 정보를 가져옵니다.
getSecuritySettings GET /v1beta/{name=projects/*/locations/*/securitySettings}
프로젝트 및 위치의 보안 설정을 가져옵니다.
list GET /v1beta/{name=projects/*}/locations
이 서비스에 지원되는 위치 정보를 나열합니다.
updateSecuritySettings PATCH /v1beta/{securitySettings.name=projects/*/locations/*/securitySettings}
프로젝트 및 위치의 보안 설정을 업데이트합니다.

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

메서드
create POST /v1beta/{parent=projects/*/locations/*}/apps
지정된 프로젝트와 위치에 새 앱을 만듭니다.
delete DELETE /v1beta/{name=projects/*/locations/*/apps/*}
지정된 앱을 삭제합니다.
executeTool POST /v1beta/{parent=projects/*/locations/*/apps/*}:executeTool
지정된 인수로 지정된 도구를 실행합니다.
exportApp POST /v1beta/{name=projects/*/locations/*/apps/*}:exportApp
지정된 앱을 내보냅니다.
generateAppResource POST /v1beta/{parent=projects/*/locations/*/apps/*}:generateAppResource
특정 리소스 (예:
get GET /v1beta/{name=projects/*/locations/*/apps/*}
지정된 앱의 세부정보를 가져옵니다.
getExtendedAgentCard GET /v1beta/{tenant=projects/*/locations/*/apps/*}/extendedAgentCard
인증된 에이전트의 확장된 에이전트 카드를 가져옵니다.
importApp POST /v1beta/{parent=projects/*/locations/*}/apps:importApp
지정된 앱을 가져옵니다.
importEvaluations POST /v1beta/{parent=projects/*/locations/*/apps/*}:importEvaluations
평가를 앱으로 가져옵니다.
list GET /v1beta/{parent=projects/*/locations/*}/apps
지정된 프로젝트와 위치의 앱을 나열합니다.
patch PATCH /v1beta/{app.name=projects/*/locations/*/apps/*}
지정된 앱을 업데이트합니다.
retrieveToolSchema POST /v1beta/{parent=projects/*/locations/*/apps/*}:retrieveToolSchema
지정된 도구의 스키마를 가져옵니다.
runEvaluation POST /v1beta/{app=projects/*/locations/*/apps/*}:runEvaluation
앱 평가를 실행합니다.
testPersonaVoice POST /v1beta/{app=projects/*/locations/*/apps/*}:testPersonaVoice
페르소나의 음성을 테스트합니다.

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

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

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

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

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

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

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

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

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

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

REST 리소스: v1beta.projects.locations.apps.evaluationDatasets

메서드
create POST /v1beta/{parent=projects/*/locations/*/apps/*}/evaluationDatasets
평가 데이터 세트를 만듭니다.
delete DELETE /v1beta/{name=projects/*/locations/*/apps/*/evaluationDatasets/*}
평가 데이터 세트를 삭제합니다.
get GET /v1beta/{name=projects/*/locations/*/apps/*/evaluationDatasets/*}
지정된 평가 데이터 세트의 세부정보를 가져옵니다.
list GET /v1beta/{parent=projects/*/locations/*/apps/*}/evaluationDatasets
지정된 앱의 모든 평가 데이터 세트를 나열합니다.
patch PATCH /v1beta/{evaluationDataset.name=projects/*/locations/*/apps/*/evaluationDatasets/*}
평가 데이터 세트를 업데이트합니다.

REST 리소스: v1beta.projects.locations.apps.evaluationExpectations

메서드
create POST /v1beta/{parent=projects/*/locations/*/apps/*}/evaluationExpectations
평가 기대치를 만듭니다.
delete DELETE /v1beta/{name=projects/*/locations/*/apps/*/evaluationExpectations/*}
평가 기대치를 삭제합니다.
get GET /v1beta/{name=projects/*/locations/*/apps/*/evaluationExpectations/*}
지정된 평가 기대치의 세부정보를 가져옵니다.
list GET /v1beta/{parent=projects/*/locations/*/apps/*}/evaluationExpectations
지정된 앱의 모든 평가 기대치를 나열합니다.
patch PATCH /v1beta/{evaluationExpectation.name=projects/*/locations/*/apps/*/evaluationExpectations/*}
평가 기대치를 업데이트합니다.

REST 리소스: v1beta.projects.locations.apps.evaluationRuns

메서드
delete DELETE /v1beta/{name=projects/*/locations/*/apps/*/evaluationRuns/*}
평가 실행을 삭제합니다.
export POST /v1beta/{parent=projects/*/locations/*/apps/*}/evaluationRuns:export
평가 실행을 내보냅니다.
get GET /v1beta/{name=projects/*/locations/*/apps/*/evaluationRuns/*}
지정된 평가 실행의 세부정보를 가져옵니다.
list GET /v1beta/{parent=projects/*/locations/*/apps/*}/evaluationRuns
지정된 앱의 모든 평가 실행을 나열합니다.

REST 리소스: v1beta.projects.locations.apps.evaluations

메서드
create POST /v1beta/{parent=projects/*/locations/*/apps/*}/evaluations
평가를 만듭니다.
delete DELETE /v1beta/{name=projects/*/locations/*/apps/*/evaluations/*}
평가를 삭제합니다.
export POST /v1beta/{parent=projects/*/locations/*/apps/*}/evaluations:export
평가를 내보냅니다.
get GET /v1beta/{name=projects/*/locations/*/apps/*/evaluations/*}
지정된 평가의 세부정보를 가져옵니다.
list GET /v1beta/{parent=projects/*/locations/*/apps/*}/evaluations
지정된 앱의 모든 평가를 나열합니다.
patch PATCH /v1beta/{evaluation.name=projects/*/locations/*/apps/*/evaluations/*}
평가를 업데이트합니다.
uploadEvaluationAudio POST /v1beta/{name=projects/*/locations/*/apps/*/evaluations/*}:uploadEvaluationAudio
골든 평가에 사용할 오디오를 업로드합니다.

REST 리소스: v1beta.projects.locations.apps.evaluations.results

메서드
delete DELETE /v1beta/{name=projects/*/locations/*/apps/*/evaluations/*/results/*}
평가 결과를 삭제합니다.
export POST /v1beta/{parent=projects/*/locations/*/apps/*/evaluations/*}/results:export
평가 결과를 내보냅니다.
get GET /v1beta/{name=projects/*/locations/*/apps/*/evaluations/*/results/*}
지정된 평가 결과의 세부정보를 가져옵니다.
list GET /v1beta/{parent=projects/*/locations/*/apps/*/evaluations/*}/results
지정된 평가의 모든 평가 결과를 나열합니다.
runEvaluationResultMetrics POST /v1beta/{evaluationResultId=projects/*/locations/*/apps/*/evaluations/*/results/*}:runEvaluationResultMetrics
기존 평가 결과에 측정항목을 실행합니다.

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

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

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

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

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

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

REST 리소스: v1beta.projects.locations.apps.scheduledEvaluationRuns

메서드
create POST /v1beta/{parent=projects/*/locations/*/apps/*}/scheduledEvaluationRuns
예약된 평가 실행을 만듭니다.
delete DELETE /v1beta/{name=projects/*/locations/*/apps/*/scheduledEvaluationRuns/*}
예약된 평가 실행을 삭제합니다.
get GET /v1beta/{name=projects/*/locations/*/apps/*/scheduledEvaluationRuns/*}
지정된 예약 평가 실행의 세부정보를 가져옵니다.
list GET /v1beta/{parent=projects/*/locations/*/apps/*}/scheduledEvaluationRuns
지정된 앱의 모든 예약된 평가 실행을 나열합니다.
patch PATCH /v1beta/{scheduledEvaluationRun.name=projects/*/locations/*/apps/*/scheduledEvaluationRuns/*}
예약된 평가 실행을 업데이트합니다.

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

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

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

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

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

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

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

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

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

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

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

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