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

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

HTTP 요청

POST https://discoveryengine.googleapis.com/v1beta/{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
  // 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 인코딩 문자열입니다.

응답 본문

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

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

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

string

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

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

string

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

string (int64 format)

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

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

string

출력 전용입니다. 업로드된 파일의 확인된 콘텐츠 유형입니다(https://www.iana.org/assignments/media-types/media-types.xhtml 참고).

선택사항인 호출자 제공 AddContextFileRequest.mime_type와 달리 이는 서비스가 파일에 대해 실제로 확인한 콘텐츠 유형입니다.
byteCount

string (int64 format)

출력 전용입니다. 업로드된 파일의 크기(바이트)입니다.
fileName

string

출력 전용입니다. 파일 확장자를 포함한 업로드된 파일의 확인된 이름입니다.

호출자가 제공한 AddContextFileRequest.file_name와 달리 서비스는 호출자가 제공한 이름에 확장자가 없는 경우 확인된 mimeType와 일치하는 확장자를 추가하므로 사용 감사 로그는 일반적인 이름의 AI 생성 파일의 파일 유형도 캡처합니다.

승인 범위

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

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

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

IAM 권한

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

  • discoveryengine.sessions.addContextFile

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