Chunks

Yöntem: Corpora.documents.chunks.create

Chunk oluşturur.

Uç nokta

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

Yol parametreleri

parent string

Zorunlu. Bu Chunk'un oluşturulacağı Document'nin adı. Örnek: corpora/my-corpus-123/documents/the-doc-abc corpora/{corpora}/documents/{document} biçimindedir.

İstek içeriği

İstek metni, Chunk öğesinin bir örneğini içerir.

Alanlar
name string

Değişmez. Tanımlayıcı. Chunk kaynak adı. Kimlik ("Corpora/*/documents/*/chunks/" öneki hariç olmak üzere ad), en fazla 40 küçük harf alfanümerik veya kısa çizgi (-) içerebilir. Kimlik, tireyle başlayamaz veya bitemez. Oluşturma sırasında ad boşsa 12 karakterlik rastgele bir benzersiz kimlik oluşturulur. Örnek: corpora/{corpus_id}/documents/{document_id}/chunks/123a456b789c

data object (ChunkData)

Zorunlu. Chunk öğesinin içeriği (ör. metin dizesi). Parça başına maksimum jeton sayısı 2043'tür.

customMetadata[] object (CustomMetadata)

İsteğe bağlı. Kullanıcı tarafından sağlanan, anahtar/değer çiftleri olarak depolanan özel meta veriler. Yığın başına maksimum CustomMetadata sayısı 20'dir.

Yanıt gövdesi

Başarılı olursa yanıt metni, yeni oluşturulmuş bir Chunk örneği içerir.

Yöntem: Corpora.documents.chunks.list

Document içindeki tüm Chunk'leri listeler.

Uç nokta

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

Yol parametreleri

parent string

Zorunlu. Chunk içeren Document öğesinin adı. Örnek: corpora/my-corpus-123/documents/the-doc-abc corpora/{corpora}/documents/{document} biçimindedir.

Sorgu parametreleri

pageSize integer

İsteğe bağlı. Döndürülecek maksimum Chunk sayısı (sayfa başına). Hizmet daha az Chunk döndürebilir.

Belirtilmemişse en fazla 10 Chunk döndürülür. Maksimum boyut sınırı sayfa başına 100 Chunk'tır.

pageToken string

İsteğe bağlı. Önceki chunks.list çağrısından alınan bir sayfa jetonu.

Sonraki sayfayı almak için yanıtta döndürülen nextPageToken değerini bir sonraki isteğinin bağımsız değişkeni olarak sağlayın.

Sayfalara ayırma işlemi sırasında chunks.list öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

chunks.list tarafından gönderilen, Chunk saniyelik sayfalara ayrılmış bir liste içeren yanıt. Chunk değerleri artan chunk.create_time değerine göre sıralanır.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

Alanlar
chunks[] object (Chunk)

Döndürülen Chunk değerleri.

nextPageToken string

Sonraki sayfayı almak için pageToken olarak gönderilebilecek bir jeton. Bu alan atlanırsa başka sayfa yoktur.

JSON gösterimi 
{
  "chunks": [
    {
      object (Chunk)
    }
  ],
  "nextPageToken": string
}

Yöntem: Corpora.documents.chunks.get

Belirli bir Chunk hakkında bilgi alır.

Uç nokta

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

Yol parametreleri

name string

Zorunlu. Alınacak Chunk öğesinin adı. Örnek: corpora/my-corpus-123/documents/the-doc-abc/chunks/some-chunk corpora/{corpora}/documents/{document}/chunks/{chunk} biçimindedir.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt metni

Başarılıysa yanıt metni, Chunk öğesinin bir örneğini içerir.

Yöntem: corpora.documents.chunks.patch

Chunk günceller.

Uç nokta

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

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

Yol parametreleri

chunk.name string

Sabit. Tanımlayıcı. Chunk kaynak adı. Kimlik ("corpora/*/documents/*/chunks/" ön ekinden hariç tutulan ad), küçük harf alfanümerik karakterler veya kısa çizgiler (-) olmak üzere en fazla 40 karakter içerebilir. Kimlik, kısa çizgiyle başlayamaz veya bitemez. Oluşturma sırasında ad boş bırakılırsa 12 karakterli rastgele bir benzersiz kimlik oluşturulur. Örnek: corpora/{corpus_id}/documents/{document_id}/chunks/123a456b789c corpora/{corpora}/documents/{document}/chunks/{chunk} biçimindedir.

Sorgu parametreleri

updateMask string (FieldMask format)

Zorunlu. Güncellenecek alanların listesi. Şu anda bu işlem yalnızca customMetadata ve data sürümlerinin güncellenmesini desteklemektedir.

Bu, tam nitelikli alan adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo".

İstek içeriği

İstek metni, Chunk öğesinin bir örneğini içerir.

Alanlar
data object (ChunkData)

Zorunlu. Chunk öğesinin içeriği (ör. metin dizesi). Parça başına maksimum jeton sayısı 2043'tür.

customMetadata[] object (CustomMetadata)

İsteğe bağlı. Kullanıcı tarafından sağlanan, anahtar/değer çiftleri olarak depolanan özel meta veriler. Yığın başına maksimum CustomMetadata sayısı 20'dir.

Yanıt gövdesi

Başarılıysa yanıt metni, Chunk öğesinin bir örneğini içerir.

Yöntem: Corpora.documents.chunks.delete

Chunk öğesini siler.

Uç nokta

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

Yol parametreleri

name string

Zorunlu. Silinecek Chunk kaynağının adı. Örnek: corpora/my-corpus-123/documents/the-doc-abc/chunks/some-chunk corpora/{corpora}/documents/{document}/chunks/{chunk} biçimindedir.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Başarılı olursa yanıt metni boş olur.

Yöntem: Corpora.documents.chunks.batchCreate

Chunk'leri toplu olarak oluşturun.

Uç nokta

yayınlayacağım https://generativelanguage.googleapis.com/v1beta/{parent=corpora/*/documents/*}/chunks:batchCreate

Yol parametreleri

parent string

İsteğe bağlı. Bu Chunk grubunu oluşturacağınız Document'nin adı. Her CreateChunkRequest öğesindeki üst alan bu değerle eşleşmelidir. Örnek: corpora/my-corpus-123/documents/the-doc-abc corpora/{corpora}/documents/{document} biçimindedir.

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

Alanlar
requests[] object (CreateChunkRequest)

Zorunlu. Oluşturulacak Chunk öğelerini belirten istek mesajları. Bir grupta en fazla 100 Chunk oluşturulabilir.

Yanıt gövdesi

Oluşturulan Chunk öğelerinin listesini içeren chunks.batchCreate yanıtı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

Alanlar
chunks[] object (Chunk)

Chunk oluşturuldu.

JSON gösterimi 
{
  "chunks": [
    {
      object (Chunk)
    }
  ]
}

CreateChunkRequest

Chunk oluşturma isteği.

Alanlar
parent string

Zorunlu. Bu Chunk öğesinin oluşturulacağı Document biriminin adı. Örnek: corpora/my-corpus-123/documents/the-doc-abc

chunk object (Chunk)

Zorunlu. Oluşturulacak Chunk.

JSON gösterimi 
{
  "parent": string,
  "chunk": {
    object (Chunk)
  }
}

Yöntem: Corpora.documents.chunks.batchUpdate

Chunk öğelerini toplu olarak güncelleyin.

Uç nokta

yayınlayacağım https://generativelanguage.googleapis.com/v1beta/{parent=corpora/*/documents/*}/chunks:batchUpdate

Yol parametreleri

parent string

İsteğe bağlı. Güncellenecek Chunk öğelerini içeren Document öğesinin adı. Her UpdateChunkRequest'teki üst alan bu değerle eşleşmelidir. Örnek: corpora/my-corpus-123/documents/the-doc-abc corpora/{corpora}/documents/{document} biçimindedir.

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

Alanlar
requests[] object (UpdateChunkRequest)

Zorunlu. Güncellenecek Chunk öğelerini belirten istek mesajları. Bir toplu işlemde en fazla 100 Chunk güncellenebilir.

Yanıt gövdesi

chunks.batchUpdate tarafından sağlanan, güncellenmiş Chunk öğelerinin listesini içeren yanıt.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

Alanlar
chunks[] object (Chunk)

Chunk güncellendi.

JSON gösterimi 
{
  "chunks": [
    {
      object (Chunk)
    }
  ]
}

UpdateChunkRequest

Chunk güncelleme isteği.

Alanlar
chunk object (Chunk)

Zorunlu. Güncellenecek Chunk.

updateMask string (FieldMask format)

Zorunlu. Güncellenecek alanların listesi. Şu anda yalnızca customMetadata ve data değerlerinin güncellenmesi desteklenmektedir.

Bu, alanların tam nitelikli adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo".

JSON gösterimi 
{
  "chunk": {
    object (Chunk)
  },
  "updateMask": string
}

Yöntem: Corpora.documents.chunks.batchDelete

Chunk'leri toplu olarak silme

Uç nokta

yayınlayacağım https://generativelanguage.googleapis.com/v1beta/{parent=corpora/*/documents/*}/chunks:batchDelete

Yol parametreleri

parent string

İsteğe bağlı. Silinecek Chunk'ları içeren Document'nin adı. Her DeleteChunkRequest içindeki üst alan bu değerle eşleşmelidir. Örnek: corpora/my-corpus-123/documents/the-doc-abc corpora/{corpora}/documents/{document} biçimindedir.

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

Alanlar
requests[] object (DeleteChunkRequest)

Zorunlu. Silinecek Chunk öğelerini belirten istek mesajları.

Yanıt gövdesi

Başarılı olursa yanıt gövdesi boş olur.

DeleteChunkRequest

Chunk silme isteği

Alanlar
name string

Zorunlu. Silinecek Chunk öğesinin kaynak adı. Örnek: corpora/my-corpus-123/documents/the-doc-abc/chunks/some-chunk

JSON gösterimi 
{
  "name": string
}

REST Kaynağı: Corpora.documents.chunks

Kaynak: Chunk

Chunk, vektör gösterimi ve depolama açısından bağımsız bir birim olarak değerlendirilen bir Document alt parçasıdır. Bir Corpus en fazla 1 milyon Chunk içerebilir.

Alanlar
name string

Sabit. Tanımlayıcı. Chunk kaynak adı. Kimlik ("Corpora/*/documents/*/chunks/" öneki hariç olmak üzere ad), en fazla 40 küçük harf alfanümerik veya kısa çizgi (-) içerebilir. Kimlik, tireyle başlayamaz veya bitemez. Oluşturma sırasında ad boş bırakılırsa 12 karakterli rastgele bir benzersiz kimlik oluşturulur. Örnek: corpora/{corpus_id}/documents/{document_id}/chunks/123a456b789c

data object (ChunkData)

Zorunlu. Chunk öğesinin içeriği (ör. metin dizesi). Parça başına maksimum jeton sayısı 2043'tür.

customMetadata[] object (CustomMetadata)

İsteğe bağlı. Anahtar/değer çiftleri olarak depolanan, kullanıcı tarafından sağlanan özel meta veriler. Yığın başına maksimum CustomMetadata sayısı 20'dir.

createTime string (Timestamp format)

Yalnızca çıkış. Chunk öğesinin oluşturulduğu zamana ait zaman damgası.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

updateTime string (Timestamp format)

Yalnızca çıkış. Chunk öğesinin en son güncellenişinin zaman damgası.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

state enum (State)

Yalnızca çıkış. Chunk'ün mevcut durumu.

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

ChunkData

Chunk içeriğini temsil eden ayıklanmış veriler.

Alanlar

Birleştirme alanı data.

data şunlardan yalnızca biri olabilir:

stringValue string

Dize olarak Chunk içeriği. Her bir parça için maksimum jeton sayısı 2043'tür.

JSON gösterimi 
{

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

Eyalet

Chunk yaşam döngüsü için durumlar.

Sıralamalar
STATE_UNSPECIFIED Varsayılan değerdir. Eyalet atlanırsa bu değer kullanılır.
STATE_PENDING_PROCESSING Chunk işlenmektedir (yerleştirme ve vektör depolama).
STATE_ACTIVE Chunk işlenmiş ve sorgulanabilir durumdadır.
STATE_FAILED Chunk işlenemedi.