কনটেক্সট ক্যাশিং আপনাকে প্রাক-কম্পিউটেড ইনপুট টোকেনগুলি সংরক্ষণ এবং পুনঃব্যবহারের অনুমতি দেয় যা আপনি বারবার ব্যবহার করতে চান, উদাহরণস্বরূপ একই মিডিয়া ফাইল সম্পর্কে বিভিন্ন প্রশ্ন জিজ্ঞাসা করার সময়। এটি ব্যবহারের উপর নির্ভর করে খরচ এবং গতি সঞ্চয় করতে পারে। বিস্তারিত ভূমিকার জন্য, প্রসঙ্গ ক্যাশিং গাইড দেখুন।
পদ্ধতি: cachedContents.create
ক্যাশেড কনটেন্ট রিসোর্স তৈরি করে।
শেষবিন্দু
https://generativelanguage.googleapis.com/v1beta/cachedContents পোস্ট করুনশরীরের অনুরোধ
অনুরোধের মূল অংশে CachedContent
একটি উদাহরণ রয়েছে।
contents[]
object ( Content
)
ঐচ্ছিক। শুধুমাত্র ইনপুট। অপরিবর্তনীয়। বিষয়বস্তু ক্যাশে.
tools[]
object ( Tool
)
ঐচ্ছিক। শুধুমাত্র ইনপুট। অপরিবর্তনীয়। পরবর্তী প্রতিক্রিয়া তৈরি করতে মডেলটি ব্যবহার করতে পারে এমন Tools
একটি তালিকা৷
expiration
। এই সম্পদের মেয়াদ কখন শেষ হবে তা নির্দিষ্ট করে। expiration
নিম্নলিখিতগুলির মধ্যে একটি হতে পারে: expireTime
string ( Timestamp
format)
UTC-এ টাইমস্ট্যাম্প যখন এই সংস্থানটির মেয়াদ শেষ বলে বিবেচিত হয়। ইনপুটে যা পাঠানো হয়েছে তা নির্বিশেষে এটি সর্বদা আউটপুটে সরবরাহ করা হয়।
RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z"
এবং "2014-10-02T15:01:23.045123456Z"
।
ttl
string ( Duration
format)
শুধুমাত্র ইনপুট। এই সম্পদের জন্য নতুন TTL, শুধুমাত্র ইনপুট।
নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা সহ সেকেন্ডে একটি সময়কাল, ' s
' দিয়ে শেষ হয়৷ উদাহরণ: "3.5s"
।
name
string
ঐচ্ছিক। শনাক্তকারী। সম্পদের নাম ক্যাশে করা বিষয়বস্তু উল্লেখ করে। বিন্যাস: cachedContents/{id}
displayName
string
ঐচ্ছিক। অপরিবর্তনীয়। ক্যাশ করা বিষয়বস্তুর ব্যবহারকারীর তৈরি অর্থপূর্ণ প্রদর্শন নাম। সর্বোচ্চ 128টি ইউনিকোড অক্ষর।
model
string
প্রয়োজন। অপরিবর্তনীয়। ক্যাশে কন্টেন্ট ফরম্যাটের জন্য ব্যবহার করা Model
নাম: models/{model}
systemInstruction
object ( Content
)
ঐচ্ছিক। শুধুমাত্র ইনপুট। অপরিবর্তনীয়। বিকাশকারী সেট সিস্টেম নির্দেশ. বর্তমানে শুধুমাত্র টেক্সট.
toolConfig
object ( ToolConfig
)
ঐচ্ছিক। শুধুমাত্র ইনপুট। অপরিবর্তনীয়। টুল কনফিগারেশন। এই কনফিগারেশনটি সকল টুলের জন্য শেয়ার করা হয়েছে।
উদাহরণ অনুরোধ
মৌলিক
পাইথন
Node.js
যাও
শেল
নাম থেকে
পাইথন
Node.js
যাও
চ্যাট থেকে
পাইথন
Node.js
যাও
প্রতিক্রিয়া শরীর
সফল হলে, রেসপন্স বডিতে CachedContent
একটি নতুন তৈরি ইনস্ট্যান্স থাকে।
পদ্ধতি: cachedContents.list
ক্যাশেড বিষয়বস্তু তালিকাভুক্ত করে।
শেষবিন্দু
https://generativelanguage.googleapis.com/v1beta/cachedContents পানক্যোয়ারী প্যারামিটার
pageSize
integer
ঐচ্ছিক। ফেরত দেওয়ার জন্য ক্যাশ করা সামগ্রীর সর্বাধিক সংখ্যা৷ পরিষেবাটি এই মানের থেকে কম ফেরত দিতে পারে। অনির্দিষ্ট থাকলে, কিছু ডিফল্ট (সর্বোচ্চ অধীনে) আইটেম সংখ্যা ফেরত দেওয়া হবে। সর্বোচ্চ মান 1000; 1000-এর উপরে মান 1000-এ বাধ্য করা হবে।
pageToken
string
ঐচ্ছিক। একটি পৃষ্ঠা টোকেন, একটি পূর্ববর্তী cachedContents.list
কল থেকে প্রাপ্ত। পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে এটি প্রদান করুন।
পেজিনেট করার সময়, cachedContents.list
এ প্রদত্ত অন্যান্য সমস্ত প্যারামিটার অবশ্যই পেজ টোকেন প্রদানকারী কলের সাথে মিলতে হবে।
শরীরের অনুরোধ
অনুরোধের বডি খালি হতে হবে।
প্রতিক্রিয়া শরীর
ক্যাশেড বিষয়বস্তু তালিকা সহ প্রতিক্রিয়া.
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
cachedContents[]
object ( CachedContent
)
ক্যাশ করা বিষয়বস্তুর তালিকা।
nextPageToken
string
একটি টোকেন, যা পরবর্তী পৃষ্ঠা পুনরুদ্ধার করতে pageToken
হিসাবে পাঠানো যেতে পারে। যদি এই ক্ষেত্রটি বাদ দেওয়া হয়, তাহলে পরবর্তী পৃষ্ঠা থাকবে না।
JSON প্রতিনিধিত্ব |
---|
{
"cachedContents": [
{
object ( |
পদ্ধতি: cachedContents.get
ক্যাশেড কনটেন্ট রিসোর্স পড়ে।
শেষবিন্দু
https://generativelanguage.googleapis.com/v1beta/{name=cachedContents/*} পানপাথ প্যারামিটার
name
string
প্রয়োজন। বিষয়বস্তু ক্যাশে এন্ট্রি উল্লেখ করে সম্পদ নাম. বিন্যাস: cachedContents/{id}
এটি cachedContents/{cachedcontent}
ফর্ম নেয়।
শরীরের অনুরোধ
অনুরোধের বডি খালি হতে হবে।
উদাহরণ অনুরোধ
পাইথন
Node.js
যাও
শেল
প্রতিক্রিয়া শরীর
সফল হলে, প্রতিক্রিয়া বডিতে CachedContent
একটি উদাহরণ থাকে।
পদ্ধতি: cachedContents.patch
ক্যাশেড কনটেন্ট রিসোর্স আপডেট করে (কেবলমাত্র মেয়াদ শেষ হওয়া আপডেটযোগ্য)।
শেষবিন্দু
প্যাচ https://generativelanguage.googleapis.com/v1beta/{cachedContent.name=cachedContents/*}PATCH https://generativelanguage.googleapis.com/v1beta/{cachedContent.name=cachedContents/*}
পাথ প্যারামিটার
cachedContent.name
string
ঐচ্ছিক। শনাক্তকারী। সম্পদের নাম ক্যাশে করা বিষয়বস্তু উল্লেখ করে। বিন্যাস: cachedContents/{id}
এটি cachedContents/{cachedcontent}
ফর্ম নেয়।
ক্যোয়ারী প্যারামিটার
updateMask
string ( FieldMask
format)
আপডেট করার জন্য ক্ষেত্রগুলির তালিকা৷
এটি ক্ষেত্রগুলির সম্পূর্ণরূপে যোগ্য নামের একটি কমা দ্বারা পৃথক করা তালিকা৷ উদাহরণ: "user.displayName,photo"
।
শরীরের অনুরোধ
অনুরোধের মূল অংশে CachedContent
একটি উদাহরণ রয়েছে।
expiration
। এই সম্পদের মেয়াদ কখন শেষ হবে তা নির্দিষ্ট করে। expiration
নিম্নলিখিতগুলির মধ্যে একটি হতে পারে: expireTime
string ( Timestamp
format)
UTC-এ টাইমস্ট্যাম্প যখন এই সংস্থানটির মেয়াদ শেষ বলে বিবেচিত হয়। ইনপুটে যা পাঠানো হয়েছে তা নির্বিশেষে এটি সর্বদা আউটপুটে সরবরাহ করা হয়।
RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z"
এবং "2014-10-02T15:01:23.045123456Z"
।
ttl
string ( Duration
format)
শুধুমাত্র ইনপুট। এই সম্পদের জন্য নতুন TTL, শুধুমাত্র ইনপুট।
নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা সহ সেকেন্ডে একটি সময়কাল, ' s
' দিয়ে শেষ হয়৷ উদাহরণ: "3.5s"
।
name
string
ঐচ্ছিক। শনাক্তকারী। সম্পদের নাম ক্যাশে করা বিষয়বস্তু উল্লেখ করে। বিন্যাস: cachedContents/{id}
উদাহরণ অনুরোধ
পাইথন
Node.js
যাও
শেল
প্রতিক্রিয়া শরীর
সফল হলে, প্রতিক্রিয়া বডিতে CachedContent
একটি উদাহরণ থাকে।
পদ্ধতি: cachedContents.delete
ক্যাশেড কনটেন্ট রিসোর্স মুছে দেয়।
শেষবিন্দু
https://generativelanguage.googleapis.com/v1beta/{name=cachedContents/*} মুছুনপাথ প্যারামিটার
name
string
প্রয়োজন। বিষয়বস্তু ক্যাশে এন্ট্রি ফর্ম্যাট উল্লেখ করে সম্পদ নাম: cachedContents/{id}
এটি cachedContents/{cachedcontent}
ফর্ম নেয়।
শরীরের অনুরোধ
অনুরোধের বডি খালি হতে হবে।
উদাহরণ অনুরোধ
পাইথন
Node.js
যাও
শেল
প্রতিক্রিয়া শরীর
সফল হলে, প্রতিক্রিয়া বডি খালি।
REST সম্পদ: ক্যাশেড বিষয়বস্তু
- সম্পদ: ক্যাশেড সামগ্রী
- বিষয়বস্তু
- অংশ
- ব্লব
- ফাংশনকল
- ফাংশন রেসপন্স
- ফাইল ডেটা
- এক্সিকিউটেবল কোড
- ভাষা
- কোড এক্সিকিউশন ফলাফল
- ফলাফল
- টুল
- ফাংশন ঘোষণা
- স্কিমা
- টাইপ
- GoogleSearch Retrieval
- DynamicRetrievalConfig
- মোড
- কোড এক্সিকিউশন
- টুল কনফিগারেশন
- FunctionCallingConfig
- মোড
- মেটাডেটা ব্যবহার
- পদ্ধতি
সম্পদ: ক্যাশেড সামগ্রী
বিষয়বস্তু যা প্রি-প্রসেস করা হয়েছে এবং পরবর্তীতে GenerativeService-এর অনুরোধে ব্যবহার করা যেতে পারে।
ক্যাশে করা সামগ্রী শুধুমাত্র সেই মডেলের সাথে ব্যবহার করা যেতে পারে যার জন্য এটি তৈরি করা হয়েছিল৷
contents[]
object ( Content
)
ঐচ্ছিক। শুধুমাত্র ইনপুট। অপরিবর্তনীয়। বিষয়বস্তু ক্যাশে.
tools[]
object ( Tool
)
ঐচ্ছিক। শুধুমাত্র ইনপুট। অপরিবর্তনীয়। পরবর্তী প্রতিক্রিয়া তৈরি করতে মডেলটি ব্যবহার করতে পারে এমন Tools
একটি তালিকা৷
createTime
string ( Timestamp
format)
শুধুমাত্র আউটপুট। ক্যাশে এন্ট্রি তৈরির সময়।
RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z"
এবং "2014-10-02T15:01:23.045123456Z"
।
updateTime
string ( Timestamp
format)
শুধুমাত্র আউটপুট। যখন ক্যাশে এন্ট্রি শেষবার UTC সময়ে আপডেট করা হয়েছিল।
RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z"
এবং "2014-10-02T15:01:23.045123456Z"
।
usageMetadata
object ( UsageMetadata
)
শুধুমাত্র আউটপুট। ক্যাশে করা বিষয়বস্তুর ব্যবহারের উপর মেটাডেটা।
expiration
। এই সম্পদের মেয়াদ কখন শেষ হবে তা নির্দিষ্ট করে। expiration
নিম্নলিখিতগুলির মধ্যে একটি হতে পারে: expireTime
string ( Timestamp
format)
UTC-এ টাইমস্ট্যাম্প যখন এই সংস্থানটির মেয়াদ শেষ বলে বিবেচিত হয়। ইনপুটে যা পাঠানো হয়েছে তা নির্বিশেষে এটি সর্বদা আউটপুটে সরবরাহ করা হয়।
RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z"
এবং "2014-10-02T15:01:23.045123456Z"
।
ttl
string ( Duration
format)
শুধুমাত্র ইনপুট। এই সম্পদের জন্য নতুন TTL, শুধুমাত্র ইনপুট।
নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা সহ সেকেন্ডে একটি সময়কাল, ' s
' দিয়ে শেষ হয়৷ উদাহরণ: "3.5s"
।
name
string
ঐচ্ছিক। শনাক্তকারী। সম্পদের নাম ক্যাশে করা বিষয়বস্তু উল্লেখ করে। বিন্যাস: cachedContents/{id}
displayName
string
ঐচ্ছিক। অপরিবর্তনীয়। ক্যাশ করা বিষয়বস্তুর ব্যবহারকারীর তৈরি অর্থপূর্ণ প্রদর্শন নাম। সর্বোচ্চ 128টি ইউনিকোড অক্ষর।
model
string
প্রয়োজন। অপরিবর্তনীয়। ক্যাশে কন্টেন্ট ফরম্যাটের জন্য ব্যবহার করা Model
নাম: models/{model}
systemInstruction
object ( Content
)
ঐচ্ছিক। শুধুমাত্র ইনপুট। অপরিবর্তনীয়। বিকাশকারী সেট সিস্টেম নির্দেশ. বর্তমানে শুধুমাত্র টেক্সট.
toolConfig
object ( ToolConfig
)
ঐচ্ছিক। শুধুমাত্র ইনপুট। অপরিবর্তনীয়। টুল কনফিগারেশন। এই কনফিগারেশনটি সকল টুলের জন্য শেয়ার করা হয়েছে।
JSON প্রতিনিধিত্ব |
---|
{ "contents": [ { object ( |
বিষয়বস্তু
একটি বার্তার বহু-অংশ বিষয়বস্তু ধারণকারী বেস স্ট্রাকচার্ড ডেটাটাইপ।
একটি Content
মধ্যে একটি role
ক্ষেত্র রয়েছে যা Content
প্রযোজককে মনোনীত করে এবং একটি parts
ক্ষেত্র যাতে বহু-অংশের ডেটা থাকে যাতে বার্তার বিষয়বস্তু থাকে।
parts[]
object ( Part
)
অর্ডার করা Parts
যা একটি একক বার্তা গঠন করে। অংশের বিভিন্ন MIME প্রকার থাকতে পারে।
role
string
ঐচ্ছিক। বিষয়বস্তুর প্রযোজক। 'ব্যবহারকারী' বা 'মডেল' হতে হবে।
মাল্টি-টার্ন কথোপকথনের জন্য সেট করার জন্য দরকারী, অন্যথায় ফাঁকা বা সেট না করা যেতে পারে।
JSON প্রতিনিধিত্ব |
---|
{
"parts": [
{
object ( |
অংশ
মিডিয়া ধারণকারী একটি ডেটাটাইপ যা একটি বহু-অংশ Content
বার্তার অংশ।
একটি Part
ডেটা থাকে যার একটি সম্পর্কিত ডেটাটাইপ থাকে। একটি Part
শুধুমাত্র Part.data
তে গৃহীত প্রকারগুলির একটি ধারণ করতে পারে।
একটি Part
অবশ্যই একটি নির্দিষ্ট IANA MIME টাইপ থাকতে হবে যা মিডিয়ার ধরন এবং উপপ্রকার সনাক্ত করে যদি inlineData
ক্ষেত্র কাঁচা বাইট দিয়ে পূর্ণ হয়।
ইউনিয়ন ক্ষেত্রের data
।
data
নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
text
string
ইনলাইন পাঠ্য।
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
কার্যকর করার ফলাফল।
JSON প্রতিনিধিত্ব |
---|
{ // Union field |
ব্লব
কাঁচা মিডিয়া বাইট।
টেক্সট কাঁচা বাইট হিসাবে পাঠানো উচিত নয়, 'টেক্সট' ক্ষেত্র ব্যবহার করুন।
mimeType
string
উৎস ডেটার IANA স্ট্যান্ডার্ড MIME প্রকার। উদাহরণ: - image/png - image/jpeg যদি একটি অসমর্থিত MIME প্রকার প্রদান করা হয়, একটি ত্রুটি ফেরত দেওয়া হবে। সমর্থিত প্রকারের একটি সম্পূর্ণ তালিকার জন্য, সমর্থিত ফাইল বিন্যাস দেখুন।
data
string ( bytes format)
মিডিয়া ফরম্যাটের জন্য কাঁচা বাইট।
একটি base64-এনকোডেড স্ট্রিং।
JSON প্রতিনিধিত্ব |
---|
{ "mimeType": string, "data": string } |
ফাংশনকল
একটি ভবিষ্যদ্বাণীকৃত FunctionCall
মডেল থেকে ফিরে এসেছে যেটিতে একটি স্ট্রিং রয়েছে যা আর্গুমেন্ট এবং তাদের মান সহ FunctionDeclaration.name
প্রতিনিধিত্ব করে।
name
string
প্রয়োজন। কল করার ফাংশনের নাম। az, AZ, 0-9 হতে হবে অথবা আন্ডারস্কোর এবং ড্যাশ থাকতে হবে, যার সর্বোচ্চ দৈর্ঘ্য 63।
args
object ( Struct
format)
ঐচ্ছিক। JSON অবজেক্ট ফরম্যাটে ফাংশন প্যারামিটার এবং মান।
JSON প্রতিনিধিত্ব |
---|
{ "name": string, "args": { object } } |
ফাংশন রেসপন্স
একটি FunctionCall
থেকে ফলাফল আউটপুট যেটিতে FunctionDeclaration.name
প্রতিনিধিত্বকারী একটি স্ট্রিং রয়েছে এবং ফাংশন থেকে যেকোনো আউটপুট ধারণকারী একটি কাঠামোগত JSON অবজেক্ট মডেলের প্রসঙ্গ হিসাবে ব্যবহৃত হয়। এটিতে মডেল পূর্বাভাসের উপর ভিত্তি করে তৈরি একটি FunctionCall
ফলাফল থাকা উচিত।
name
string
প্রয়োজন। কল করার ফাংশনের নাম। az, AZ, 0-9 হতে হবে অথবা আন্ডারস্কোর এবং ড্যাশ থাকতে হবে, যার সর্বোচ্চ দৈর্ঘ্য 63।
response
object ( Struct
format)
প্রয়োজন। JSON অবজেক্ট ফরম্যাটে ফাংশন প্রতিক্রিয়া।
JSON প্রতিনিধিত্ব |
---|
{ "name": string, "response": { object } } |
ফাইল ডেটা
URI ভিত্তিক ডেটা।
mimeType
string
ঐচ্ছিক। উৎস ডেটার IANA স্ট্যান্ডার্ড MIME প্রকার।
fileUri
string
প্রয়োজন। ইউআরআই।
JSON প্রতিনিধিত্ব |
---|
{ "mimeType": string, "fileUri": string } |
এক্সিকিউটেবল কোড
কোড যে মডেলের দ্বারা উত্পন্ন হয় যা কার্যকর করা হয় এবং ফলাফলটি মডেলে ফিরে আসে।
শুধুমাত্র CodeExecution
টুল ব্যবহার করার সময় তৈরি করা হয়, যেখানে কোডটি স্বয়ংক্রিয়ভাবে কার্যকর হবে এবং একটি সংশ্লিষ্ট CodeExecutionResult
ও তৈরি হবে।
language
enum ( Language
)
প্রয়োজন। code
প্রোগ্রামিং ভাষা।
code
string
প্রয়োজন। কোডটি কার্যকর করতে হবে।
JSON প্রতিনিধিত্ব |
---|
{
"language": enum ( |
ভাষা
উত্পন্ন কোডের জন্য সমর্থিত প্রোগ্রামিং ভাষা।
Enums | |
---|---|
LANGUAGE_UNSPECIFIED | অনির্দিষ্ট ভাষা। এই মান ব্যবহার করা উচিত নয়. |
PYTHON | পাইথন >= 3.10, নম্পি এবং সিম্পি উপলব্ধ। |
কোড এক্সিকিউশন ফলাফল
ExecutableCode
কার্যকর করার ফলাফল।
শুধুমাত্র CodeExecution
ব্যবহার করার সময় উৎপন্ন হয় এবং সর্বদা ExecutableCode
ধারণকারী একটি part
অনুসরণ করে।
outcome
enum ( Outcome
)
প্রয়োজন। কোড নির্বাহের ফলাফল।
output
string
ঐচ্ছিক। কোড এক্সিকিউশন সফল হলে stdout ধারণ করে, stderr বা অন্যথায় অন্য বিবরণ।
JSON প্রতিনিধিত্ব |
---|
{
"outcome": enum ( |
ফলাফল
কোড সম্পাদনের সম্ভাব্য ফলাফলের গণনা।
Enums | |
---|---|
OUTCOME_UNSPECIFIED | অনির্দিষ্ট অবস্থা। এই মান ব্যবহার করা উচিত নয়. |
OUTCOME_OK | কোড এক্সিকিউশন সফলভাবে সম্পন্ন হয়েছে। |
OUTCOME_FAILED | কোড এক্সিকিউশন শেষ হয়েছে কিন্তু ব্যর্থতার সাথে। stderr কারণ থাকতে হবে। |
OUTCOME_DEADLINE_EXCEEDED | কোড এক্সিকিউশন খুব বেশি সময় ধরে চলেছিল এবং বাতিল করা হয়েছিল৷ আংশিক আউটপুট উপস্থিত থাকতে পারে বা নাও থাকতে পারে। |
টুল
টুলের বিবরণ যা মডেল প্রতিক্রিয়া তৈরি করতে ব্যবহার করতে পারে।
একটি Tool
হল কোডের একটি অংশ যা মডেলের জ্ঞান এবং সুযোগের বাইরে একটি ক্রিয়া সম্পাদন করতে বা ক্রিয়াগুলির সেট করার জন্য সিস্টেমটিকে বহিরাগত সিস্টেমের সাথে যোগাযোগ করতে সক্ষম করে।
functionDeclarations[]
object ( FunctionDeclaration
)
ঐচ্ছিক। মডেলের কাছে উপলব্ধ FunctionDeclarations
একটি তালিকা যা ফাংশন কলিংয়ের জন্য ব্যবহার করা যেতে পারে।
মডেল বা সিস্টেম ফাংশন চালায় না। পরিবর্তে সংজ্ঞায়িত ফাংশন কার্যকর করার জন্য ক্লায়েন্ট পক্ষের আর্গুমেন্ট সহ একটি FunctionCall
হিসাবে ফেরত দেওয়া হতে পারে। মডেলটি প্রতিক্রিয়াতে FunctionCall
পপুলেট করে এই ফাংশনগুলির একটি উপসেট কল করার সিদ্ধান্ত নিতে পারে। পরবর্তী কথোপকথনের পালাটিতে পরবর্তী মডেল টার্নের জন্য Content.role
"ফাংশন" প্রজন্মের প্রসঙ্গ সহ একটি FunctionResponse
থাকতে পারে।
googleSearchRetrieval
object ( GoogleSearchRetrieval
)
ঐচ্ছিক। পুনরুদ্ধার সরঞ্জাম যা Google অনুসন্ধান দ্বারা চালিত হয়।
codeExecution
object ( CodeExecution
)
ঐচ্ছিক। প্রজন্মের অংশ হিসাবে কোড চালানোর জন্য মডেলকে সক্ষম করে।
JSON প্রতিনিধিত্ব |
---|
{ "functionDeclarations": [ { object ( |
ফাংশন ঘোষণা
OpenAPI 3.03 স্পেসিফিকেশন দ্বারা সংজ্ঞায়িত একটি ফাংশন ঘোষণার কাঠামোগত উপস্থাপনা। এই ঘোষণার মধ্যে ফাংশনের নাম এবং পরামিতি অন্তর্ভুক্ত রয়েছে। এই ফাংশন ডিক্লারেশন হল কোডের একটি ব্লকের একটি উপস্থাপনা যা মডেল দ্বারা একটি Tool
হিসাবে ব্যবহার করা যেতে পারে এবং ক্লায়েন্ট দ্বারা কার্যকর করা যেতে পারে।
name
string
প্রয়োজন। ফাংশনের নাম। az, AZ, 0-9 হতে হবে অথবা আন্ডারস্কোর এবং ড্যাশ থাকতে হবে, যার সর্বোচ্চ দৈর্ঘ্য 63।
description
string
প্রয়োজন। ফাংশন একটি সংক্ষিপ্ত বিবরণ.
parameters
object ( Schema
)
ঐচ্ছিক। এই ফাংশনের পরামিতি বর্ণনা করে। Open API 3.03 প্যারামিটার অবজেক্ট স্ট্রিং কী প্রতিফলিত করে: প্যারামিটারের নাম। প্যারামিটারের নামগুলি কেস সংবেদনশীল৷ স্কিমা মান: প্যারামিটারের জন্য ব্যবহৃত টাইপ সংজ্ঞায়িত করে।
JSON প্রতিনিধিত্ব |
---|
{
"name": string,
"description": string,
"parameters": {
object ( |
স্কিমা
Schema
অবজেক্ট ইনপুট এবং আউটপুট ডেটা প্রকারের সংজ্ঞা অনুমোদন করে। এই ধরনের বস্তু হতে পারে, কিন্তু আদিম এবং অ্যারেও হতে পারে। একটি OpenAPI 3.0 স্কিমা অবজেক্টের একটি নির্বাচিত উপসেট প্রতিনিধিত্ব করে।
type
enum ( Type
)
প্রয়োজন। ডেটা টাইপ।
format
string
ঐচ্ছিক। তথ্য বিন্যাস. এটি শুধুমাত্র আদিম ডেটাটাইপের জন্য ব্যবহৃত হয়। সমর্থিত বিন্যাস: NUMBER প্রকারের জন্য: float, INTEGEER প্রকারের জন্য দ্বিগুণ: int32, STRING প্রকারের জন্য int64: enum
description
string
ঐচ্ছিক। পরামিতি একটি সংক্ষিপ্ত বিবরণ. এটি ব্যবহারের উদাহরণ থাকতে পারে। প্যারামিটারের বিবরণ মার্কডাউন হিসাবে ফর্ম্যাট করা যেতে পারে।
nullable
boolean
ঐচ্ছিক। মান শূন্য হতে পারে কিনা তা নির্দেশ করে।
enum[]
string
ঐচ্ছিক। Enum বিন্যাস সহ Type.STRING এর উপাদানের সম্ভাব্য মান। উদাহরণ স্বরূপ আমরা একটি Enum দিক নির্দেশ করতে পারি: {type:STRING, format:enum, enum:["East", NORTH", "SOUTH", "WEST"]}
maxItems
string ( int64 format)
ঐচ্ছিক। Type.ARRAY-এর জন্য উপাদানের সর্বাধিক সংখ্যা।
minItems
string ( int64 format)
ঐচ্ছিক। Type.ARRAY-এর জন্য উপাদানের ন্যূনতম সংখ্যা।
properties
map (key: string, value: object ( Schema
))
ঐচ্ছিক। প্রকারের বৈশিষ্ট্য।OBJECT।
"key": value
জোড়া। উদাহরণ: { "name": "wrench", "mass": "1.3kg", "count": "3" }
required[]
string
ঐচ্ছিক। Type.OBJECT এর প্রয়োজনীয় বৈশিষ্ট্য।
items
object ( Schema
)
ঐচ্ছিক। Type.ARRAY এর উপাদানগুলির স্কিমা।
টাইপ
টাইপে https://spec.openapis.org/oas/v3.0.3#data-types দ্বারা সংজ্ঞায়িত OpenAPI ডেটা প্রকারের তালিকা রয়েছে
Enums | |
---|---|
TYPE_UNSPECIFIED | নির্দিষ্ট করা নেই, ব্যবহার করা উচিত নয়। |
STRING | স্ট্রিং টাইপ। |
NUMBER | সংখ্যার ধরন। |
INTEGER | পূর্ণসংখ্যার ধরন। |
BOOLEAN | বুলিয়ান টাইপ। |
ARRAY | অ্যারে টাইপ। |
OBJECT | বস্তুর ধরন। |
GoogleSearch Retrieval
গ্রাউন্ডিংয়ের জন্য সর্বজনীন ওয়েব ডেটা পুনরুদ্ধার করার টুল, Google দ্বারা চালিত।
dynamicRetrievalConfig
object ( DynamicRetrievalConfig
)
প্রদত্ত উত্সের জন্য গতিশীল পুনরুদ্ধার কনফিগারেশন নির্দিষ্ট করে।
JSON প্রতিনিধিত্ব |
---|
{
"dynamicRetrievalConfig": {
object ( |
DynamicRetrievalConfig
গতিশীল পুনরুদ্ধার কাস্টমাইজ করার বিকল্পগুলি বর্ণনা করে।
mode
enum ( Mode
)
গতিশীল পুনরুদ্ধারের জন্য ভবিষ্যদ্বাণীকারীর মোড ব্যবহার করা হবে।
dynamicThreshold
number
গতিশীল পুনরুদ্ধারের জন্য থ্রেশহোল্ড ব্যবহার করা হবে। যদি সেট না করা হয়, একটি সিস্টেম ডিফল্ট মান ব্যবহার করা হয়।
JSON প্রতিনিধিত্ব |
---|
{
"mode": enum ( |
মোড
গতিশীল পুনরুদ্ধারের জন্য ভবিষ্যদ্বাণীকারীর মোড ব্যবহার করা হবে।
Enums | |
---|---|
MODE_UNSPECIFIED | সর্বদা পুনরুদ্ধার ট্রিগার. |
MODE_DYNAMIC | সিস্টেম যখন সিদ্ধান্ত নেয় তখনই পুনরুদ্ধার চালান এটি প্রয়োজনীয়। |
কোড এক্সিকিউশন
এই ধরনের কোন ক্ষেত্র আছে.
টুল যেটি মডেল দ্বারা জেনারেট করা কোড এক্সিকিউট করে এবং স্বয়ংক্রিয়ভাবে মডেলে ফলাফল ফেরত দেয়।
এছাড়াও ExecutableCode
এবং CodeExecutionResult
দেখুন যা শুধুমাত্র এই টুল ব্যবহার করার সময় তৈরি হয়।
টুল কনফিগারেশন
অনুরোধে Tool
ব্যবহার নির্দিষ্ট করার জন্য পরামিতি ধারণকারী টুল কনফিগারেশন।
functionCallingConfig
object ( FunctionCallingConfig
)
ঐচ্ছিক। ফাংশন কলিং কনফিগারেশন।
JSON প্রতিনিধিত্ব |
---|
{
"functionCallingConfig": {
object ( |
FunctionCallingConfig
ফাংশন কলিং আচরণ নির্দিষ্ট করার জন্য কনফিগারেশন।
mode
enum ( Mode
)
ঐচ্ছিক। যে মোডে ফাংশন কলিং চালানো উচিত তা নির্দিষ্ট করে। অনির্দিষ্ট থাকলে, ডিফল্ট মানটি অটোতে সেট করা হবে।
allowedFunctionNames[]
string
ঐচ্ছিক। ফাংশনের নামের একটি সেট যা প্রদান করা হলে, মডেলটি যে ফাংশনগুলিকে কল করবে তা সীমিত করে।
এটি শুধুমাত্র তখনই সেট করা উচিত যখন মোড যেকোনো হয়। ফাংশনের নামগুলি [FunctionDeclaration.name] মেলে। মোড যেকোনও সেট করে, মডেল প্রদত্ত ফাংশন নামের সেট থেকে একটি ফাংশন কলের পূর্বাভাস দেবে।
JSON প্রতিনিধিত্ব |
---|
{
"mode": enum ( |
মোড
এক্সিকিউশন মোড সংজ্ঞায়িত করে ফাংশন কলিংয়ের জন্য নির্বাহ আচরণ সংজ্ঞায়িত করে।
Enums | |
---|---|
MODE_UNSPECIFIED | অনির্দিষ্ট ফাংশন কলিং মোড। এই মান ব্যবহার করা উচিত নয়. |
AUTO | ডিফল্ট মডেল আচরণ, মডেল একটি ফাংশন কল বা একটি প্রাকৃতিক ভাষা প্রতিক্রিয়া ভবিষ্যদ্বাণী করার সিদ্ধান্ত নেয়। |
ANY | মডেল সবসময় শুধুমাত্র একটি ফাংশন কল ভবিষ্যদ্বাণী করতে সীমাবদ্ধ। যদি "allowedFunctionNames" সেট করা থাকে, তাহলে ভবিষ্যদ্বাণীকৃত ফাংশন কলটি "allowedFunctionNames" এর যেকোনো একটিতে সীমাবদ্ধ থাকবে, অন্যথায় পূর্বাভাসিত ফাংশন কলটি প্রদত্ত "ফাংশন ঘোষণা" এর যেকোনো একটি হবে। |
NONE | মডেল কোনো ফাংশন কল ভবিষ্যদ্বাণী করবে না. মডেল আচরণ কোন ফাংশন ঘোষণা পাস না যখন একই. |
মেটাডেটা ব্যবহার
ক্যাশে করা বিষয়বস্তুর ব্যবহারের উপর মেটাডেটা।
totalTokenCount
integer
ক্যাশ করা সামগ্রী ব্যবহার করে মোট টোকেনের সংখ্যা৷
JSON প্রতিনিধিত্ব |
---|
{ "totalTokenCount": integer } |