Bağlam önbelleğe alma, tekrar tekrar kullanmak istediğiniz önceden hesaplanmış giriş jetonlarını (ör. aynı medya dosyası hakkında farklı sorular sorarken) kaydetmenize ve yeniden kullanmanıza olanak tanır. Bu, kullanıma bağlı olarak maliyet ve hız tasarrufu sağlayabilir. Ayrıntılı bir giriş için Bağlam önbelleğe alma kılavuzuna bakın.
Yöntem: cachedContents.create
CachedContent kaynağı oluşturur.
Uç nokta
yayınlahttps: / /generativelanguage.googleapis.com /v1beta /cachedContents
İstek içeriği
İstek metni, CachedContent
öğesinin bir örneğini içerir.
contents[]
object (Content
)
İsteğe bağlıdır. Yalnızca giriş. Değişmez. Önbelleğe alınacak içerik.
tools[]
object (Tool
)
İsteğe bağlıdır. Yalnızca giriş. Değişmez. Modelin sonraki yanıtı oluşturmak için kullanabileceği Tools
öğelerinin listesi
expiration
Union type
expiration
yalnızca aşağıdakilerden biri olabilir:expireTime
string (Timestamp
format)
Bu kaynağın geçerliliğinin sona erdiği kabul edilen zamanın UTC zaman damgası. Bu değer, girişte gönderilenden bağımsız olarak çıkışta her zaman sağlanır.
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"
.
ttl
string (Duration
format)
Yalnızca giriş. Bu kaynak için yeni TTL, yalnızca giriş.
En fazla dokuz kesirli basamak içeren ve "s
" ile biten, saniye cinsinden süre. Örnek: "3.5s"
.
name
string
İsteğe bağlıdır. Tanımlayıcı. Önbelleğe alınan içeriğe atıfta bulunan kaynak adı. Biçim: cachedContents/{id}
displayName
string
İsteğe bağlıdır. Değişmez. Önbelleğe alınan içeriğin kullanıcı tarafından oluşturulan anlamlı görünen adı. Maksimum 128 Unicode karakteri.
model
string
Zorunlu. Değişmez. Önbelleğe alınmış içerik için kullanılacak Model
adı Biçim: models/{model}
systemInstruction
object (Content
)
İsteğe bağlıdır. Yalnızca giriş. Değişmez. Geliştirici tarafından ayarlanan sistem talimatı. Şu anda yalnızca metin olarak kullanılabilir.
toolConfig
object (ToolConfig
)
İsteğe bağlıdır. Yalnızca giriş. Değişmez. Araç yapılandırması. Bu yapılandırma tüm araçlar için paylaşılır.
Örnek istek
Temel
Python
Node.js
Go
kabuk
Gönderen adı
Python
Node.js
Go
Sohbetten
Python
Node.js
Go
Yanıt gövdesi
Başarılı olursa yanıt metni, yeni oluşturulmuş bir CachedContent
örneği içerir.
Yöntem: cachedContents.list
CachedContents öğesini listeler.
Uç nokta
gethttps: / /generativelanguage.googleapis.com /v1beta /cachedContents
Sorgu parametreleri
pageSize
integer
İsteğe bağlıdır. Döndürülecek maksimum önbelleğe alınmış içerik sayısı. Hizmet bu değerden daha az sonuç döndürebilir. Belirtilmemişse varsayılan (maksimumun altında) sayıda öğe döndürülür. Maksimum değer 1.000'dür. 1.000'den büyük değerler 1.000'e zorlanacaktır.
pageToken
string
İsteğe bağlıdır. Önceki bir cachedContents.list
çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.
Sayfalandırma yapılırken cachedContents.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
CachedContents listesi içeren yanıt.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
cachedContents[]
object (CachedContent
)
Önbelleğe alınmış içeriklerin listesi.
nextPageToken
string
Sonraki sayfayı almak için pageToken
olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfa olmaz.
JSON gösterimi |
---|
{
"cachedContents": [
{
object ( |
Yöntem: cachedContents.get
CachedContent kaynağını okur.
Uç nokta
gethttps: / /generativelanguage.googleapis.com /v1beta /{name=cachedContents /*}
Yol parametreleri
name
string
Zorunlu. İçerik önbelleği girişine atıfta bulunan kaynak adı. Biçim: cachedContents/{id}
cachedContents/{cachedcontent}
biçimindedir.
İstek içeriği
İstek metni boş olmalıdır.
Örnek istek
Python
Node.js
Go
kabuk
Yanıt gövdesi
Başarılıysa yanıt metni, CachedContent
öğesinin bir örneğini içerir.
Yöntem: cachedContents.patch
CachedContent kaynağını günceller (yalnızca geçerlilik süresi güncellenebilir).
Uç nokta
yamahttps: / /generativelanguage.googleapis.com /v1beta /{cachedContent.name=cachedContents /*}
PATCH https://generativelanguage.googleapis.com/v1beta/{cachedContent.name=cachedContents/*}
Yol parametreleri
cachedContent.name
string
İsteğe bağlıdır. Tanımlayıcı. Önbelleğe alınan içeriğe atıfta bulunan kaynak adı. Biçim: cachedContents/{id}
cachedContents/{cachedcontent}
biçimindedir.
Sorgu parametreleri
updateMask
string (FieldMask
format)
Güncellenecek alanların listesi.
Bu, alanların tam nitelikli adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo"
.
İstek içeriği
İstek metni, CachedContent
öğesinin bir örneğini içerir.
expiration
Union type
expiration
yalnızca aşağıdakilerden biri olabilir:expireTime
string (Timestamp
format)
Bu kaynağın geçerliliğinin sona erdiği kabul edilen zamanın UTC zaman damgası. Bu değer, girişte gönderilenden bağımsız olarak çıkışta her zaman sağlanır.
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"
.
ttl
string (Duration
format)
Yalnızca giriş. Bu kaynak için yeni TTL, yalnızca giriş.
En fazla dokuz kesirli basamak içeren ve "s
" ile biten, saniye cinsinden süre. Örnek: "3.5s"
.
name
string
İsteğe bağlıdır. Tanımlayıcı. Önbelleğe alınan içeriğe atıfta bulunan kaynak adı. Biçim: cachedContents/{id}
Örnek istek
Python
Node.js
Go
kabuk
Yanıt gövdesi
Başarılıysa yanıt metni, CachedContent
öğesinin bir örneğini içerir.
Yöntem: cachedContents.delete
CachedContent kaynağını siler.
Uç nokta
deletehttps: / /generativelanguage.googleapis.com /v1beta /{name=cachedContents /*}
Yol parametreleri
name
string
Zorunlu. İçerik önbelleği girişine atıfta bulunan kaynak adı Biçim: cachedContents/{id}
cachedContents/{cachedcontent}
biçimindedir.
İstek içeriği
İstek metni boş olmalıdır.
Örnek istek
Python
Node.js
Go
kabuk
Yanıt gövdesi
Başarılı olursa yanıt metni boş bir JSON nesnesi olur.
REST Kaynağı: cachedContents
- Kaynak: CachedContent
- İçerik
- Bölüm
- Blob
- FunctionCall
- FunctionResponse
- FileData
- ExecutableCode
- Dil
- CodeExecutionResult
- Sonuç
- Araç
- FunctionDeclaration
- Şema
- Tür
- GoogleSearchRetrieval
- DynamicRetrievalConfig
- Mod
- CodeExecution
- GoogleSearch
- ToolConfig
- FunctionCallingConfig
- Mod
- UsageMetadata
- Yöntemler
Kaynak: CachedContent
Önceden işlenmiş ve GenerativeService'e yapılan sonraki isteklerde kullanılabilen içerik.
Önbelleğe alınan içerikler yalnızca oluşturuldukları modelde kullanılabilir.
contents[]
object (Content
)
İsteğe bağlıdır. Yalnızca giriş. Değişmez. Önbelleğe alınacak içerik.
tools[]
object (Tool
)
İsteğe bağlıdır. Yalnızca giriş. Değişmez. Modelin sonraki yanıtı oluşturmak için kullanabileceği Tools
öğelerinin listesi
createTime
string (Timestamp
format)
Yalnızca çıkış. Önbellek girişinin oluşturulma zamanı.
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"
.
updateTime
string (Timestamp
format)
Yalnızca çıkış. Önbelleğe alınan girişin UTC saatinde son güncellenme zamanı.
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"
.
usageMetadata
object (UsageMetadata
)
Yalnızca çıkış. Önbelleğe alınmış içeriğin kullanımıyla ilgili meta veriler.
expiration
Union type
expiration
yalnızca aşağıdakilerden biri olabilir:expireTime
string (Timestamp
format)
Bu kaynağın geçerliliğinin sona erdiği kabul edilen zamanın UTC zaman damgası. Bu değer, girişte gönderilenden bağımsız olarak çıkışta her zaman sağlanır.
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"
.
ttl
string (Duration
format)
Yalnızca giriş. Bu kaynak için yeni TTL, yalnızca giriş.
En fazla dokuz kesirli basamak içeren ve "s
" ile biten, saniye cinsinden süre. Örnek: "3.5s"
.
name
string
İsteğe bağlıdır. Tanımlayıcı. Önbelleğe alınan içeriğe atıfta bulunan kaynak adı. Biçim: cachedContents/{id}
displayName
string
İsteğe bağlıdır. Değişmez. Önbelleğe alınan içeriğin kullanıcı tarafından oluşturulan anlamlı görünen adı. Maksimum 128 Unicode karakteri.
model
string
Zorunlu. Değişmez. Önbelleğe alınmış içerik için kullanılacak Model
adı Biçim: models/{model}
systemInstruction
object (Content
)
İsteğe bağlıdır. Yalnızca giriş. Değişmez. Geliştirici tarafından ayarlanan sistem talimatı. Şu anda yalnızca metin olarak kullanılabilir.
toolConfig
object (ToolConfig
)
İsteğe bağlıdır. Yalnızca giriş. Değişmez. Araç yapılandırması. Bu yapılandırma tüm araçlar için paylaşılır.
JSON gösterimi |
---|
{ "contents": [ { object ( |
İçerik
Bir mesajın çok parçalı içeriğini içeren temel yapılandırılmış veri türü.
Content
, Content
'ün üreticisini belirten bir role
alanı ve ileti sırasının içeriğini içeren çok parçalı verileri içeren bir parts
alanı içerir.
parts[]
object (Part
)
Tek bir mesajı oluşturan sıralı Parts
. Parçaların MIME türleri farklı olabilir.
role
string
İsteğe bağlıdır. İçeriğin yapımcısı. "user" veya "model" olmalıdır.
Birden çok katılımlı görüşmeler için ayarlanması yararlıdır. Aksi takdirde boş bırakılabilir veya ayarlanmamış olabilir.
JSON gösterimi |
---|
{
"parts": [
{
object ( |
Bölüm
Çok parçalı bir Content
mesajının parçası olan medyayı içeren bir veri türü.
Part
, ilişkili bir veri türüne sahip verilerden oluşur. Part
, yalnızca Part.data
'da kabul edilen türlerden birini içerebilir.
inlineData
alanı ham baytlarla doldurulmuşsa Part
, medyanın türünü ve alt türünü tanımlayan sabit bir IANA MIME türüne sahip olmalıdır.
data
Union type
data
yalnızca aşağıdakilerden biri olabilir:text
string
Satır içi metin.
inlineData
object (Blob
)
Satır içi medya baytları.
functionCall
object (FunctionCall
)
Modelden döndürülen ve bağımsız değişkenleri ile değerlerini içeren FunctionDeclaration.name
değerini temsil eden bir dize içeren tahmini FunctionCall
.
functionResponse
object (FunctionResponse
)
FunctionDeclaration.name
değerini temsil eden bir dize ve işlevden gelen tüm çıkışları içeren yapılandırılmış bir JSON nesnesi içeren bir FunctionCall
sonucunun çıkışı, modelin bağlamı olarak kullanılır.
fileData
object (FileData
)
URI tabanlı veriler.
executableCode
object (ExecutableCode
)
Model tarafından oluşturulan ve yürütülmesi amaçlanan kod.
codeExecutionResult
object (CodeExecutionResult
)
ExecutableCode
işlevinin yürütülmesinin sonucu.
JSON gösterimi |
---|
{ // data "text": string, "inlineData": { object ( |
Blob
Ham medya baytları.
Metin, ham bayt olarak gönderilmemelidir. "metin" alanını kullanın.
mimeType
string
Kaynak verilerin IANA standart MIME türü. Örnekler: - image/png - image/jpeg Desteklenmeyen bir MIME türü sağlanırsa hata döndürülür. Desteklenen türlerin tam listesi için Desteklenen dosya biçimleri başlıklı makaleyi inceleyin.
data
string (bytes format)
Medya biçimleri için ham baytlar.
Base64 kodlu bir dize.
JSON gösterimi |
---|
{ "mimeType": string, "data": string } |
FunctionCall
Modelden döndürülen ve bağımsız değişkenleri ile değerlerini içeren FunctionDeclaration.name
değerini temsil eden bir dize içeren tahmini FunctionCall
.
id
string
İsteğe bağlıdır. İşlev çağrısının benzersiz kimliği. Doldurulmuşsa istemci, functionCall
'yi yürütür ve eşleşen id
ile yanıtı döndürür.
name
string
Zorunlu. Çağırılacak işlevin adı. a-z, A-Z, 0-9 arasında olmalı veya alt çizgi ve kısa çizgi içermeli, en fazla 63 karakter uzunluğunda olmalıdır.
args
object (Struct
format)
İsteğe bağlıdır. JSON nesnesi biçiminde işlev parametreleri ve değerleri.
JSON gösterimi |
---|
{ "id": string, "name": string, "args": { object } } |
FunctionResponse
FunctionDeclaration.name
'yi temsil eden bir dize ve işlevden gelen tüm çıkışları içeren yapılandırılmış bir JSON nesnesi içeren bir FunctionCall
'den elde edilen sonuç çıkışı, modelin bağlamı olarak kullanılır. Bu, model tahminine göre oluşturulan bir FunctionCall
sonucunu içermelidir.
id
string
İsteğe bağlıdır. Bu yanıtın ait olduğu işlev çağrısının kimliği. İlgili işlev çağrısı id
ile eşleşecek şekilde istemci tarafından doldurulur.
name
string
Zorunlu. Çağırılacak işlevin adı. a-z, A-Z, 0-9 arasında olmalı veya alt çizgi ve kısa çizgi içermeli, en fazla 63 karakter uzunluğunda olmalıdır.
response
object (Struct
format)
Zorunlu. JSON nesne biçiminde işlev yanıtı.
JSON gösterimi |
---|
{ "id": string, "name": string, "response": { object } } |
FileData
URI tabanlı veriler.
mimeType
string
İsteğe bağlıdır. Kaynak verilerin IANA standart MIME türü.
fileUri
string
Zorunlu. URI.
JSON gösterimi |
---|
{ "mimeType": string, "fileUri": string } |
ExecutableCode
Model tarafından oluşturulan ve çalıştırılmak üzere tasarlanmış kod ve modele döndürülen sonuç.
Yalnızca CodeExecution
aracı kullanılırken oluşturulur. Bu araçta kod otomatik olarak yürütülür ve ilgili bir CodeExecutionResult
da oluşturulur.
language
enum (Language
)
Zorunlu. code
'ün programlama dili.
code
string
Zorunlu. Yürütülecek kod.
JSON gösterimi |
---|
{
"language": enum ( |
Dil
Oluşturulan kod için desteklenen programlama dilleri.
Sıralamalar | |
---|---|
LANGUAGE_UNSPECIFIED |
Belirtilmemiş dil. Bu değer kullanılmamalıdır. |
PYTHON |
Python >= 3.10 (numpy ve simpy kullanılabilir). |
CodeExecutionResult
ExecutableCode
işlevinin yürütülmesinin sonucu.
Yalnızca CodeExecution
kullanıldığında oluşturulur ve her zaman ExecutableCode
içeren bir part
'dan sonra gelir.
outcome
enum (Outcome
)
Zorunlu. Kod yürütmenin sonucu.
output
string
İsteğe bağlıdır. Kod yürütme başarılı olduğunda stdout, aksi takdirde stderr veya başka bir açıklama içerir.
JSON gösterimi |
---|
{
"outcome": enum ( |
Sonuç
Kod yürütmenin olası sonuçlarının listesi.
Sıralamalar | |
---|---|
OUTCOME_UNSPECIFIED |
Belirtilmemiş durum. Bu değer kullanılmamalıdır. |
OUTCOME_OK |
Kod yürütme işlemi başarıyla tamamlandı. |
OUTCOME_FAILED |
Kod yürütme tamamlandı ancak bir hatayla. stderr , nedeni içermelidir. |
OUTCOME_DEADLINE_EXCEEDED |
Kod yürütme işlemi çok uzun sürdü ve iptal edildi. Kısmi çıkış olabilir veya olmayabilir. |
Araç
Modelin yanıt oluşturmak için kullanabileceği araç ayrıntıları.
Tool
, sistemin modelin bilgisi ve kapsamı dışında bir işlem veya işlem grubu gerçekleştirmek için harici sistemlerle etkileşim kurmasını sağlayan bir kod parçasıdır.
functionDeclarations[]
object (FunctionDeclaration
)
İsteğe bağlıdır. Modelin kullanabileceği ve işlev çağrısı için kullanılabilen FunctionDeclarations
öğelerinin listesi.
Model veya sistem işlevi yürütmez. Bunun yerine, tanımlanan işlev, yürütülmek üzere istemci tarafına gönderilecek bağımsız değişkenlerle birlikte bir FunctionCall
olarak döndürülebilir. Model, yanıtta FunctionCall
değerini doldurarak bu işlevlerin bir alt kümesini çağırmaya karar verebilir. Bir sonraki sohbet dönüşü, bir sonraki model dönüşü için Content.role
"function" oluşturma bağlamını içeren bir FunctionResponse
içerebilir.
googleSearchRetrieval
object (GoogleSearchRetrieval
)
İsteğe bağlıdır. Google Arama tarafından desteklenen alma aracı.
codeExecution
object (CodeExecution
)
İsteğe bağlıdır. Modelin, kod oluşturma işleminin bir parçası olarak kod yürütmesini sağlar.
googleSearch
object (GoogleSearch
)
İsteğe bağlıdır. Google Arama aracı türü. Model'de Google Arama'yı destekleyen araç. Google tarafından desteklenmektedir.
JSON gösterimi |
---|
{ "functionDeclarations": [ { object ( |
FunctionDeclaration
OpenAPI 3.03 spesifikasyonunda tanımlandığı şekliyle bir işlev beyanının yapılandırılmış gösterimi. Bu beyan, işlev adını ve parametrelerini içerir. Bu FunctionDeclaration, model tarafından Tool
olarak kullanılabilen ve istemci tarafından çalıştırılan bir kod bloğunun temsilidir.
name
string
Zorunlu. İşlevin adı. a-z, A-Z, 0-9 arasında olmalı veya alt çizgi ve kısa çizgi içermeli, en fazla 63 karakter uzunluğunda olmalıdır.
description
string
Zorunlu. İşlevin kısa bir açıklaması.
parameters
object (Schema
)
İsteğe bağlıdır. Bu işlevin parametrelerini açıklar. Open API 3.03 Parametre Nesnesi dize anahtarını yansıtır: parametrenin adı. Parametre adları büyük/küçük harfe duyarlıdır. Şema Değeri: Parametre için kullanılan türü tanımlayan şema.
response
object (Schema
)
İsteğe bağlıdır. Bu işlevin çıktısını JSON şeması biçiminde açıklar. Open API 3.03 Yanıt Nesnesi'ni yansıtır. Şema, işlevin yanıt değeri için kullanılan türü tanımlar.
Şema
Schema
nesnesi, giriş ve çıkış veri türlerinin tanımlanmasına olanak tanır. Bu türler nesneler olabileceği gibi ilkel ve diziler de olabilir. OpenAPI 3.0 şema nesnesinin belirli bir alt kümesini temsil eder.
type
enum (Type
)
Zorunlu. Veri türü.
format
string
İsteğe bağlıdır. Verilerin biçimi. Bu, yalnızca ilkel veri türleri için kullanılır. Desteklenen biçimler: SAYI türü için: float, double TAM SAYI türü için: int32, int64 DÜZENLEME türü için: enum, tarih/saat
description
string
İsteğe bağlıdır. Parametrenin kısa bir açıklaması. Bu bölümde kullanım örnekleri yer alabilir. Parametre açıklaması Markdown olarak biçimlendirilebilir.
nullable
boolean
İsteğe bağlıdır. Değerin boş olup olamayacağını belirtir.
enum[]
string
İsteğe bağlıdır. Type.STRING öğesinin, enum biçimindeki olası değerleri. Örneğin, bir Enum Yön'ü şu şekilde tanımlayabiliriz : {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]}
maxItems
string (int64 format)
İsteğe bağlıdır. Type.ARRAY için maksimum öğe sayısı.
minItems
string (int64 format)
İsteğe bağlıdır. Type.ARRAY için minimum öğe sayısı.
properties
map (key: string, value: object (Schema
))
İsteğe bağlıdır. Type.OBJECT özelliğinin özellikleri.
"key": value
çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }
.
required[]
string
İsteğe bağlıdır. Type.OBJECT için zorunlu özellikler.
propertyOrdering[]
string
İsteğe bağlıdır. Mülklerin sırası. OpenAPI spesifikasyonunda standart bir alan değildir. Yanıttaki mülklerin sırasını belirlemek için kullanılır.
items
object (Schema
)
İsteğe bağlıdır. Type.ARRAY öğelerinin şeması.
Tür
Tür, https://spec.openapis.org/oas/v3.0.3#data-types tarafından tanımlanan OpenAPI veri türlerinin listesini içerir.
Sıralamalar | |
---|---|
TYPE_UNSPECIFIED |
Belirtilmemiş, kullanılmamalıdır. |
STRING |
Dize türü. |
NUMBER |
Numara türü. |
INTEGER |
Tam sayı türü. |
BOOLEAN |
Boole türü. |
ARRAY |
Dizi türü. |
OBJECT |
Nesne türü. |
GoogleSearchRetrieval
Google tarafından desteklenen, temellendirme için herkese açık web verilerini alma aracı.
dynamicRetrievalConfig
object (DynamicRetrievalConfig
)
Belirtilen kaynak için dinamik getirme yapılandırmasını belirtir.
JSON gösterimi |
---|
{
"dynamicRetrievalConfig": {
object ( |
DynamicRetrievalConfig
Dinamik getirmeyi özelleştirme seçeneklerini açıklar.
mode
enum (Mode
)
Dinamik getirmede kullanılacak öngörücü modu.
dynamicThreshold
number
Dinamik getirmede kullanılacak eşik. Ayarlanmazsa sistem varsayılan değeri kullanılır.
JSON gösterimi |
---|
{
"mode": enum ( |
Mod
Dinamik getirmede kullanılacak öngörücü modu.
Sıralamalar | |
---|---|
MODE_UNSPECIFIED |
Her zaman getirmeyi tetikleyin. |
MODE_DYNAMIC |
Alma işlemini yalnızca sistem gerekli olduğuna karar verdiğinde çalıştırın. |
CodeExecution
Bu türde alan yoktur.
Model tarafından oluşturulan kodu yürüten ve sonucu modele otomatik olarak döndüren araç.
Yalnızca bu araç kullanılırken oluşturulan ExecutableCode
ve CodeExecutionResult
hükümlerine de göz atın.
GoogleSearch
Bu türde alan yoktur.
Google Arama aracı türü. Model'de Google Arama'yı destekleyen araç. Google tarafından desteklenmektedir.
ToolConfig
İstekte Tool
kullanımını belirtmek için parametreler içeren araç yapılandırması.
functionCallingConfig
object (FunctionCallingConfig
)
İsteğe bağlıdır. İşlev çağrısı yapılandırması.
JSON gösterimi |
---|
{
"functionCallingConfig": {
object ( |
FunctionCallingConfig
İşlev çağırma davranışını belirtme yapılandırması.
mode
enum (Mode
)
İsteğe bağlıdır. İşlev çağrısının hangi modda yürütüleceğini belirtir. Belirtilmemişse varsayılan değer AUTO olarak ayarlanır.
allowedFunctionNames[]
string
İsteğe bağlıdır. Sağlandığında modelin çağıracağı işlevleri sınırlayan bir işlev adı grubu.
Bu ayar yalnızca Mod BİRİSİ olduğunda yapılmalıdır. İşlev adları [FunctionDeclaration.name] ile eşleşmelidir. Mod HERHANGİ olarak ayarlandığında model, sağlanan işlev adları grubundan bir işlev çağrısı tahmin eder.
JSON gösterimi |
---|
{
"mode": enum ( |
Mod
Yürütme modunu tanımlayarak işlev çağrısı için yürütme davranışını tanımlar.
Sıralamalar | |
---|---|
MODE_UNSPECIFIED |
Belirtilmemiş işlev çağrı modu. Bu değer kullanılmamalıdır. |
AUTO |
Varsayılan model davranışı. Model, bir işlev çağrısını veya doğal dil yanıtını tahmin etmeye karar verir. |
ANY |
Model, her zaman yalnızca bir işlev çağrısını tahmin edecek şekilde kısıtlanmıştır. "allowedFunctionNames" ayarlanırsa tahmin edilen işlev çağrısı, "allowedFunctionNames" değerlerinden biriyle sınırlı olur. Aksi takdirde tahmin edilen işlev çağrısı, sağlanan "functionDeclarations" değerlerinden biriyle sınırlı olur. |
NONE |
Model, işlev çağrısını tahmin etmez. Model davranışı, herhangi bir işlev beyanı iletilmediğinde olduğu gibidir. |
UsageMetadata
Önbelleğe alınmış içeriğin kullanımıyla ilgili meta veriler.
totalTokenCount
integer
Önbelleğe alınan içeriğin kullandığı toplam jeton sayısı.
JSON gösterimi |
---|
{ "totalTokenCount": integer } |