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
.
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:
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 ( |
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
.
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:
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:
chunks[]
object (Chunk
)
Chunk
dibuat.
Representasi JSON |
---|
{
"chunks": [
{
object ( |
CreateChunkRequest
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:
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:
chunks[]
object (Chunk
)
Chunk
diperbarui.
Representasi JSON |
---|
{
"chunks": [
{
object ( |
UpdateChunkRequest
Permintaan untuk mengupdate Chunk
.
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 ( |
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:
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
.
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
.
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
Data yang diekstrak yang mewakili konten Chunk
.
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 |
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. |