Chunks

Metode: corpora.documents.chunks.create

Membuat Chunk.

Endpoint

posting https://generativelanguage.googleapis.com/v1beta/{parent=corpora/*/documents/*}/chunks

Parameter jalur

parent string

Wajib. Nama Document tempat Chunk ini akan dibuat. Contoh: corpora/my-corpus-123/documents/the-doc-abc Formatnya adalah corpora/{corpora}/documents/{document}.

Isi permintaan

Isi permintaan memuat instance Chunk.

Bidang
name string

Tidak dapat diubah. ID. Nama resource Chunk. ID (nama yang tidak mencakup awalan "corpora/*/documents/*/chunks/") dapat berisi hingga 40 karakter yang merupakan alfanumerik dalam huruf kecil atau tanda hubung (-). ID tidak boleh diawali atau diakhiri dengan tanda hubung. Jika nama kosong saat pembuatan, ID unik 12 karakter acak akan dibuat. Contoh: corpora/{corpus_id}/documents/{document_id}/chunks/123a456b789c

data object (ChunkData)

Wajib. Konten untuk Chunk, seperti string teks. Jumlah maksimum token per potongan adalah 2043.

customMetadata[] object (CustomMetadata)

Opsional. Metadata kustom yang disediakan pengguna yang disimpan sebagai key-value pair. Jumlah maksimum CustomMetadata per bagian adalah 20.

Isi respons

Jika berhasil, isi respons memuat instance Chunk yang baru dibuat.

Metode: corpora.documents.chunks.list

Mencantumkan semua Chunk dalam Document.

Endpoint

dapatkan https://generativelanguage.googleapis.com/v1beta/{parent=corpora/*/documents/*}/chunks

Parameter jalur

parent string

Wajib. Nama Document yang berisi Chunk. Contoh: corpora/my-corpus-123/documents/the-doc-abc Berbentuk corpora/{corpora}/documents/{document}.

Parameter kueri

pageSize integer

Opsional. Jumlah maksimum Chunk untuk ditampilkan (per halaman). Layanan mungkin menampilkan lebih sedikit Chunk.

Jika tidak ditentukan, maksimal 10 Chunk akan ditampilkan. Batas ukuran maksimum adalah 100 Chunk detik per halaman.

pageToken string

Opsional. Token halaman, yang diterima dari panggilan chunks.list sebelumnya.

Berikan nextPageToken yang ditampilkan dalam respons sebagai argumen ke permintaan berikutnya untuk mengambil halaman berikutnya.

Saat melakukan penomoran halaman, semua parameter lain yang diberikan untuk chunks.list harus sesuai dengan panggilan yang memberikan token halaman.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Respons dari chunks.list yang berisi daftar Chunk yang diberi nomor halaman. Chunk diurutkan berdasarkan chunk.create_time menaik.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Kolom
chunks[] object (Chunk)

Chunk yang ditampilkan.

nextPageToken string

Token, yang dapat dikirim sebagai pageToken untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, maka tidak ada halaman lagi.

Representasi JSON
{
  "chunks": [
    {
      object (Chunk)
    }
  ],
  "nextPageToken": string
}

Metode: corpora.documents.chunks.get

Mendapatkan informasi tentang Chunk tertentu.

Endpoint

dapatkan https://generativelanguage.googleapis.com/v1beta/{name=corpora/*/documents/*/chunks/*}

Parameter jalur

name string

Wajib. Nama Chunk yang akan diambil. Contoh: corpora/my-corpus-123/documents/the-doc-abc/chunks/some-chunk Formatnya adalah corpora/{corpora}/documents/{document}/chunks/{chunk}.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons memuat instance Chunk.

Metode: corpora.documents.chunks.patch

Mengupdate Chunk.

Endpoint

tambalan https://generativelanguage.googleapis.com/v1beta/{chunk.name=corpora/*/documents/*/chunks/*}

PATCH https://generativelanguage.googleapis.com/v1beta/{chunk.name=corpora/*/documents/*/chunks/*}

Parameter jalur

chunk.name string

Tidak dapat diubah. ID. Nama resource Chunk. ID (nama tidak termasuk awalan "corpora/*/documents/*/chunks/") dapat berisi maksimal 40 karakter yang berupa alfanumerik huruf kecil atau tanda hubung (-). ID tidak boleh diawali atau diakhiri dengan tanda hubung. Jika nama kosong saat pembuatan, ID unik 12 karakter acak akan dibuat. Contoh: corpora/{corpus_id}/documents/{document_id}/chunks/123a456b789c Formatnya adalah corpora/{corpora}/documents/{document}/chunks/{chunk}.

Parameter kueri

updateMask string (FieldMask format)

Wajib. Daftar kolom yang akan diperbarui. Saat ini, fitur ini hanya mendukung pembaruan customMetadata dan data.

Ini adalah daftar dipisahkan koma yang berisi nama-nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".

Isi permintaan

Isi permintaan memuat instance Chunk.

Kolom
data object (ChunkData)

Wajib. Konten untuk Chunk, seperti string teks. Jumlah maksimum token per potongan adalah 2043.

customMetadata[] object (CustomMetadata)

Opsional. Metadata kustom yang disediakan pengguna yang disimpan sebagai key-value pair. Jumlah maksimum CustomMetadata per bagian adalah 20.

Isi respons

Jika berhasil, isi respons memuat instance Chunk.

Metode: corpora.documents.chunks.delete

Menghapus Chunk.

Endpoint

delete https://generativelanguage.googleapis.com/v1beta/{name=corpora/*/documents/*/chunks/*}

Parameter jalur

name string

Wajib. Nama resource Chunk yang akan dihapus. Contoh: corpora/my-corpus-123/documents/the-doc-abc/chunks/some-chunk Berbentuk corpora/{corpora}/documents/{document}/chunks/{chunk}.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons akan kosong.

Metode: corpora.documents.chunks.batchCreate

Membuat batch Chunk.

Endpoint

posting https://generativelanguage.googleapis.com/v1beta/{parent=corpora/*/documents/*}/chunks:batchCreate

Parameter jalur

parent string

Opsional. Nama Document tempat batch Chunk ini akan dibuat. Kolom induk di setiap CreateChunkRequest harus cocok dengan nilai ini. Contoh: corpora/my-corpus-123/documents/the-doc-abc Berbentuk corpora/{corpora}/documents/{document}.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Kolom
requests[] object (CreateChunkRequest)

Wajib. Pesan permintaan yang menentukan Chunk yang akan dibuat. Maksimal 100 Chunk dapat dibuat dalam batch.

Isi respons

Respons dari chunks.batchCreate yang berisi daftar Chunk yang dibuat.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Kolom
chunks[] object (Chunk)

Chunk dibuat.

Representasi JSON
{
  "chunks": [
    {
      object (Chunk)
    }
  ]
}

CreateChunkRequest

Permintaan untuk membuat Chunk.

Bidang
parent string

Wajib. Nama Document tempat Chunk ini akan dibuat. Contoh: corpora/my-corpus-123/documents/the-doc-abc

chunk object (Chunk)

Wajib. Chunk yang akan dibuat.

Representasi JSON
{
  "parent": string,
  "chunk": {
    object (Chunk)
  }
}

Metode: corpora.documents.chunks.menyalin

Update batch Chunk.

Endpoint

posting https://generativelanguage.googleapis.com/v1beta/{parent=corpora/*/documents/*}/chunks:batchUpdate

Parameter jalur

parent string

Opsional. Nama Document yang berisi Chunk yang akan diperbarui. Kolom induk di setiap UpdateChunkRequest harus cocok dengan nilai ini. Contoh: corpora/my-corpus-123/documents/the-doc-abc Formatnya adalah corpora/{corpora}/documents/{document}.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Kolom
requests[] object (UpdateChunkRequest)

Wajib. Pesan permintaan yang menentukan Chunk yang akan diperbarui. Maksimum 100 Chunk dapat diperbarui dalam satu batch.

Isi respons

Respons dari chunks.batchUpdate yang berisi daftar Chunk yang diperbarui.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Bidang
chunks[] object (Chunk)

Chunk diperbarui.

Representasi JSON
{
  "chunks": [
    {
      object (Chunk)
    }
  ]
}

UpdateChunkRequest

Permintaan untuk mengupdate Chunk.

Bidang
chunk object (Chunk)

Wajib. Chunk yang akan diperbarui.

updateMask string (FieldMask format)

Wajib. Daftar kolom yang akan diperbarui. Saat ini, API tersebut hanya mendukung update customMetadata dan data.

Ini adalah daftar yang dipisahkan koma yang berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".

Representasi JSON
{
  "chunk": {
    object (Chunk)
  },
  "updateMask": string
}

Metode: corpora.documents.chunks.batchDelete

Menghapus batch Chunk.

Endpoint

posting https://generativelanguage.googleapis.com/v1beta/{parent=corpora/*/documents/*}/chunks:batchDelete

Parameter jalur

parent string

Opsional. Nama Document yang berisi Chunk yang akan dihapus. Kolom induk di setiap DeleteChunkRequest harus cocok dengan nilai ini. Contoh: corpora/my-corpus-123/documents/the-doc-abc Formatnya adalah corpora/{corpora}/documents/{document}.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Kolom
requests[] object (DeleteChunkRequest)

Wajib. Pesan permintaan yang menentukan Chunk yang akan dihapus.

Isi respons

Jika berhasil, isi respons akan kosong.

DeleteChunkRequest

Permintaan untuk menghapus Chunk.

Bidang
name string

Wajib. Nama resource Chunk yang akan dihapus. Contoh: corpora/my-corpus-123/documents/the-doc-abc/chunks/some-chunk

Representasi JSON
{
  "name": string
}

Resource REST: corpora.documents.chunks

Resource: Chunk

Chunk adalah subbagian dari Document yang diperlakukan sebagai unit independen untuk tujuan representasi dan penyimpanan vektor. Corpus dapat memiliki maksimum 1 juta Chunk.

Kolom
name string

Tidak dapat diubah. ID. Nama resource Chunk. ID (nama yang tidak mencakup awalan "corpora/*/documents/*/chunks/") dapat berisi hingga 40 karakter yang merupakan alfanumerik dalam huruf kecil atau tanda hubung (-). ID tidak boleh diawali atau diakhiri dengan tanda hubung. Jika nama tersebut kosong saat dibuat, ID unik 12 karakter acak akan dibuat. Contoh: corpora/{corpus_id}/documents/{document_id}/chunks/123a456b789c

data object (ChunkData)

Wajib. Konten untuk Chunk, seperti string teks. Jumlah maksimum token per potongan adalah 2043.

customMetadata[] object (CustomMetadata)

Opsional. Metadata kustom yang disediakan pengguna yang disimpan sebagai key-value pair. Jumlah maksimum CustomMetadata per bagian adalah 20.

createTime string (Timestamp format)

Hanya output. Stempel waktu saat Chunk dibuat.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

updateTime string (Timestamp format)

Hanya output. Stempel waktu saat Chunk terakhir diperbarui.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

state enum (State)

Hanya output. Status Chunk saat ini.

Representasi JSON
{
  "name": string,
  "data": {
    object (ChunkData)
  },
  "customMetadata": [
    {
      object (CustomMetadata)
    }
  ],
  "createTime": string,
  "updateTime": string,
  "state": enum (State)
}

ChunkData

Data yang diekstrak yang mewakili konten Chunk.

Bidang

Kolom union data.

data hanya dapat berupa salah satu dari hal berikut:

stringValue string

Konten Chunk sebagai string. Jumlah maksimum token per potongan adalah 2043.

Representasi JSON
{

  // Union field data can be only one of the following:
  "stringValue": string
  // End of list of possible types for union field data.
}

Negara Bagian

Status untuk siklus proses Chunk.

Enum
STATE_UNSPECIFIED Nilai default. Nilai ini digunakan jika status dihilangkan.
STATE_PENDING_PROCESSING Chunk sedang diproses (penyematan dan penyimpanan vektor).
STATE_ACTIVE Chunk diproses dan tersedia untuk pembuatan kueri.
STATE_FAILED Pemrosesan Chunk gagal.