ذخیره سازی زمینه به شما امکان میدهد تا توکنهای ورودی از پیش محاسبه شدهای را که میخواهید بارها از آنها استفاده کنید، ذخیره و دوباره استفاده کنید، به عنوان مثال هنگام پرسیدن سوالات مختلف در مورد یک فایل رسانهای مشابه. این میتواند بسته به نوع استفاده، منجر به صرفهجویی در هزینه و سرعت شود. برای آشنایی بیشتر، به راهنمای ذخیره سازی زمینه مراجعه کنید.
متد: cachedContents.create
منبع CachedContent را ایجاد میکند.
نقطه پایانی
پستhttps: / /generativelanguage.googleapis.com /v1beta /cachedContents
درخواست بدنه
بدنه درخواست شامل نمونهای از CachedContent
است.
contents[]
object ( Content
)
اختیاری. فقط ورودی. تغییرناپذیر. محتوایی که باید ذخیره شود.
tools[]
object ( Tool
)
اختیاری. فقط ورودی. تغییرناپذیر. فهرستی از Tools
مدل ممکن است برای تولید پاسخ بعدی استفاده کند
Union type
expiration
expiration
فقط میتواند یکی از موارد زیر باشد: string ( Timestamp format)
expireTime
مهر زمانی بر حسب UTC که نشان میدهد این منبع منقضی شده است. این مهر زمانی همیشه در خروجی ارائه میشود، صرف نظر از اینکه چه چیزی در ورودی ارسال شده است.
از RFC 3339 استفاده میکند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده میکند. آفستهای غیر از "Z" نیز پذیرفته میشوند. مثالها: "2014-10-02T15:01:23Z"
، "2014-10-02T15:01:23.045123456Z"
یا "2014-10-02T15:01:23+05:30"
.
ttl
string ( Duration
format)
فقط ورودی. TTL جدید برای این منبع، فقط ورودی.
مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' s
' ختم میشود. مثال: "3.5s"
.
string
displayName
اختیاری. تغییرناپذیر. نام نمایشی معنادار تولید شده توسط کاربر برای محتوای ذخیره شده. حداکثر ۱۲۸ کاراکتر یونیکد.
string
model
الزامی. تغییرناپذیر. نام Model
که برای محتوای ذخیرهشده استفاده میشود. قالب: models/{model}
systemInstruction
object ( Content
)
اختیاری. فقط ورودی. تغییرناپذیر. دستورالعمل سیستم تنظیمشده توسط توسعهدهنده. در حال حاضر فقط متن.
toolConfig
object ( ToolConfig
)
اختیاری. فقط ورودی. تغییرناپذیر. پیکربندی ابزار. این پیکربندی برای همه ابزارها مشترک است.
درخواست نمونه
پایه
پایتون
نود جی اس
برو
پوسته
از نام
پایتون
نود جی اس
برو
از چت
پایتون
نود جی اس
برو
بدنه پاسخ
در صورت موفقیت، بدنه پاسخ شامل یک نمونه تازه ایجاد شده از CachedContent
است.
روش: cachedContents.list
فهرستهای محتویات ذخیرهشده (CachedContents).
نقطه پایانی
دریافتhttps: / /generativelanguage.googleapis.com /v1beta /cachedContents
پارامترهای پرس و جو
integer
pageSize
اختیاری. حداکثر تعداد محتویات ذخیره شده برای برگرداندن. سرویس ممکن است کمتر از این مقدار را برگرداند. اگر مشخص نشود، تعداد پیشفرضی (کمتر از حداکثر) از موارد برگردانده میشود. حداکثر مقدار ۱۰۰۰ است؛ مقادیر بالاتر از ۱۰۰۰ به ۱۰۰۰ محدود میشوند.
string
pageToken
اختیاری. یک توکن صفحه که از فراخوانی قبلی cachedContents.list
دریافت شده است. این را برای بازیابی صفحه بعدی ارائه دهید.
هنگام صفحهبندی، تمام پارامترهای دیگر ارائه شده به cachedContents.list
باید با فراخوانی که توکن صفحه را ارائه داده است، مطابقت داشته باشند.
درخواست بدنه
بدنه درخواست باید خالی باشد.
بدنه پاسخ
پاسخ با لیست CachedContents.
در صورت موفقیت، بدنه پاسخ شامل دادههایی با ساختار زیر است:
object ( CachedContent )
cachedContents[]
فهرست محتویات ذخیره شده در حافظه پنهان.
string
nextPageToken
یک توکن، که میتواند به عنوان pageToken
برای بازیابی صفحه بعدی ارسال شود. اگر این فیلد حذف شود، صفحات بعدی وجود نخواهند داشت.
نمایش JSON |
---|
{
"cachedContents": [
{
object ( |
روش: cachedContents.get
منبع CachedContent را میخواند.
نقطه پایانی
دریافتhttps: / /generativelanguage.googleapis.com /v1beta /{name=cachedContents /*}
پارامترهای مسیر
string
name
الزامی. نام منبعی که به ورودی حافظه پنهان محتوا اشاره دارد. قالب: cachedContents/{id}
به شکل cachedContents/{cachedcontent}
است.
درخواست بدنه
بدنه درخواست باید خالی باشد.
درخواست نمونه
پایتون
نود جی اس
برو
پوسته
بدنه پاسخ
در صورت موفقیت، بدنه پاسخ شامل نمونهای از CachedContent
است.
روش: cachedContents.patch
منبع CachedContent را بهروزرسانی میکند (فقط تاریخ انقضا قابل بهروزرسانی است).
نقطه پایانی
وصلهhttps: / /generativelanguage.googleapis.com /v1beta /{cachedContent.name=cachedContents /*}
PATCH https://generativelanguage.googleapis.com/v1beta/{cachedContent.name=cachedContents/*}
پارامترهای مسیر
string
cachedContent.name
فقط خروجی. شناسه. نام منبعی که به محتوای ذخیره شده اشاره دارد. قالب: cachedContents/{id}
به شکل cachedContents/{cachedcontent}
است.
پارامترهای پرس و جو
updateMask
string ( FieldMask
format)
لیست فیلدهایی که باید بهروزرسانی شوند.
این لیستی از نامهای کامل فیلدها است که با کاما از هم جدا شدهاند. مثال: "user.displayName,photo"
.
درخواست بدنه
بدنه درخواست شامل نمونهای از CachedContent
است.
Union type
expiration
expiration
فقط میتواند یکی از موارد زیر باشد: string ( Timestamp format)
expireTime
مهر زمانی بر حسب UTC که نشان میدهد این منبع منقضی شده است. این مهر زمانی همیشه در خروجی ارائه میشود، صرف نظر از اینکه چه چیزی در ورودی ارسال شده است.
از RFC 3339 استفاده میکند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده میکند. آفستهای غیر از "Z" نیز پذیرفته میشوند. مثالها: "2014-10-02T15:01:23Z"
، "2014-10-02T15:01:23.045123456Z"
یا "2014-10-02T15:01:23+05:30"
.
ttl
string ( Duration
format)
فقط ورودی. TTL جدید برای این منبع، فقط ورودی.
مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' s
' ختم میشود. مثال: "3.5s"
.
درخواست نمونه
پایتون
نود جی اس
برو
پوسته
بدنه پاسخ
در صورت موفقیت، بدنه پاسخ شامل نمونهای از CachedContent
است.
متد: cachedContents.delete
منبع CachedContent را حذف میکند.
نقطه پایانی
حذفhttps: / /generativelanguage.googleapis.com /v1beta /{name=cachedContents /*}
پارامترهای مسیر
string
name
الزامی. نام منبعی که به ورودی حافظه پنهان محتوا اشاره دارد. قالب: cachedContents/{id}
به شکل cachedContents/{cachedcontent}
است.
درخواست بدنه
بدنه درخواست باید خالی باشد.
درخواست نمونه
پایتون
نود جی اس
برو
پوسته
بدنه پاسخ
در صورت موفقیت، بدنه پاسخ یک شیء JSON خالی خواهد بود.
منبع REST: cachedContents
- منبع: CachedContent
- محتوا
- قسمت
- لکه
- فراخوانی تابع
- تابع پاسخ
- بخش پاسخ تابع
- تابعپاسخBlob
- زمانبندی
- فایل دیتا
- کد اجرایی
- زبان
- نتیجه اجرای کد
- نتیجه
- ویدئوفراداده
- ابزار
- اعلان تابع
- طرحواره
- نوع
- رفتار
- بازیابی جستجوی گوگل
- پیکربندی بازیابی پویا
- حالت
- اجرای کد
- جستجوی گوگل
- فاصله
- استفاده از کامپیوتر
- محیط زیست
- متن آدرس
- جستجوی فایل
- بازیابی منبع
- پیکربندی بازیابی
- گوگل مپ
- پیکربندی ابزار
- پیکربندی فراخوانی تابع
- حالت
- پیکربندی بازیابی
- لاتلنگ
- کاربردفراداده
- روشها
منبع: CachedContent
محتوایی که پیشپردازش شده است و میتواند در درخواستهای بعدی به GenerativeService مورد استفاده قرار گیرد.
محتوای ذخیره شده فقط میتواند با مدلی که برای آن ایجاد شده است، استفاده شود.
contents[]
object ( Content
)
اختیاری. فقط ورودی. تغییرناپذیر. محتوایی که باید ذخیره شود.
tools[]
object ( Tool
)
اختیاری. فقط ورودی. تغییرناپذیر. فهرستی از Tools
مدل ممکن است برای تولید پاسخ بعدی استفاده کند
createTime
string ( Timestamp
format)
فقط خروجی. زمان ایجاد ورودی کش.
از RFC 3339 استفاده میکند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده میکند. آفستهای غیر از "Z" نیز پذیرفته میشوند. مثالها: "2014-10-02T15:01:23Z"
، "2014-10-02T15:01:23.045123456Z"
یا "2014-10-02T15:01:23+05:30"
.
updateTime
string ( Timestamp
format)
فقط خروجی. آخرین بهروزرسانی ورودی حافظه پنهان بر اساس زمان UTC چه زمانی بوده است.
از RFC 3339 استفاده میکند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده میکند. آفستهای غیر از "Z" نیز پذیرفته میشوند. مثالها: "2014-10-02T15:01:23Z"
، "2014-10-02T15:01:23.045123456Z"
یا "2014-10-02T15:01:23+05:30"
.
usageMetadata
object ( UsageMetadata
)
فقط خروجی. فراداده در مورد استفاده از محتوای ذخیره شده.
Union type
expiration
expiration
فقط میتواند یکی از موارد زیر باشد: string ( Timestamp format)
expireTime
مهر زمانی بر حسب UTC که نشان میدهد این منبع منقضی شده است. این مهر زمانی همیشه در خروجی ارائه میشود، صرف نظر از اینکه چه چیزی در ورودی ارسال شده است.
از RFC 3339 استفاده میکند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده میکند. آفستهای غیر از "Z" نیز پذیرفته میشوند. مثالها: "2014-10-02T15:01:23Z"
، "2014-10-02T15:01:23.045123456Z"
یا "2014-10-02T15:01:23+05:30"
.
ttl
string ( Duration
format)
فقط ورودی. TTL جدید برای این منبع، فقط ورودی.
مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' s
' ختم میشود. مثال: "3.5s"
.
string
name
فقط خروجی. شناسه. نام منبعی که به محتوای ذخیره شده اشاره دارد. قالب: cachedContents/{id}
string
displayName
اختیاری. تغییرناپذیر. نام نمایشی معنادار تولید شده توسط کاربر برای محتوای ذخیره شده. حداکثر ۱۲۸ کاراکتر یونیکد.
string
model
الزامی. تغییرناپذیر. نام Model
که برای محتوای ذخیرهشده استفاده میشود. قالب: models/{model}
systemInstruction
object ( Content
)
اختیاری. فقط ورودی. تغییرناپذیر. دستورالعمل سیستم تنظیمشده توسط توسعهدهنده. در حال حاضر فقط متن.
toolConfig
object ( ToolConfig
)
اختیاری. فقط ورودی. تغییرناپذیر. پیکربندی ابزار. این پیکربندی برای همه ابزارها مشترک است.
نمایش JSON |
---|
{ "contents": [ { object ( |
محتوا
نوع داده ساختاریافته پایه که شامل محتوای چندبخشی یک پیام است.
یک Content
شامل یک فیلد role
است که تولیدکننده Content
را مشخص میکند و یک فیلد parts
که شامل دادههای چندبخشی است که محتوای نوبت پیام را در بر میگیرد.
parts[]
object ( Part
)
Parts
مرتبشدهای که یک پیام واحد را تشکیل میدهند. بخشها ممکن است انواع MIME متفاوتی داشته باشند.
string
role
اختیاری. تولیدکننده محتوا. باید «کاربر» یا «مدل» باشد.
برای تنظیم مکالمات چند نوبتی مفید است، در غیر این صورت میتوان آن را خالی گذاشت یا تنظیم نکرد.
نمایش JSON |
---|
{
"parts": [
{
object ( |
قسمت
نوع دادهای که شامل رسانهای است که بخشی از یک پیام Content
است.
یک Part
شامل دادههایی است که یک نوع داده مرتبط دارند. یک Part
فقط میتواند شامل یکی از انواع پذیرفته شده در Part.data
باشد.
اگر فیلد inlineData
با بایتهای خام پر شده باشد، یک Part
باید یک نوع MIME IANA ثابت داشته باشد که نوع و زیرنوع رسانه را مشخص کند.
thought
boolean
اختیاری. نشان میدهد که آیا قطعه از روی مدل ساخته شده است یا خیر.
string ( bytes format)
thoughtSignature
اختیاری. یک امضای غیرشفاف برای فکر تا بتوان در درخواستهای بعدی از آن استفاده مجدد کرد.
یک رشته کدگذاری شده با base64.
partMetadata
object ( Struct
format)
فرادادههای سفارشی مرتبط با قطعه. عاملهایی که از genai.Part به عنوان نمایش محتوا استفاده میکنند، ممکن است نیاز به پیگیری اطلاعات اضافی داشته باشند. به عنوان مثال، میتواند نام فایل/منبعی باشد که قطعه از آن سرچشمه میگیرد یا راهی برای مالتیپلکس کردن چندین جریان قطعه.
Union type
data
data
میتوانند فقط یکی از موارد زیر باشند:string
text
متن درون خطی.
inlineData
object ( Blob
)
بایتهای رسانه درونخطی.
functionCall
object ( FunctionCall
)
یک FunctionCall
پیشبینیشده که از مدل برگردانده شده و شامل رشتهای است که نشاندهندهی FunctionDeclaration.name
به همراه آرگومانها و مقادیر آنهاست.
functionResponse
object ( FunctionResponse
)
خروجی حاصل از یک FunctionCall
که شامل رشتهای است که نشاندهندهی FunctionDeclaration.name
و یک شیء JSON ساختاریافته حاوی هرگونه خروجی از تابع است، به عنوان زمینه برای مدل استفاده میشود.
fileData
object ( FileData
)
دادههای مبتنی بر URI
executableCode
object ( ExecutableCode
)
کدی که توسط مدلی که قرار است اجرا شود، تولید میشود.
codeExecutionResult
object ( CodeExecutionResult
)
نتیجه اجرای ExecutableCode
.
Union type
metadata
metadata
فقط میتواند یکی از موارد زیر باشد:videoMetadata
object ( VideoMetadata
)
اختیاری. فراداده ویدئو. فراداده فقط باید زمانی مشخص شود که دادههای ویدئو در inlineData یا fileData ارائه شده باشند.
نمایش JSON |
---|
{ "thought": boolean, "thoughtSignature": string, "partMetadata": { object }, // data "text": string, "inlineData": { object ( |
لکه
بایتهای رسانهای خام.
متن نباید به صورت بایتهای خام ارسال شود، از فیلد «متن» استفاده کنید.
string
mimeType
نوع MIME استاندارد IANA برای دادههای منبع. مثالها: - image/png - image/jpeg اگر نوع MIME پشتیبانی نشدهای ارائه شود، خطایی برگردانده میشود. برای لیست کاملی از انواع پشتیبانی شده، به فرمتهای فایل پشتیبانی شده مراجعه کنید.
data
string ( bytes format)
بایتهای خام برای فرمتهای رسانهای.
یک رشته کدگذاری شده با base64.
نمایش JSON |
---|
{ "mimeType": string, "data": string } |
فراخوانی تابع
یک FunctionCall
پیشبینیشده که از مدل برگردانده شده و شامل رشتهای است که نشاندهندهی FunctionDeclaration.name
به همراه آرگومانها و مقادیر آنهاست.
string
id
اختیاری. شناسه منحصر به فرد فراخوانی تابع. در صورت پر شدن، کلاینت functionCall
اجرا میکند و پاسخی را با id
منطبق برمیگرداند.
string
name
الزامی. نام تابعی که قرار است فراخوانی شود. باید az، AZ، 0-9 باشد، یا شامل زیرخط و خط تیره باشد، با حداکثر طول 64.
args
object ( Struct
format)
اختیاری. پارامترها و مقادیر تابع در قالب شیء JSON.
نمایش JSON |
---|
{ "id": string, "name": string, "args": { object } } |
تابع پاسخ
خروجی نتیجه از یک FunctionCall
که شامل رشتهای است که نشاندهنده FunctionDeclaration.name
و یک شیء JSON ساختاریافته حاوی هرگونه خروجی از تابع است، به عنوان زمینه برای مدل استفاده میشود. این باید شامل نتیجه یک FunctionCall
باشد که بر اساس پیشبینی مدل انجام شده است.
string
id
اختیاری. شناسه تابعی که این پاسخ برای آن فراخوانی شده است. توسط کلاینت پر میشود تا با id
تابع فراخوانی شده مربوطه مطابقت داشته باشد.
string
name
الزامی. نام تابعی که قرار است فراخوانی شود. باید az، AZ، 0-9 باشد، یا شامل زیرخط و خط تیره باشد، با حداکثر طول 64.
response
object ( Struct
format)
الزامی. پاسخ تابع در قالب شیء JSON. فراخوانیکنندگان میتوانند از هر کلید دلخواهی که با سینتکس تابع مطابقت دارد برای بازگرداندن خروجی تابع استفاده کنند، مثلاً "خروجی"، "نتیجه" و غیره. به طور خاص، اگر فراخوانی تابع با شکست مواجه شود، پاسخ میتواند یک کلید "خطا" داشته باشد تا جزئیات خطا را به مدل برگرداند.
parts[]
object ( FunctionResponsePart
)
اختیاری. Parts
مرتب شده که یک پاسخ تابع را تشکیل میدهند. قطعات ممکن است انواع MIME IANA متفاوتی داشته باشند.
boolean
willContinue
اختیاری. سیگنالهایی مبنی بر ادامه فراخوانی تابع و بازگشت پاسخهای بیشتر، فراخوانی تابع را به یک مولد تبدیل میکند. فقط برای فراخوانیهای تابع NON_BLOCKING قابل اجرا است، در غیر این صورت نادیده گرفته میشود. اگر روی false تنظیم شود، پاسخهای آینده در نظر گرفته نمیشوند. مجاز است response
خالی را با willContinue=False
برگرداند تا نشان دهد که فراخوانی تابع پایان یافته است. این ممکن است همچنان تولید مدل را آغاز کند. برای جلوگیری از آغاز تولید و پایان فراخوانی تابع، scheduling
نیز روی SILENT
تنظیم کنید.
scheduling
enum ( Scheduling
)
اختیاری. نحوهی زمانبندی پاسخ در مکالمه را مشخص میکند. فقط برای فراخوانیهای تابع NON_BLOCKING قابل اجرا است، در غیر این صورت نادیده گرفته میشود. پیشفرض WHEN_IDLE است.
نمایش JSON |
---|
{ "id": string, "name": string, "response": { object }, "parts": [ { object ( |
بخش پاسخ تابع
یک نوع داده حاوی رسانهای که بخشی از یک پیام FunctionResponse
است.
یک FunctionResponsePart
شامل دادههایی است که یک نوع داده مرتبط دارند. یک FunctionResponsePart
فقط میتواند شامل یکی از انواع پذیرفته شده در FunctionResponsePart.data
باشد.
اگر فیلد inlineData
با بایتهای خام پر شده باشد، یک FunctionResponsePart
باید یک نوع MIME IANA ثابت داشته باشد که نوع و زیرنوع رسانه را مشخص کند.
Union type
data
data
میتوانند فقط یکی از موارد زیر باشند: inlineData
object ( FunctionResponseBlob
)
بایتهای رسانه درونخطی.
نمایش JSON |
---|
{
// data
"inlineData": {
object ( |
تابعپاسخBlob
بایتهای رسانه خام برای پاسخ تابع.
متن نباید به صورت بایتهای خام ارسال شود، از فیلد 'FunctionResponse.response' استفاده کنید.
string
mimeType
نوع MIME استاندارد IANA برای دادههای منبع. مثالها: - image/png - image/jpeg اگر نوع MIME پشتیبانی نشدهای ارائه شود، خطایی برگردانده میشود. برای لیست کاملی از انواع پشتیبانی شده، به فرمتهای فایل پشتیبانی شده مراجعه کنید.
data
string ( bytes format)
بایتهای خام برای فرمتهای رسانهای.
یک رشته کدگذاری شده با base64.
نمایش JSON |
---|
{ "mimeType": string, "data": string } |
زمانبندی
نحوهی زمانبندی پاسخ در مکالمه را مشخص میکند.
انومها | |
---|---|
SCHEDULING_UNSPECIFIED | این مقدار بلااستفاده است. |
SILENT | فقط نتیجه را به متن مکالمه اضافه کنید، وقفه ایجاد نکنید یا تولید را آغاز نکنید. |
WHEN_IDLE | نتیجه را به متن مکالمه اضافه کنید و از آن بخواهید بدون ایجاد وقفه در تولید مداوم، خروجی تولید کند. |
INTERRUPT | نتیجه را به متن مکالمه اضافه کنید، تولید مداوم را متوقف کنید و از ما بخواهید خروجی تولید کنیم. |
فایل دیتا
دادههای مبتنی بر URI
string
mimeType
اختیاری. نوع MIME استاندارد IANA از دادههای منبع.
string
fileUri
الزامی. آدرس اینترنتی.
نمایش JSON |
---|
{ "mimeType": string, "fileUri": string } |
کد اجرایی
کدی که توسط مدل تولید شده و قرار است اجرا شود و نتیجه به مدل بازگردانده میشود.
فقط هنگام استفاده از ابزار CodeExecution
تولید میشود، که در آن کد به طور خودکار اجرا میشود و یک CodeExecutionResult
مربوطه نیز تولید میشود.
language
enum ( Language
)
زبان code
مورد نیاز.
string
code
الزامی. کدی که باید اجرا شود.
نمایش JSON |
---|
{
"language": enum ( |
زبان
زبانهای برنامهنویسی پشتیبانیشده برای کد تولید شده.
انومها | |
---|---|
LANGUAGE_UNSPECIFIED | زبان نامشخص. این مقدار نباید استفاده شود. |
PYTHON | پایتون >= 3.10، با numpy و simpy در دسترس است. |
نتیجه اجرای کد
نتیجه اجرای ExecutableCode
.
فقط هنگام استفاده از CodeExecution
تولید میشود و همیشه پس از part
حاوی ExecutableCode
قرار میگیرد.
outcome
enum ( Outcome
)
الزامی. نتیجه اجرای کد.
string
output
اختیاری. در صورت موفقیتآمیز بودن اجرای کد، شامل stdout و در غیر این صورت شامل stderr یا توضیحات دیگر میشود.
نمایش JSON |
---|
{
"outcome": enum ( |
نتیجه
شمارش نتایج احتمالی اجرای کد.
انومها | |
---|---|
OUTCOME_UNSPECIFIED | وضعیت نامشخص. این مقدار نباید استفاده شود. |
OUTCOME_OK | اجرای کد با موفقیت انجام شد. |
OUTCOME_FAILED | اجرای کد تمام شد اما با شکست مواجه شد. stderr باید دلیل آن را ذکر کند. |
OUTCOME_DEADLINE_EXCEEDED | اجرای کد برای مدت طولانی ادامه داشت و لغو شد. ممکن است خروجی جزئی وجود داشته باشد یا نباشد. |
ویدئوفراداده
متادیتا محتوای ویدیوی ورودی را توصیف میکند.
startOffset
string ( Duration
format)
اختیاری. نقطه شروع ویدیو.
مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' s
' ختم میشود. مثال: "3.5s"
.
endOffset
string ( Duration
format)
اختیاری. آفست انتهای ویدیو.
مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' s
' ختم میشود. مثال: "3.5s"
.
number
fps
اختیاری. نرخ فریم ویدئوی ارسال شده به مدل. در صورت عدم تعیین، مقدار پیشفرض ۱.۰ خواهد بود. محدوده فریم بر ثانیه (۰.۰، ۲۴.۰) است.
نمایش JSON |
---|
{ "startOffset": string, "endOffset": string, "fps": number } |
ابزار
جزئیات ابزاری که مدل ممکن است برای تولید پاسخ از آنها استفاده کند.
Tool
، قطعه کدی است که سیستم را قادر میسازد تا با سیستمهای خارجی تعامل داشته باشد تا یک یا مجموعهای از اقدامات را خارج از دانش و محدوده مدل انجام دهد.
شناسه بعدی: ۱۲
functionDeclarations[]
object ( FunctionDeclaration
)
اختیاری. فهرستی از FunctionDeclarations
موجود در مدل که میتوانند برای فراخوانی تابع استفاده شوند.
مدل یا سیستم تابع را اجرا نمیکند. در عوض، تابع تعریفشده ممکن است به عنوان یک FunctionCall
با آرگومانهایی برای اجرا به سمت کلاینت بازگردانده شود. مدل ممکن است تصمیم بگیرد با قرار دادن FunctionCall
در پاسخ، زیرمجموعهای از این توابع را فراخوانی کند. نوبت بعدی مکالمه ممکن است شامل یک FunctionResponse
با زمینه تولید "تابع" Content.role
برای نوبت بعدی مدل باشد.
googleSearchRetrieval
object ( GoogleSearchRetrieval
)
اختیاری. ابزار بازیابی که توسط جستجوی گوگل پشتیبانی میشود.
codeExecution
object ( CodeExecution
)
اختیاری. مدل را قادر میسازد تا کد را به عنوان بخشی از تولید اجرا کند.
object ( GoogleSearch )
googleSearch
اختیاری. نوع ابزار جستجوی گوگل. ابزاری برای پشتیبانی از جستجوی گوگل در مدل. ارائه شده توسط گوگل.
computerUse
object ( ComputerUse
)
اختیاری. ابزاری برای پشتیبانی از تعامل مستقیم مدل با کامپیوتر. در صورت فعال بودن، به طور خودکار اعلانهای تابع مخصوص استفاده از کامپیوتر را پر میکند.
urlContext
object ( UrlContext
)
اختیاری. ابزاری برای پشتیبانی از بازیابی متن URL.
object ( FileSearch )
fileSearch
اختیاری. نوع ابزار جستجوی فایل. ابزاری برای بازیابی دانش از پیکرههای بازیابی معنایی.
object ( GoogleMaps )
googleMaps
اختیاری. ابزاری که امکان پایهگذاری پاسخ مدل با زمینه جغرافیایی مرتبط با پرسوجوی کاربر را فراهم میکند.
نمایش JSON |
---|
{ "functionDeclarations": [ { object ( |
اعلان تابع
نمایش ساختاریافتهی اعلان یک تابع، همانطور که توسط مشخصات OpenAPI 3.03 تعریف شده است. نام تابع و پارامترها در این اعلان گنجانده شدهاند. این اعلان تابع، نمایش بلوکی از کد است که میتواند به عنوان یک Tool
توسط مدل استفاده و توسط کلاینت اجرا شود.
string
name
الزامی. نام تابع. باید az، AZ، اعداد ۰-۹ باشد، یا شامل زیرخط، دونقطه، نقطه و خط تیره باشد، با حداکثر طول ۶۴.
string
description
الزامی. شرح مختصری از تابع.
behavior
enum ( Behavior
)
اختیاری. رفتار تابع را مشخص میکند. در حال حاضر فقط توسط متد BidiGenerateContent پشتیبانی میشود.
parameters
object ( Schema
)
اختیاری. پارامترهای این تابع را توصیف میکند. رشته شیء پارامتر Open API 3.03 را منعکس میکند. کلید: نام پارامتر. نام پارامترها به حروف کوچک و بزرگ حساس هستند. مقدار طرحواره: طرحوارهای که نوع مورد استفاده برای پارامتر را تعریف میکند.
value ( Value format)
parametersJsonSchema
اختیاری. پارامترهای تابع را در قالب JSON Schema توصیف میکند. این طرح باید یک شیء را توصیف کند که در آن ویژگیها، پارامترهای تابع هستند. برای مثال:
{
"type": "object",
"properties": {
"name": { "type": "string" },
"age": { "type": "integer" }
},
"additionalProperties": false,
"required": ["name", "age"],
"propertyOrdering": ["name", "age"]
}
این فیلد با parameters
ناسازگار است.
response
object ( Schema
)
اختیاری. خروجی این تابع را در قالب JSON Schema توصیف میکند. منعکسکننده شیء پاسخ Open API 3.03 است. Schema نوع مورد استفاده برای مقدار پاسخ تابع را تعریف میکند.
responseJsonSchema
value ( Value
format)
اختیاری. خروجی این تابع را در قالب JSON Schema توصیف میکند. مقداری که توسط schema مشخص میشود، مقدار پاسخ تابع است.
این فیلد با response
ناسازگار است.
طرحواره
شیء Schema
امکان تعریف انواع دادههای ورودی و خروجی را فراهم میکند. این انواع میتوانند اشیاء باشند، اما میتوانند مقادیر اولیه و آرایهها نیز باشند. نشاندهنده زیرمجموعهای منتخب از یک شیء طرحواره OpenAPI 3.0 است.
type
enum ( Type
)
نوع داده. الزامی.
string
format
اختیاری. قالب دادهها. هر مقداری مجاز است، اما اکثر آنها هیچ عملکرد خاصی را فعال نمیکنند.
string
title
اختیاری. عنوان طرحواره.
string
description
اختیاری. شرح مختصری از پارامتر. این میتواند شامل مثالهایی از کاربرد باشد. شرح پارامتر میتواند به صورت Markdown قالببندی شود.
boolean
nullable
اختیاری. نشان میدهد که آیا مقدار میتواند تهی (null) باشد یا خیر.
string
enum[]
اختیاری. مقادیر ممکن برای عنصر Type.STRING با فرمت enum. برای مثال، میتوانیم یک جهت شمارشی (Enum Direction) را به صورت زیر تعریف کنیم: {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]}
string ( int64 format)
maxItems
اختیاری. حداکثر تعداد عناصر برای Type.ARRAY.
minItems
string ( int64 format)
اختیاری. حداقل تعداد عناصر برای Type.ARRAY.
properties
map (key: string, value: object ( Schema
))
اختیاری. ویژگیهای Type.OBJECT.
یک شیء شامل لیستی از جفتهای "key": value
. مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
.
string
required[]
اختیاری. ویژگیهای الزامی Type.OBJECT.
minProperties
string ( int64 format)
اختیاری. حداقل تعداد ویژگیهای Type.OBJECT.
string ( int64 format)
maxProperties
اختیاری. حداکثر تعداد ویژگیهای Type.OBJECT.
minLength
string ( int64 format)
اختیاری. فیلدهای طرحواره برای نوع رشته حداقل طول Type.STRING
string ( int64 format)
maxLength
اختیاری. حداکثر طول Type.STRING
string
pattern
اختیاری. الگوی Type.STRING برای محدود کردن یک رشته به یک عبارت منظم.
example
value ( Value
format)
اختیاری. مثالی از شیء. فقط زمانی که شیء ریشه باشد، پر میشود.
anyOf[]
object ( Schema
)
اختیاری. مقدار باید در برابر هر (یک یا چند) زیرطرحواره موجود در لیست اعتبارسنجی شود.
string
propertyOrdering[]
اختیاری. ترتیب ویژگیها. یک فیلد استاندارد در open api spec نیست. برای تعیین ترتیب ویژگیها در پاسخ استفاده میشود.
default
value ( Value
format)
اختیاری. مقدار پیشفرض فیلد. طبق JSON Schema، این فیلد برای مولدهای مستندات در نظر گرفته شده است و بر اعتبارسنجی تأثیری ندارد. بنابراین در اینجا گنجانده شده و نادیده گرفته میشود تا توسعهدهندگانی که طرحوارههایی با فیلد default
ارسال میکنند، با خطاهای فیلد ناشناخته مواجه نشوند.
items
object ( Schema
)
اختیاری. طرحواره عناصر Type.ARRAY.
minimum
number
اختیاری. فیلدهای طرحواره برای نوع عدد صحیح و عدد حداقل مقدار Type.INTEGER و Type.NUMBER
maximum
number
اختیاری. حداکثر مقدار Type.INTEGER و Type.NUMBER
نمایش JSON |
---|
{ "type": enum ( |
نوع
نوع شامل لیستی از انواع داده OpenAPI است که توسط https://spec.openapis.org/oas/v3.0.3#data-types تعریف شده است.
انومها | |
---|---|
TYPE_UNSPECIFIED | مشخص نشده، نباید استفاده شود. |
STRING | نوع رشته. |
NUMBER | نوع شماره. |
INTEGER | نوع عدد صحیح. |
BOOLEAN | نوع بولی. |
ARRAY | نوع آرایه. |
OBJECT | نوع شیء. |
NULL | نوع تهی. |
رفتار
رفتار تابع را تعریف میکند. مقدار پیشفرض آن BLOCKING
است.
انومها | |
---|---|
UNSPECIFIED | این مقدار بلااستفاده است. |
BLOCKING | در صورت تنظیم، سیستم قبل از ادامه مکالمه منتظر دریافت پاسخ تابع خواهد ماند. |
NON_BLOCKING | در صورت تنظیم، سیستم منتظر دریافت پاسخ تابع نمیماند. در عوض، سعی میکند پاسخهای تابع را به محض دریافت، مدیریت کند و در عین حال، مکالمه بین کاربر و مدل را حفظ کند. |
بازیابی جستجوی گوگل
ابزاری برای بازیابی دادههای وب عمومی برای اتصال به زمین، ارائه شده توسط گوگل.
dynamicRetrievalConfig
object ( DynamicRetrievalConfig
)
پیکربندی بازیابی پویا را برای منبع داده شده مشخص میکند.
نمایش JSON |
---|
{
"dynamicRetrievalConfig": {
object ( |
پیکربندی بازیابی پویا
گزینههای سفارشیسازی بازیابی پویا را شرح میدهد.
mode
enum ( Mode
)
حالت پیشبینیکنندهای که قرار است در بازیابی پویا استفاده شود.
number
dynamicThreshold
آستانهای که در بازیابی پویا مورد استفاده قرار میگیرد. در صورت عدم تنظیم، از مقدار پیشفرض سیستم استفاده میشود.
نمایش JSON |
---|
{
"mode": enum ( |
حالت
حالت پیشبینیکنندهای که قرار است در بازیابی پویا استفاده شود.
انومها | |
---|---|
MODE_UNSPECIFIED | همیشه بازیابی را فعال کنید. |
MODE_DYNAMIC | بازیابی را فقط زمانی اجرا کنید که سیستم تشخیص دهد لازم است. |
اجرای کد
این نوع هیچ فیلدی ندارد.
ابزاری که کد تولید شده توسط مدل را اجرا میکند و به طور خودکار نتیجه را به مدل برمیگرداند.
همچنین به ExecutableCode
و CodeExecutionResult
که فقط هنگام استفاده از این ابزار تولید میشوند، مراجعه کنید.
جستجوی گوگل
نوع ابزار جستجوی گوگل. ابزاری برای پشتیبانی از جستجوی گوگل در مدل. ارائه شده توسط گوگل.
timeRangeFilter
object ( Interval
)
اختیاری. نتایج جستجو را در یک محدوده زمانی خاص فیلتر کنید. اگر مشتریان زمان شروع را تعیین کنند، باید زمان پایان را نیز تعیین کنند (و برعکس).
نمایش JSON |
---|
{
"timeRangeFilter": {
object ( |
فاصله
یک بازه زمانی را نشان میدهد که به صورت یک Timestamp شروع (شامل) و یک Timestamp پایان (منحصراً) کدگذاری شده است.
شروع باید کوچکتر یا مساوی پایان باشد. وقتی شروع با پایان برابر باشد، بازه خالی است (با هیچ زمانی مطابقت ندارد). وقتی هم شروع و هم پایان مشخص نشده باشند، بازه با هر زمانی مطابقت دارد.
string ( Timestamp format)
startTime
اختیاری. شروع فراگیر بازه.
در صورت مشخص شدن، مهر زمانی که با این بازه مطابقت دارد باید یکسان یا بعد از شروع باشد.
از RFC 3339 استفاده میکند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده میکند. آفستهای غیر از "Z" نیز پذیرفته میشوند. مثالها: "2014-10-02T15:01:23Z"
، "2014-10-02T15:01:23.045123456Z"
یا "2014-10-02T15:01:23+05:30"
.
endTime
string ( Timestamp
format)
اختیاری. پایان انحصاری بازه.
در صورت مشخص شدن، یک مهر زمانی (Timestamp) که با این بازه مطابقت دارد، باید قبل از پایان باشد.
از RFC 3339 استفاده میکند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده میکند. آفستهای غیر از "Z" نیز پذیرفته میشوند. مثالها: "2014-10-02T15:01:23Z"
، "2014-10-02T15:01:23.045123456Z"
یا "2014-10-02T15:01:23+05:30"
.
نمایش JSON |
---|
{ "startTime": string, "endTime": string } |
استفاده از کامپیوتر
نوع ابزار استفاده از کامپیوتر.
environment
enum ( Environment
)
الزامی. محیطی که در آن عملیات انجام میشود.
string
excludedPredefinedFunctions[]
اختیاری. به طور پیشفرض، توابع از پیش تعریف شده در فراخوانی نهایی مدل گنجانده میشوند. برخی از آنها را میتوان به صراحت از شمول خودکار مستثنی کرد. این میتواند دو هدف را دنبال کند: ۱. استفاده از یک فضای عمل محدودتر/متفاوت. ۲. بهبود تعاریف/دستورالعملهای توابع از پیش تعریف شده.
نمایش JSON |
---|
{
"environment": enum ( |
محیط زیست
نشان دهنده محیطی است که در حال اجرا است، مانند یک مرورگر وب.
انومها | |
---|---|
ENVIRONMENT_UNSPECIFIED | پیشفرض روی مرورگر. |
ENVIRONMENT_BROWSER | در یک مرورگر وب کار میکند. |
متن آدرس
این نوع هیچ فیلدی ندارد.
ابزاری برای پشتیبانی از بازیابی متن URL.
جستجوی فایل
ابزار FileSearch که دانش را از پیکرههای بازیابی معنایی بازیابی میکند. فایلها با استفاده از رابط برنامهنویسی کاربردی ImportFile به پیکرههای بازیابی معنایی وارد میشوند.
retrievalResources[]
object ( RetrievalResource
)
الزامی. منابع بازیابی معنایی برای بازیابی. در حال حاضر فقط از یک پیکره زبانی پشتیبانی میکند. در آینده ممکن است پشتیبانی از چندین پیکره زبانی را نیز فعال کنیم.
retrievalConfig
object ( RetrievalConfig
)
اختیاری. پیکربندی برای بازیابی.
نمایش JSON |
---|
{ "retrievalResources": [ { object ( |
بازیابی منبع
منبع بازیابی معنایی که باید از آن بازیابی شود.
string
ragStoreName
الزامی. نام منبع بازیابی معنایی که قرار است از آن بازیابی شود. مثال: ragStores/my-rag-store-123
نمایش JSON |
---|
{ "ragStoreName": string } |
پیکربندی بازیابی
پیکربندی بازیابی معنایی.
string
metadataFilter
اختیاری. فیلتر فراداده برای اعمال روی اسناد و تکههای بازیابی معنایی.
integer
topK
اختیاری. تعداد تکههای بازیابی معنایی که باید بازیابی شوند.
نمایش JSON |
---|
{ "metadataFilter": string, "topK": integer } |
گوگل مپ
ابزار GoogleMaps که زمینه جغرافیایی را برای جستجوی کاربر فراهم میکند.
enableWidget
boolean
اختیاری. اینکه آیا توکن زمینه ویجت در GroundingMetadata پاسخ برگردانده شود یا خیر. توسعهدهندگان میتوانند از توکن زمینه ویجت برای رندر کردن یک ویجت Google Maps با زمینه مکانی مرتبط با مکانهایی که مدل در پاسخ به آنها اشاره میکند، استفاده کنند.
نمایش JSON |
---|
{ "enableWidget": boolean } |
پیکربندی ابزار
پیکربندی ابزار شامل پارامترهایی برای تعیین استفاده از Tool
در درخواست.
functionCallingConfig
object ( FunctionCallingConfig
)
اختیاری. پیکربندی فراخوانی تابع.
retrievalConfig
object ( RetrievalConfig
)
اختیاری. پیکربندی بازیابی.
نمایش JSON |
---|
{ "functionCallingConfig": { object ( |
پیکربندی فراخوانی تابع
پیکربندی برای مشخص کردن رفتار فراخوانی تابع.
mode
enum ( Mode
)
اختیاری. حالتی را که فراخوانی تابع باید در آن اجرا شود مشخص میکند. اگر مشخص نشود، مقدار پیشفرض روی AUTO تنظیم میشود.
string
allowedFunctionNames[]
اختیاری. مجموعهای از نامهای تابع که در صورت ارائه، توابعی را که مدل فراخوانی خواهد کرد محدود میکنند.
این فقط باید زمانی تنظیم شود که حالت (Mode) روی ANY یا VALIDATED باشد. نام توابع باید با [FunctionDeclaration.name] مطابقت داشته باشد. وقتی تنظیم شود، مدل فراخوانی تابع را فقط از نامهای تابع مجاز پیشبینی میکند.
نمایش JSON |
---|
{
"mode": enum ( |
حالت
با تعریف حالت اجرا، رفتار اجرایی را برای فراخوانی تابع تعریف میکند.
انومها | |
---|---|
MODE_UNSPECIFIED | حالت فراخوانی تابع نامشخص. این مقدار نباید استفاده شود. |
AUTO | رفتار پیشفرض مدل، مدل تصمیم میگیرد که یا یک فراخوانی تابع یا یک پاسخ زبان طبیعی را پیشبینی کند. |
ANY | مدل محدود به پیشبینی فقط فراخوانی یک تابع است. اگر "allowedFunctionNames" تنظیم شده باشد، فراخوانی تابع پیشبینیشده به هر یک از "allowedFunctionNames" محدود خواهد شد، در غیر این صورت فراخوانی تابع پیشبینیشده هر یک از "functionDeclarations" ارائه شده خواهد بود. |
NONE | مدل هیچ فراخوانی تابعی را پیشبینی نمیکند. رفتار مدل مانند زمانی است که هیچ اعلان تابعی ارسال نمیشود. |
VALIDATED | مدل تصمیم میگیرد که یا یک فراخوانی تابع یا یک پاسخ زبان طبیعی را پیشبینی کند، اما فراخوانیهای تابع را با رمزگشایی محدود اعتبارسنجی میکند. اگر "allowedFunctionNames" تنظیم شده باشد، فراخوانی تابع پیشبینیشده به هر یک از "allowedFunctionNames" محدود خواهد شد، در غیر این صورت فراخوانی تابع پیشبینیشده هر یک از "functionDeclarations" ارائه شده خواهد بود. |
پیکربندی بازیابی
لاتلنگ
شیءای که یک جفت عرض/طول جغرافیایی را نشان میدهد. این به صورت یک جفت دوتایی بیان میشود تا درجه عرض جغرافیایی و درجه طول جغرافیایی را نشان دهد. مگر اینکه خلاف آن مشخص شده باشد، این شیء باید با استاندارد WGS84 مطابقت داشته باشد. مقادیر باید در محدوده نرمال باشند.
number
latitude
عرض جغرافیایی بر حسب درجه. باید در محدوده [-90.0، +90.0] باشد.
number
longitude
طول جغرافیایی بر حسب درجه. باید در محدوده [-۱۸۰.۰، +۱۸۰.۰] باشد.
نمایش JSON |
---|
{ "latitude": number, "longitude": number } |
کاربردفراداده
فراداده (metadata) در مورد استفاده از محتوای ذخیره شده.
integer
totalTokenCount
تعداد کل توکنهایی که محتوای ذخیرهشده مصرف میکند.
نمایش JSON |
---|
{ "totalTokenCount": integer } |