Method: projects.locations.apps.chatAiAssistant

지정된 어시스턴트 세션에 대해 AI 어시스턴트인 Arc를 실행합니다.

HTTP 요청

POST https://ces.googleapis.com/v1beta/{app=projects/*/locations/*/apps/*}:chatAiAssistant

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
app

string

필수 항목입니다. 어시스턴트를 실행할 앱입니다. 형식: projects/{project}/locations/{location}/apps/{app}

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "assistantSession": string,
  "message": string,
  "attachedGcsUris": [
    string
  ],
  "contextToken": string
}
필드
assistantSession

string

필수 항목입니다. 어시스턴트를 실행하는 데 사용할 어시스턴트 세션입니다. 형식: projects/{project}/locations/{location}/apps/{app}/assistantSessions/{assistantSession}
message

string

필수 항목입니다. 어시스턴트 에이전트에 보낼 메시지입니다.
attachedGcsUris[]

string

선택사항입니다. 이 차례에 사용자가 업로드한 파일의 Cloud Storage URI입니다. 예: 'gs://cxas-transient-uploads/uuid/prd.pdf'
contextToken

string

선택사항입니다. SessionService.GenerateOnboardingSuggestions에서 반환한 불투명 온보딩 컨텍스트 토큰입니다. 설정되어 있고 아직 최신 상태인 경우 서버는 첫 번째 대화 차례에 대해 온보딩 스냅샷을 다시 계산하는 대신 0 상태에 대해 계산된 온보딩 스냅샷을 재사용합니다.

응답 본문

AssistantService.ChatAiAssistant의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "eventId": string,
  "eventTime": string,
  "uiEvent": {
    object (UiEvent)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "textChunk": string,
  "statusMessage": string,
  "sessionCheckpoint": {
    object (SessionCheckpoint)
  }
  // End of mutually exclusive fields.
}
필드
eventId

string

이벤트의 고유 식별자입니다.
eventTime

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"입니다.
uiEvent

object (UiEvent)

선택사항입니다. UI 이벤트 페이로드입니다.
이벤트 페이로드입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
textChunk

string

텍스트 토큰(Gemini 대답을 단어별로 스트리밍하는 경우)
statusMessage

string

간단한 상태 업데이트
sessionCheckpoint

object (SessionCheckpoint)

사용자 의도 및 롤링 요약이 포함된 세션 체크포인트/압축 요약 이벤트입니다.
상호 배타적 필드의 끝입니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

자세한 내용은 Authentication Overview에서 확인하세요.

IAM 권한

app 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • ces.apps.update

자세한 내용은 IAM 문서를 참조하세요.