Method: projects.locations.collections.engines.sessions.addContextFile

세션 내에서 지원 호출의 소스로 사용할 컨텍스트 파일을 업로드합니다.

HTTP 요청

POST https://discoveryengine.googleapis.com/v1alpha/{name=projects/*/locations/*/collections/*/engines/*/sessions/*}:addContextFile

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

경로 매개변수

매개변수
name

string

필수 항목입니다. 세션의 리소스 이름입니다. 형식: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}

-이 세션 ID로 지정되면 자동으로 생성된 ID로 새 세션이 생성됩니다.

요청 본문

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

JSON 표현 
{
  "fileName": string,
  "mimeType": string,

  // Union field file can be only one of the following:
  "fileContents": string,
  "document": string
  // End of list of possible types for union field file.
}
필드
fileName

string

필수 항목입니다. 파일 이름입니다.
mimeType

string

(선택사항) 파일의 콘텐츠 유형입니다(https://www.iana.org/assignments/media-types/media-types.xhtml 참고).

데이터 소스에서 콘텐츠 유형을 제공하지 않는 경우 이 필드는 필수입니다.
통합 필드 file. 파일의 콘텐츠입니다. file은 다음 중 하나여야 합니다.
fileContents

string (bytes format)

인라인으로 제공된 파일 콘텐츠입니다.

base64 인코딩 문자열입니다.
document

string

Document의 리소스 이름입니다. 호출자에게 Document에 액세스할 권한이 있어야 합니다. 그렇지 않으면 PERMISSION_DENIED 오류가 반환됩니다.

형식: projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}/documents/{document}

응답 본문

AssistantService.AddContextFile 메서드에 대한 응답입니다.

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

JSON 표현 
{
  "session": string,
  "fileId": string,
  "tokenCount": string
}
필드
session

string

제공된 세션 이름 또는 새로 생성된 세션 이름입니다.

형식: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}
fileId

string

업로드된 파일의 ID입니다.
tokenCount
(deprecated)

string (int64 format)

지원 중단됨: 이 필드는 일부 파일 형식에 설정되지 않으며 최종적으로 삭제됩니다.

토큰으로 측정된 파일의 길이입니다.

승인 범위

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

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

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

  • discoveryengine.sessions.addContextFile

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