- সম্পদ: ক্যাশেড সামগ্রী
- বিষয়বস্তু
- অংশ
- ব্লব
- ফাংশনকল
- ফাংশন রেসপন্স
- ফাইল ডেটা
- টুল
- ফাংশন ঘোষণা
- স্কিমা
- টাইপ
- টুল কনফিগারেশন
- FunctionCallingConfig
- মোড
- মেটাডেটা ব্যবহার
- পদ্ধতি
সম্পদ: ক্যাশেড সামগ্রী
বিষয়বস্তু যা প্রি-প্রসেস করা হয়েছে এবং পরবর্তীতে GenerativeService-এর অনুরোধে ব্যবহার করা যেতে পারে।
ক্যাশে করা সামগ্রী শুধুমাত্র সেই মডেলের সাথে ব্যবহার করা যেতে পারে যার জন্য এটি তৈরি করা হয়েছিল৷
JSON প্রতিনিধিত্ব |
---|
{ "contents": [ { object ( |
ক্ষেত্র | |
---|---|
contents[] | ঐচ্ছিক। শুধুমাত্র ইনপুট। অপরিবর্তনীয়। বিষয়বস্তু ক্যাশে. |
tools[] | ঐচ্ছিক। শুধুমাত্র ইনপুট। অপরিবর্তনীয়। পরবর্তী প্রতিক্রিয়া তৈরি করতে মডেলটি ব্যবহার করতে পারে এমন |
createTime | শুধুমাত্র আউটপুট। ক্যাশে এন্ট্রি তৈরির সময়। RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: |
updateTime | শুধুমাত্র আউটপুট। যখন ক্যাশে এন্ট্রি শেষবার UTC সময়ে আপডেট করা হয়েছিল। RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: |
usageMetadata | শুধুমাত্র আউটপুট। ক্যাশে করা বিষয়বস্তুর ব্যবহারের উপর মেটাডেটা। |
ইউনিয়ন ক্ষেত্রের expiration । এই সম্পদের মেয়াদ কখন শেষ হবে তা নির্দিষ্ট করে। expiration নিম্নলিখিতগুলির মধ্যে একটি হতে পারে: | |
expireTime | UTC-এ টাইমস্ট্যাম্প যখন এই সংস্থানটির মেয়াদ শেষ বলে বিবেচিত হয়। ইনপুটে যা পাঠানো হয়েছে তা নির্বিশেষে এটি সর্বদা আউটপুটে সরবরাহ করা হয়। RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: |
ttl | শুধুমাত্র ইনপুট। এই সম্পদের জন্য নতুন TTL, শুধুমাত্র ইনপুট। নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা সহ সেকেন্ডে একটি সময়কাল, ' |
name | ঐচ্ছিক। শনাক্তকারী। সম্পদের নাম ক্যাশে করা বিষয়বস্তু উল্লেখ করে। বিন্যাস: |
displayName | ঐচ্ছিক। অপরিবর্তনীয়। ক্যাশ করা বিষয়বস্তুর ব্যবহারকারীর তৈরি অর্থপূর্ণ প্রদর্শন নাম। সর্বোচ্চ 128টি ইউনিকোড অক্ষর। |
model | প্রয়োজন। অপরিবর্তনীয়। ক্যাশে কন্টেন্ট ফরম্যাটের জন্য ব্যবহার করা |
systemInstruction | ঐচ্ছিক। শুধুমাত্র ইনপুট। অপরিবর্তনীয়। বিকাশকারী সেট সিস্টেম নির্দেশ. বর্তমানে শুধুমাত্র টেক্সট. |
toolConfig | ঐচ্ছিক। শুধুমাত্র ইনপুট। অপরিবর্তনীয়। টুল কনফিগারেশন। এই কনফিগারেশনটি সকল টুলের জন্য শেয়ার করা হয়েছে। |
বিষয়বস্তু
একটি বার্তার বহু-অংশ বিষয়বস্তু ধারণকারী বেস স্ট্রাকচার্ড ডেটাটাইপ।
একটি Content
মধ্যে একটি role
ক্ষেত্র রয়েছে যা Content
প্রযোজককে মনোনীত করে এবং একটি parts
ক্ষেত্র যাতে বহু-অংশের ডেটা থাকে যাতে বার্তার বিষয়বস্তু থাকে।
JSON প্রতিনিধিত্ব |
---|
{
"parts": [
{
object ( |
ক্ষেত্র | |
---|---|
parts[] | অর্ডার করা |
role | ঐচ্ছিক। বিষয়বস্তুর প্রযোজক। 'ব্যবহারকারী' বা 'মডেল' হতে হবে। মাল্টি-টার্ন কথোপকথনের জন্য সেট করার জন্য দরকারী, অন্যথায় ফাঁকা বা সেট না করা যেতে পারে। |
অংশ
মিডিয়া ধারণকারী একটি ডেটাটাইপ যা একটি বহু-অংশ Content
বার্তার অংশ।
একটি Part
ডেটা থাকে যার একটি সম্পর্কিত ডেটাটাইপ থাকে। একটি Part
শুধুমাত্র Part.data
তে গৃহীত প্রকারগুলির একটি ধারণ করতে পারে।
একটি Part
অবশ্যই একটি নির্দিষ্ট IANA MIME টাইপ থাকতে হবে যা মিডিয়ার ধরন এবং উপপ্রকার সনাক্ত করে যদি inlineData
ক্ষেত্র কাঁচা বাইট দিয়ে পূর্ণ হয়।
JSON প্রতিনিধিত্ব |
---|
{ // Union field |
ক্ষেত্র | |
---|---|
ইউনিয়ন ক্ষেত্রের | |
text | ইনলাইন পাঠ্য। |
inlineData | ইনলাইন মিডিয়া বাইট। |
functionCall | একটি ভবিষ্যদ্বাণীকৃত |
functionResponse | একটি |
fileData | URI ভিত্তিক ডেটা। |
ব্লব
কাঁচা মিডিয়া বাইট।
টেক্সট কাঁচা বাইট হিসাবে পাঠানো উচিত নয়, 'টেক্সট' ক্ষেত্র ব্যবহার করুন।
JSON প্রতিনিধিত্ব |
---|
{ "mimeType": string, "data": string } |
ক্ষেত্র | |
---|---|
mimeType | উৎস ডেটার IANA স্ট্যান্ডার্ড MIME প্রকার। উদাহরণ: - image/png - image/jpeg যদি একটি অসমর্থিত MIME প্রকার প্রদান করা হয়, একটি ত্রুটি ফেরত দেওয়া হবে। সমর্থিত প্রকারের একটি সম্পূর্ণ তালিকার জন্য, সমর্থিত ফাইল বিন্যাস দেখুন। |
data | মিডিয়া ফরম্যাটের জন্য কাঁচা বাইট। একটি base64-এনকোডেড স্ট্রিং। |
ফাংশনকল
একটি ভবিষ্যদ্বাণীকৃত FunctionCall
মডেল থেকে ফিরে এসেছে যেটিতে একটি স্ট্রিং রয়েছে যা আর্গুমেন্ট এবং তাদের মান সহ FunctionDeclaration.name
প্রতিনিধিত্ব করে।
JSON প্রতিনিধিত্ব |
---|
{ "name": string, "args": { object } } |
ক্ষেত্র | |
---|---|
name | প্রয়োজন। কল করার ফাংশনের নাম। az, AZ, 0-9 হতে হবে অথবা আন্ডারস্কোর এবং ড্যাশ থাকতে হবে, যার সর্বোচ্চ দৈর্ঘ্য 63। |
args | ঐচ্ছিক। JSON অবজেক্ট ফরম্যাটে ফাংশন প্যারামিটার এবং মান। |
ফাংশন রেসপন্স
একটি FunctionCall
থেকে ফলাফল আউটপুট যেটিতে FunctionDeclaration.name
প্রতিনিধিত্বকারী একটি স্ট্রিং রয়েছে এবং ফাংশন থেকে যেকোনো আউটপুট ধারণকারী একটি কাঠামোগত JSON অবজেক্ট মডেলের প্রসঙ্গ হিসাবে ব্যবহৃত হয়। এটিতে মডেল পূর্বাভাসের উপর ভিত্তি করে তৈরি একটি FunctionCall
ফলাফল থাকা উচিত।
JSON প্রতিনিধিত্ব |
---|
{ "name": string, "response": { object } } |
ক্ষেত্র | |
---|---|
name | প্রয়োজন। কল করার ফাংশনের নাম। az, AZ, 0-9 হতে হবে অথবা আন্ডারস্কোর এবং ড্যাশ থাকতে হবে, যার সর্বোচ্চ দৈর্ঘ্য 63। |
response | প্রয়োজন। JSON অবজেক্ট ফরম্যাটে ফাংশন প্রতিক্রিয়া। |
ফাইল ডেটা
URI ভিত্তিক ডেটা।
JSON প্রতিনিধিত্ব |
---|
{ "mimeType": string, "fileUri": string } |
ক্ষেত্র | |
---|---|
mimeType | ঐচ্ছিক। উৎস ডেটার IANA স্ট্যান্ডার্ড MIME প্রকার। |
fileUri | প্রয়োজন। ইউআরআই। |
টুল
টুলের বিবরণ যা মডেল প্রতিক্রিয়া তৈরি করতে ব্যবহার করতে পারে।
একটি Tool
হল কোডের একটি অংশ যা মডেলের জ্ঞান এবং সুযোগের বাইরে একটি ক্রিয়া সম্পাদন করতে বা ক্রিয়াগুলির সেট করার জন্য সিস্টেমটিকে বহিরাগত সিস্টেমের সাথে যোগাযোগ করতে সক্ষম করে।
JSON প্রতিনিধিত্ব |
---|
{
"functionDeclarations": [
{
object ( |
ক্ষেত্র | |
---|---|
functionDeclarations[] | ঐচ্ছিক। মডেলের কাছে উপলব্ধ মডেল বা সিস্টেম ফাংশন চালায় না। পরিবর্তে সংজ্ঞায়িত ফাংশনটি কার্যকর করার জন্য ক্লায়েন্ট পক্ষের আর্গুমেন্ট সহ একটি [FunctionCall][content.part.function_call] হিসাবে ফেরত দেওয়া হতে পারে। মডেলটি প্রতিক্রিয়াতে [FunctionCall][content.part.function_call] পপুলেট করে এই ফাংশনগুলির একটি উপসেট কল করার সিদ্ধান্ত নিতে পারে৷ পরবর্তী কথোপকথনের পালাটিতে পরবর্তী মডেল টার্নের জন্য [content.role] "ফাংশন" প্রজন্মের প্রসঙ্গ সহ একটি [FunctionResponse][content.part.function_response] থাকতে পারে। |
ফাংশন ঘোষণা
OpenAPI 3.03 স্পেসিফিকেশন দ্বারা সংজ্ঞায়িত একটি ফাংশন ঘোষণার কাঠামোগত উপস্থাপনা। এই ঘোষণার মধ্যে ফাংশনের নাম এবং পরামিতি অন্তর্ভুক্ত রয়েছে। এই ফাংশন ডিক্লারেশন হল কোডের একটি ব্লকের একটি উপস্থাপনা যা মডেল দ্বারা একটি Tool
হিসাবে ব্যবহার করা যেতে পারে এবং ক্লায়েন্ট দ্বারা কার্যকর করা যেতে পারে।
JSON প্রতিনিধিত্ব |
---|
{
"name": string,
"description": string,
"parameters": {
object ( |
ক্ষেত্র | |
---|---|
name | প্রয়োজন। ফাংশনের নাম। az, AZ, 0-9 হতে হবে অথবা আন্ডারস্কোর এবং ড্যাশ থাকতে হবে, যার সর্বোচ্চ দৈর্ঘ্য 63। |
description | প্রয়োজন। ফাংশন একটি সংক্ষিপ্ত বিবরণ. |
parameters | ঐচ্ছিক। এই ফাংশনের পরামিতি বর্ণনা করে। Open API 3.03 প্যারামিটার অবজেক্ট স্ট্রিং কী প্রতিফলিত করে: প্যারামিটারের নাম। প্যারামিটারের নামগুলি কেস সংবেদনশীল৷ স্কিমা মান: প্যারামিটারের জন্য ব্যবহৃত টাইপ সংজ্ঞায়িত করে। |
স্কিমা
Schema
অবজেক্ট ইনপুট এবং আউটপুট ডেটা প্রকারের সংজ্ঞা অনুমোদন করে। এই ধরনের বস্তু হতে পারে, কিন্তু আদিম এবং অ্যারেও হতে পারে। একটি OpenAPI 3.0 স্কিমা অবজেক্টের একটি নির্বাচিত উপসেট প্রতিনিধিত্ব করে।
JSON প্রতিনিধিত্ব |
---|
{ "type": enum ( |
ক্ষেত্র | |
---|---|
type | প্রয়োজন। ডেটা টাইপ। |
format | ঐচ্ছিক। তথ্য বিন্যাস. এটি শুধুমাত্র আদিম ডেটাটাইপের জন্য ব্যবহৃত হয়। সমর্থিত বিন্যাস: NUMBER প্রকারের জন্য: float, INTEGEER প্রকারের জন্য দ্বিগুণ: int32, int64 |
description | ঐচ্ছিক। পরামিতি একটি সংক্ষিপ্ত বিবরণ. এটি ব্যবহারের উদাহরণ থাকতে পারে। প্যারামিটারের বিবরণ মার্কডাউন হিসাবে ফর্ম্যাট করা যেতে পারে। |
nullable | ঐচ্ছিক। মান শূন্য হতে পারে কিনা তা নির্দেশ করে। |
enum[] | ঐচ্ছিক। Enum বিন্যাস সহ Type.STRING এর উপাদানের সম্ভাব্য মান। উদাহরণ স্বরূপ আমরা একটি Enum দিক নির্দেশ করতে পারি: {type:STRING, format:enum, enum:["East", NORTH", "SOUTH", "WEST"]} |
properties | ঐচ্ছিক। প্রকারের বৈশিষ্ট্য।OBJECT। |
required[] | ঐচ্ছিক। Type.OBJECT এর প্রয়োজনীয় বৈশিষ্ট্য। |
items | ঐচ্ছিক। Type.ARRAY এর উপাদানগুলির স্কিমা। |
টাইপ
টাইপে https://spec.openapis.org/oas/v3.0.3#data-types দ্বারা সংজ্ঞায়িত OpenAPI ডেটা প্রকারের তালিকা রয়েছে
Enums | |
---|---|
TYPE_UNSPECIFIED | নির্দিষ্ট করা নেই, ব্যবহার করা উচিত নয়। |
STRING | স্ট্রিং টাইপ। |
NUMBER | সংখ্যার ধরন। |
INTEGER | পূর্ণসংখ্যার ধরন। |
BOOLEAN | বুলিয়ান টাইপ। |
ARRAY | অ্যারে টাইপ। |
OBJECT | বস্তুর ধরন। |
টুল কনফিগারেশন
অনুরোধে Tool
ব্যবহার নির্দিষ্ট করার জন্য পরামিতি ধারণকারী টুল কনফিগারেশন।
JSON প্রতিনিধিত্ব |
---|
{
"functionCallingConfig": {
object ( |
ক্ষেত্র | |
---|---|
functionCallingConfig | ঐচ্ছিক। ফাংশন কলিং কনফিগারেশন। |
FunctionCallingConfig
ফাংশন কলিং আচরণ নির্দিষ্ট করার জন্য কনফিগারেশন।
JSON প্রতিনিধিত্ব |
---|
{
"mode": enum ( |
ক্ষেত্র | |
---|---|
mode | ঐচ্ছিক। যে মোডে ফাংশন কলিং চালানো উচিত তা নির্দিষ্ট করে। অনির্দিষ্ট থাকলে, ডিফল্ট মানটি অটোতে সেট করা হবে। |
allowedFunctionNames[] | ঐচ্ছিক। ফাংশনের নামের একটি সেট যা প্রদান করা হলে, মডেলটি যে ফাংশনগুলিকে কল করবে তা সীমিত করে। এটি শুধুমাত্র তখনই সেট করা উচিত যখন মোড যেকোনো হয়। ফাংশনের নামগুলি [FunctionDeclaration.name] মেলে। মোড যেকোনও সেট করে, মডেল প্রদত্ত ফাংশন নামের সেট থেকে একটি ফাংশন কলের পূর্বাভাস দেবে। |
মোড
এক্সিকিউশন মোড সংজ্ঞায়িত করে ফাংশন কলিংয়ের জন্য নির্বাহ আচরণ সংজ্ঞায়িত করে।
Enums | |
---|---|
MODE_UNSPECIFIED | অনির্দিষ্ট ফাংশন কলিং মোড। এই মান ব্যবহার করা উচিত নয়. |
AUTO | ডিফল্ট মডেল আচরণ, মডেল একটি ফাংশন কল বা একটি প্রাকৃতিক ভাষা প্রতিক্রিয়া ভবিষ্যদ্বাণী করার সিদ্ধান্ত নেয়। |
ANY | মডেল সবসময় শুধুমাত্র একটি ফাংশন কল ভবিষ্যদ্বাণী করতে সীমাবদ্ধ। যদি "allowedFunctionNames" সেট করা থাকে, তাহলে ভবিষ্যদ্বাণীকৃত ফাংশন কলটি "allowedFunctionNames" এর যেকোনো একটিতে সীমাবদ্ধ থাকবে, অন্যথায় পূর্বাভাসিত ফাংশন কলটি প্রদত্ত "ফাংশন ঘোষণা" এর যেকোনো একটি হবে। |
NONE | মডেল কোনো ফাংশন কল ভবিষ্যদ্বাণী করবে না. মডেল আচরণ কোন ফাংশন ঘোষণা পাস না যখন একই. |
মেটাডেটা ব্যবহার
ক্যাশে করা বিষয়বস্তুর ব্যবহারের উপর মেটাডেটা।
JSON প্রতিনিধিত্ব |
---|
{ "totalTokenCount": integer } |
ক্ষেত্র | |
---|---|
totalTokenCount | ক্যাশ করা সামগ্রী ব্যবহার করে মোট টোকেনের সংখ্যা৷ |
পদ্ধতি | |
---|---|
| ক্যাশেড কনটেন্ট রিসোর্স তৈরি করে। |
| ক্যাশেড কনটেন্ট রিসোর্স মুছে দেয়। |
| ক্যাশেড কনটেন্ট রিসোর্স পড়ে। |
| ক্যাশেড বিষয়বস্তু তালিকাভুক্ত করে। |
| ক্যাশেড কনটেন্ট রিসোর্স আপডেট করে (কেবলমাত্র মেয়াদ শেষ হওয়া আপডেটযোগ্য)। |