Yöntem: corpora.documents.create
Boş bir Document
oluşturur.
Uç nokta
yayınlahttps: / /generativelanguage.googleapis.com /v1beta /{parent=corpora /*} /documents
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
parent
string
Zorunlu. Bu Document
'un oluşturulacağı Corpus
'nin adı. Örnek: corpora/my-corpus-123
corpora/{corpora}
biçimindedir.
İstek içeriği
İstek metni, Document
öğesinin bir örneğini içerir.
name
string
Değişmez. Tanımlayıcı. Document
kaynak adı. Kimlik ("corpora/*/documents/" ön ekinden hariç tutulan ad), küçük harf alfanümerik veya kısa çizgi (-) karakterlerinden oluşan en fazla 40 karakter içerebilir. Kimlik, kısa çizgiyle başlayamaz veya bitemez. Oluşturma sırasında ad boşsa displayName
'den 12 karakterlik rastgele bir ek ile birlikte benzersiz bir ad türetilir. Örnek: corpora/{corpus_id}/documents/my-awesome-doc-123a456b789c
displayName
string
İsteğe bağlı. Document
için kullanıcıların okuyabileceği görünen ad. Görünen ad, boşluklar dahil en fazla 512 karakter uzunluğunda olmalıdır. Örnek: "Semantic Retriever Documentation"
customMetadata[]
object (CustomMetadata
)
İsteğe bağlı. Sorgulama için kullanılan anahtar/değer çiftleri olarak depolanan, kullanıcı tarafından sağlanan özel meta veriler. Bir Document
en fazla 20 CustomMetadata
içerebilir.
Yanıt gövdesi
Başarılı olursa yanıt metni, yeni oluşturulmuş bir Document
örneğini içerir.
Yöntem: corpora.documents.query
Document
üzerinde semantik arama yapar.
Uç nokta
yayınlahttps: / /generativelanguage.googleapis.com /v1beta /{name=corpora /* /documents /*}:query
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
name
string
Zorunlu. Sorgulanacak Document
öğesinin adı. Örnek: corpora/my-corpus-123/documents/the-doc-abc
corpora/{corpora}/documents/{document}
biçimindedir.
İstek içeriği
İstek metni aşağıdaki yapıyla birlikte verileri içerir:
query
string
Zorunlu. Semantik arama yapmak için kullanılan sorgu dizesi.
resultsCount
integer
İsteğe bağlı. Döndürülecek maksimum Chunk
sayısı. Hizmet daha az Chunk
döndürebilir.
Belirtilmemişse en fazla 10 Chunk
döndürülür. Belirtilen maksimum sonuç sayısı 100'dür.
metadataFilters[]
object (MetadataFilter
)
İsteğe bağlı. Chunk
meta verilerini filtreleyin. Her MetadataFilter
nesnesi benzersiz bir anahtara karşılık gelmelidir. Birden fazla MetadataFilter
nesnesi mantıksal "AND" operatörleriyle birleştirilir.
Not: Document
adı zaten belirtildiği için bu istek için Document
düzeyinde filtreleme desteklenmez.
Örnek sorgu: (year >= 2020 VEYA year < 2010) VE (genre = drama VEYA genre = action)
MetadataFilter
nesne listesi: metadataFilters = [ {key = "chunk.custom_metadata.year" conditions = [{int_value = 2020, operation = GREATER_EQUAL}, {int_value = 2010, operation = LESS}}, {key = "chunk.custom_metadata.genre" conditions = [{stringValue = "drama", operation = EQUAL}, {stringValue = "action", operation = EQUAL}}]
Sayısal bir değer aralığı için örnek sorgu: (year > 2015 AND year <= 2020)
MetadataFilter
nesne listesi: metadataFilters = [ {key = "chunk.custom_metadata.year" conditions = [{int_value = 2015, operation = GREATER}]}, {key = "chunk.custom_metadata.year" conditions = [{int_value = 2020, operation = LESS_EQUAL}]}]
Not: Aynı anahtar için "VE" operatörleri yalnızca sayısal değerlerde desteklenir. Dize değerleri yalnızca aynı anahtar için "VEYA"ları destekler.
Yanıt gövdesi
Alakalı parçaların listesini içeren documents.query
yanıtı.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
relevantChunks[]
object (RelevantChunk
)
Döndürülen alakalı parçalar.
JSON gösterimi |
---|
{
"relevantChunks": [
{
object ( |
Yöntem: corpora.documents.list
Bir Corpus
içindeki tüm Document
öğelerini listeler.
Uç nokta
gethttps: / /generativelanguage.googleapis.com /v1beta /{parent=corpora /*} /documents
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
parent
string
Zorunlu. Document
içeren Corpus
öğesinin adı. Örnek: corpora/my-corpus-123
corpora/{corpora}
biçimindedir.
Sorgu parametreleri
pageSize
integer
İsteğe bağlı. Döndürülecek maksimum Document
sayısı (sayfa başına). Hizmet daha az Document
döndürebilir.
Belirtilmemişse en fazla 10 Document
döndürülür. Maksimum boyut sınırı sayfa başına 20 Document
'tir.
pageToken
string
İsteğe bağlı. Önceki bir documents.list
çağrısından alınan 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.
Sayfalandırma yapılırken documents.list
parametresine 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
documents.list
tarafından gönderilen ve sayfalandırılmış bir Document
listesi içeren yanıt. Document
değerleri artan document.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:
documents[]
object (Document
)
Döndürülen Document
değerleri.
nextPageToken
string
Sonraki sayfayı almak için pageToken
olarak gönderilebilen bir jeton. Bu alan atlanırsa başka sayfa yoktur.
JSON gösterimi |
---|
{
"documents": [
{
object ( |
Yöntem: corpora.documents.get
Belirli bir Document
hakkında bilgi alır.
Uç nokta
gethttps: / /generativelanguage.googleapis.com /v1beta /{name=corpora /* /documents /*}
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
name
string
Zorunlu. Alınacak Document
öğesinin adı. Örnek: corpora/my-corpus-123/documents/the-doc-abc
corpora/{corpora}/documents/{document}
biçimindedir.
İstek içeriği
İstek metni boş olmalıdır.
Yanıt metni
Başarılıysa yanıt metni, Document
öğesinin bir örneğini içerir.
Yöntem: corpora.documents.patch
Document
güncellemesi
Uç nokta
yamahttps: / /generativelanguage.googleapis.com /v1beta /{document.name=corpora /* /documents /*}
PATCH https://generativelanguage.googleapis.com/v1beta/{document.name=corpora/*/documents/*}
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
document.name
string
Değişmez. Tanımlayıcı. Document
kaynak adı. Kimlik ("corpora/*/documents/" ön ekinden hariç tutulan ad), küçük harf alfanümerik veya kısa çizgi (-) karakterlerinden oluşan en fazla 40 karakter içerebilir. Kimlik, kısa çizgiyle başlayamaz veya bitemez. Oluşturma sırasında ad boşsa displayName
'den 12 karakterlik rastgele bir ek ile birlikte benzersiz bir ad türetilir. Örnek: corpora/{corpus_id}/documents/my-awesome-doc-123a456b789c
corpora/{corpora}/documents/{document}
biçimindedir.
Sorgu parametreleri
updateMask
string (FieldMask
format)
Zorunlu. Güncellenecek alanların listesi. Şu anda yalnızca displayName
ve customMetadata
değerlerinin güncellenmesi desteklenmektedir.
Bu, alanların tam nitelikli adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo"
.
İstek içeriği
İstek metni, Document
öğesinin bir örneğini içerir.
displayName
string
İsteğe bağlı. Document
için kullanıcıların okuyabileceği görünen ad. Görünen ad, boşluklar dahil en fazla 512 karakter uzunluğunda olmalıdır. Örnek: "Semantic Retriever Documentation"
customMetadata[]
object (CustomMetadata
)
İsteğe bağlı. Sorgulama için kullanılan anahtar/değer çiftleri olarak depolanan, kullanıcı tarafından sağlanan özel meta veriler. Bir Document
en fazla 20 CustomMetadata
içerebilir.
Yanıt gövdesi
Başarılıysa yanıt metni, Document
öğesinin bir örneğini içerir.
Yöntem: corpora.documents.delete
Bir Document
'yi siler.
Uç nokta
deletehttps: / /generativelanguage.googleapis.com /v1beta /{name=corpora /* /documents /*}
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
name
string
Zorunlu. Silinecek Document
kaynağının adı. Örnek: corpora/my-corpus-123/documents/the-doc-abc
corpora/{corpora}/documents/{document}
biçimindedir.
Sorgu parametreleri
force
boolean
İsteğe bağlı. Doğru olarak ayarlanırsa bu Document
ile ilişkili tüm Chunk
'ler ve nesneler de silinir.
Yanlış ise (varsayılan) Document
herhangi bir Chunk
içeriyorsa FAILED_PRECONDITION
hatası döndürülür.
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Başarılı olursa yanıt metni boş bir JSON nesnesi olur.
REST Kaynağı: corpora.documents
Kaynak: Doküman
Document
, Chunk
'lerden oluşan bir koleksiyondur. Bir Corpus
'te en fazla 10.000 Document
olabilir.
name
string
Değişmez. Tanımlayıcı. Document
kaynak adı. Kimlik ("corpora/*/documents/" ön ekinden hariç tutulan ad), küçük harf alfanümerik veya kısa çizgi (-) karakterlerinden oluşan en fazla 40 karakter içerebilir. Kimlik, kısa çizgiyle başlayamaz veya bitemez. Oluşturma sırasında ad boşsa displayName
'den 12 karakterlik rastgele bir ek ile birlikte benzersiz bir ad türetilir. Örnek: corpora/{corpus_id}/documents/my-awesome-doc-123a456b789c
displayName
string
İsteğe bağlı. Document
için kullanıcıların okuyabileceği görünen ad. Görünen ad, boşluklar dahil en fazla 512 karakter uzunluğunda olmalıdır. Örnek: "Semantic Retriever Documentation"
customMetadata[]
object (CustomMetadata
)
İsteğe bağlı. Sorgulama için kullanılan anahtar/değer çiftleri olarak depolanan, kullanıcı tarafından sağlanan özel meta veriler. Bir Document
en fazla 20 CustomMetadata
içerebilir.
updateTime
string (Timestamp
format)
Yalnızca çıkış. Document
öğesinin en son güncellendiği zaman damgası.
Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z"
, "2014-10-02T15:01:23.045123456Z"
veya "2014-10-02T15:01:23+05:30"
.
createTime
string (Timestamp
format)
Yalnızca çıkış. Document
öğesinin oluşturulduğu zaman damgası.
Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z"
, "2014-10-02T15:01:23.045123456Z"
veya "2014-10-02T15:01:23+05:30"
.
JSON gösterimi |
---|
{
"name": string,
"displayName": string,
"customMetadata": [
{
object ( |
CustomMetadata
Anahtar/değer çiftleri olarak depolanan kullanıcı tarafından sağlanan meta veriler.
key
string
Zorunlu. Depolanacak meta verilerin anahtarı.
value
Union type
value
yalnızca aşağıdakilerden biri olabilir:stringValue
string
Depolanacak meta verilerin dize değeri.
stringListValue
object (StringList
)
Depolanacak meta verilerin StringList değeri.
numericValue
number
Depolanacak meta verilerin sayısal değeri.
JSON gösterimi |
---|
{
"key": string,
// value
"stringValue": string,
"stringListValue": {
object ( |
StringList
Tek bir meta veri anahtarına atanan, kullanıcı tarafından sağlanan dize değerleri.
values[]
string
Depolanacak meta verilerin dize değerleri.
JSON gösterimi |
---|
{ "values": [ string ] } |