REST Resource: projects.locations.dataStores.branches.documents.chunks

리소스: 청크

청크는 청크 모드에서 추천하거나 검색할 항목의 모든 원시 메타데이터 정보를 캡처합니다.

JSON 표현
{
  "name": string,
  "id": string,
  "content": string,
  "documentMetadata": {
    object (DocumentMetadata)
  },
  "derivedStructData": {
    object
  },
  "pageSpan": {
    object (PageSpan)
  },
  "chunkMetadata": {
    object (ChunkMetadata)
  },
  "dataUrls": [
    string
  ],
  "annotationContents": [
    string
  ],
  "annotationMetadata": [
    {
      object (AnnotationMetadata)
    }
  ],
  "relevanceScore": number
}
필드
name

string

청크의 전체 리소스 이름입니다. 형식은 projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}/documents/{documentId}/chunks/{chunk_id}입니다.

이 필드는 UTF-8로 인코딩된 문자열이어야 하며 길이 제한은 1,024자(영문 기준)입니다.

id

string

현재 청크의 고유 청크 ID입니다.

content

string

콘텐츠는 문서의 문자열입니다 (파싱된 콘텐츠).

documentMetadata

object (DocumentMetadata)

현재 청크의 문서 메타데이터입니다.

derivedStructData

object (Struct format)

출력 전용입니다. 이 필드는 OUTPUT_ONLY입니다. 원래 입력 문서에 없는 파생 데이터가 포함되어 있습니다.

pageSpan

object (PageSpan)

청크의 페이지 범위입니다.

chunkMetadata

object (ChunkMetadata)

출력 전용입니다. 현재 청크의 메타데이터입니다.

dataUrls[]

string

출력 전용입니다. 현재 청크에 이미지가 포함된 경우 이미지 데이터 URL입니다. 데이터 URL은 접두사 (data:), 데이터 유형을 나타내는 MIME 유형, 텍스트가 아닌 경우 선택적 base64 토큰, 데이터 자체의 네 부분으로 구성됩니다. data:[][;base64],

annotationContents[]

string

출력 전용입니다. 현재 청크에 주석이 포함된 경우 주석 콘텐츠입니다.

annotationMetadata[]

object (AnnotationMetadata)

출력 전용입니다. 주석 메타데이터에는 현재 청크의 구조화된 콘텐츠가 포함됩니다.

relevanceScore

number

출력 전용입니다. 유사성을 기반으로 한 관련성 점수를 나타냅니다. 점수가 높을수록 청크 관련성이 높습니다. 점수는 [-1.0, 1.0] 범위에 속합니다. SearchResponse에서만 채워집니다.

메서드

get

Document을 가져옵니다.

list

Chunk 목록을 가져옵니다.