পদ্ধতি: corpora.create
একটি খালি Corpus
তৈরি করে।
শেষবিন্দু
https://generativelanguage.googleapis.com/v1beta/corpora পোস্ট করুনশরীরের অনুরোধ
অনুরোধের অংশে Corpus
একটি উদাহরণ রয়েছে।
name
string
অপরিবর্তনীয়। শনাক্তকারী। Corpus
সম্পদের নাম। আইডি ("কর্পোরা/" উপসর্গ ব্যতীত নাম) 40টি পর্যন্ত অক্ষর থাকতে পারে যা ছোট হাতের বর্ণমালা বা ড্যাশ (-)। আইডি ড্যাশ দিয়ে শুরু বা শেষ হতে পারে না। নামটি তৈরিতে খালি থাকলে, 12 অক্ষরের র্যান্ডম প্রত্যয় সহ displayName
থেকে একটি অনন্য নাম নেওয়া হবে। উদাহরণ: corpora/my-awesome-corpora-123a456b789c
displayName
string
ঐচ্ছিক। Corpus
জন্য মানব-পাঠযোগ্য প্রদর্শন নাম। প্রদর্শনের নামটি স্পেস সহ দৈর্ঘ্যে 512 অক্ষরের বেশি হওয়া উচিত নয়। উদাহরণ: "ডক্স অন সিমেন্টিক রিট্রিভার"
প্রতিক্রিয়া শরীর
সফল হলে, রেসপন্স বডিতে Corpus
একটি নতুন তৈরি উদাহরণ থাকে।
পদ্ধতি: corpora.query
একটি Corpus
উপর শব্দার্থিক অনুসন্ধান সম্পাদন করে।
শেষবিন্দু
পোস্ট https://generativelanguage.googleapis.com/v1beta/{name=corpora/*}:queryপাথ প্যারামিটার
name
string
প্রয়োজন। কোয়েরি করার জন্য Corpus
নাম। উদাহরণ: corpora/my-corpus-123
এটি corpora/{corpora}
রূপ নেয়।
শরীরের অনুরোধ
অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
query
string
প্রয়োজন। শব্দার্থিক অনুসন্ধান সঞ্চালনের জন্য ক্যোয়ারী স্ট্রিং।
metadataFilters[]
object ( MetadataFilter
)
ঐচ্ছিক। Chunk
এবং Document
মেটাডেটা জন্য ফিল্টার. প্রতিটি MetadataFilter
অবজেক্ট একটি অনন্য কী এর সাথে সঙ্গতিপূর্ণ হওয়া উচিত। একাধিক MetadataFilter
বস্তু যৌক্তিক "AND" দ্বারা যুক্ত হয়।
নথি স্তরে উদাহরণ প্রশ্ন: (বছর >= 2020 বা বছর <2010) এবং (শৈলী = নাটক বা রীতি = কর্ম)
MetadataFilter
অবজেক্ট তালিকা: মেটাডেটাফিল্টার = [ {key = "document.custom_metadata.year" শর্ত = [{int_value = 2020, operation = GREATER_EQUAL}, {int_value = 2010, operation = LESS}]}, {key = "document.custom_met_met. বছর" শর্ত = [{int_value = 2020, অপারেশন = GREATER_EQUAL}, {int_value = 2010, অপারেশন = LESS}]}, {key = "document.custom_metadata.genre" শর্ত = [{stringValue = "ড্রামা", অপারেশন = EQUAL }, {stringValue = "ক্রিয়া", অপারেশন = EQUAL}]}]
মানগুলির একটি সাংখ্যিক পরিসরের জন্য খণ্ড স্তরে উদাহরণ কোয়েরি: (বছর > 2015 এবং বছর <= 2020)
MetadataFilter
অবজেক্ট তালিকা: মেটাডেটা ফিল্টার = [ {key = "chunk.custom_metadata.year" শর্ত = [{int_value = 2015, অপারেশন = GREATER}]}, {key = "chunk.custom_metadata.year" শর্ত = [{int_value = 2020, অপারেশন = LESS_EQUAL}]}]
দ্রষ্টব্য: একই কী-এর জন্য "AND" শুধুমাত্র সাংখ্যিক মানের জন্য সমর্থিত। স্ট্রিং মান শুধুমাত্র একই কী-এর জন্য "OR" সমর্থন করে।
resultsCount
integer
ঐচ্ছিক। সর্বোচ্চ সংখ্যক Chunk
s ফেরত দিতে হবে। পরিষেবা কম Chunk
s ফেরত দিতে পারে.
অনির্দিষ্ট থাকলে, সর্বাধিক 10টি Chunk
ফেরত দেওয়া হবে। সর্বাধিক নির্দিষ্ট ফলাফলের সংখ্যা 100।
প্রতিক্রিয়া শরীর
প্রাসঙ্গিক অংশগুলির একটি তালিকা ধারণকারী corpora.query
থেকে প্রতিক্রিয়া।
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
relevantChunks[]
object ( RelevantChunk
)
প্রাসঙ্গিক খণ্ড.
JSON প্রতিনিধিত্ব |
---|
{
"relevantChunks": [
{
object ( |
পদ্ধতি: corpora.list
ব্যবহারকারীর মালিকানাধীন সমস্ত Corpora
তালিকাভুক্ত করে।
শেষবিন্দু
https://generativelanguage.googleapis.com/v1beta/corpora পানক্যোয়ারী প্যারামিটার
pageSize
integer
ঐচ্ছিক। সর্বোচ্চ সংখ্যক Corpora
ফেরত দিতে হবে (প্রতি পৃষ্ঠায়)। পরিষেবাটি কম Corpora
ফেরত দিতে পারে।
অনির্দিষ্ট থাকলে, সর্বাধিক 10টি Corpora
ফেরত দেওয়া হবে। সর্বোচ্চ আকার সীমা প্রতি পৃষ্ঠায় 20 Corpora
।
pageToken
string
ঐচ্ছিক। পূর্ববর্তী corpora.list
কল থেকে প্রাপ্ত একটি পৃষ্ঠা টোকেন।
পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করার জন্য পরবর্তী অনুরোধের যুক্তি হিসাবে প্রতিক্রিয়াতে ফেরত দেওয়া nextPageToken
প্রদান করুন।
পেজিনেট করার সময়, corpora.list
এ প্রদত্ত অন্যান্য সমস্ত প্যারামিটার অবশ্যই পেজ টোকেন প্রদানকারী কলের সাথে মেলে।
শরীরের অনুরোধ
অনুরোধের বডি খালি হতে হবে।
প্রতিক্রিয়া শরীর
corpora.list
থেকে প্রতিক্রিয়া যার মধ্যে Corpora
এর একটি পৃষ্ঠাযুক্ত তালিকা রয়েছে। ফলাফল corpus.create_time
ক্রমবর্ধমান অনুসারে সাজানো হয়।
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
corpora[]
object ( Corpus
)
প্রত্যাবর্তন কর্পোরা.
nextPageToken
string
একটি টোকেন, যা পরবর্তী পৃষ্ঠা পুনরুদ্ধার করতে pageToken
হিসাবে পাঠানো যেতে পারে। যদি এই ক্ষেত্রটি বাদ দেওয়া হয়, তাহলে আর কোনো পৃষ্ঠা নেই।
JSON প্রতিনিধিত্ব |
---|
{
"corpora": [
{
object ( |
পদ্ধতি: corpora.get
একটি নির্দিষ্ট Corpus
সম্পর্কে তথ্য পায়।
শেষবিন্দু
https://generativelanguage.googleapis.com/v1beta/{name=corpora/*} পানপাথ প্যারামিটার
name
string
প্রয়োজন। Corpus
নাম। উদাহরণ: corpora/my-corpus-123
এটি corpora/{corpora}
রূপ নেয়।
শরীরের অনুরোধ
অনুরোধের বডি খালি হতে হবে।
প্রতিক্রিয়া শরীর
সফল হলে, প্রতিক্রিয়া বডিতে Corpus
একটি উদাহরণ থাকে।
পদ্ধতি: corpora.patch
একটি Corpus
আপডেট করে।
শেষবিন্দু
প্যাচ https://generativelanguage.googleapis.com/v1beta/{corpus.name=corpora/*}PATCH https://generativelanguage.googleapis.com/v1beta/{corpus.name=corpora/*}
পাথ প্যারামিটার
corpus.name
string
অপরিবর্তনীয়। শনাক্তকারী। Corpus
সম্পদের নাম। আইডি ("কর্পোরা/" উপসর্গ ব্যতীত নাম) 40টি পর্যন্ত অক্ষর থাকতে পারে যা ছোট হাতের বর্ণমালা বা ড্যাশ (-)। আইডি ড্যাশ দিয়ে শুরু বা শেষ হতে পারে না। নামটি তৈরিতে খালি থাকলে, 12 অক্ষরের র্যান্ডম প্রত্যয় সহ displayName
থেকে একটি অনন্য নাম নেওয়া হবে। উদাহরণ: corpora/my-awesome-corpora-123a456b789c
এটি corpora/{corpora}
রূপ নেয়।
ক্যোয়ারী প্যারামিটার
updateMask
string ( FieldMask
format)
প্রয়োজন। আপডেট করার জন্য ক্ষেত্রগুলির তালিকা৷ বর্তমানে, এটি শুধুমাত্র displayName
আপডেট করা সমর্থন করে।
এটি ক্ষেত্রগুলির সম্পূর্ণরূপে যোগ্য নামের একটি কমা দ্বারা পৃথক করা তালিকা৷ উদাহরণ: "user.displayName,photo"
।
শরীরের অনুরোধ
অনুরোধের অংশে Corpus
একটি উদাহরণ রয়েছে।
displayName
string
ঐচ্ছিক। Corpus
জন্য মানব-পাঠযোগ্য প্রদর্শন নাম। প্রদর্শনের নামটি স্পেস সহ দৈর্ঘ্যে 512 অক্ষরের বেশি হওয়া উচিত নয়। উদাহরণ: "ডক্স অন সিমেন্টিক রিট্রিভার"
প্রতিক্রিয়া শরীর
সফল হলে, প্রতিক্রিয়া বডিতে Corpus
একটি উদাহরণ থাকে।
পদ্ধতি: corpora.delete
একটি Corpus
মুছে দেয়।
শেষবিন্দু
https://generativelanguage.googleapis.com/v1beta/{name=corpora/*} মুছুনপাথ প্যারামিটার
name
string
প্রয়োজন। Corpus
সম্পদের নাম। উদাহরণ: corpora/my-corpus-123
এটি corpora/{corpora}
রূপ নেয়।
ক্যোয়ারী প্যারামিটার
force
boolean
ঐচ্ছিক। সত্য হিসাবে সেট করা হলে, এই Corpus
সাথে সম্পর্কিত যেকোন Document
এবং বস্তুগুলিও মুছে ফেলা হবে।
যদি মিথ্যা হয় (ডিফল্ট), Corpus
কোনো Document
থাকলে একটি FAILED_PRECONDITION
ত্রুটি ফেরত দেওয়া হবে৷
শরীরের অনুরোধ
অনুরোধের বডি খালি হতে হবে।
প্রতিক্রিয়া শরীর
সফল হলে, প্রতিক্রিয়া বডি খালি।
REST সম্পদ: corpora.permissions
সম্পদ: অনুমতি
অনুমতি সংস্থান ব্যবহারকারী, গোষ্ঠী বা বিশ্বের বাকি অংশকে PaLM API সংস্থানে অ্যাক্সেস দেয় (যেমন একটি টিউন করা মডেল, কর্পাস)।
একটি ভূমিকা হল অনুমোদিত ক্রিয়াকলাপগুলির একটি সংগ্রহ যা ব্যবহারকারীদের PaLM API সংস্থানগুলিতে নির্দিষ্ট ক্রিয়া সম্পাদন করতে দেয়৷ ব্যবহারকারী, গোষ্ঠী বা পরিষেবা অ্যাকাউন্টগুলিতে সেগুলি উপলব্ধ করতে, আপনি ভূমিকা নির্ধারণ করেন৷ আপনি যখন একটি ভূমিকা বরাদ্দ করেন, তখন আপনি অনুমতি দেন যে ভূমিকাটি রয়েছে৷
তিনটি কেন্দ্রীভূত ভূমিকা আছে। প্রতিটি ভূমিকা পূর্ববর্তী ভূমিকার অনুমোদিত ক্রিয়াকলাপগুলির একটি সুপারসেট:
- পাঠক অনুমানের জন্য সম্পদ (যেমন টিউন করা মডেল, কর্পাস) ব্যবহার করতে পারেন
- লেখকের পাঠকের অনুমতি আছে এবং অতিরিক্ত সম্পাদনা এবং ভাগ করতে পারেন
- মালিকের লেখকের অনুমতি আছে এবং অতিরিক্ত মুছে ফেলতে পারে
name
string
শুধুমাত্র আউটপুট। শনাক্তকারী। অনুমতির নাম। একটি অনন্য নাম তৈরি করা হবে. উদাহরণ: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} শুধুমাত্র আউটপুট।
granteeType
enum ( GranteeType
)
ঐচ্ছিক। অপরিবর্তনীয়। অনুদানকারীর ধরন।
emailAddress
string
ঐচ্ছিক। অপরিবর্তনীয়। গোষ্ঠীর ব্যবহারকারীর ইমেল ঠিকানা যা এই অনুমতিটি বোঝায়। অনুমতির অনুদানের ধরন প্রত্যেকে হলে ক্ষেত্র সেট করা হয় না।
role
enum ( Role
)
প্রয়োজন। এই অনুমতি দ্বারা প্রদত্ত ভূমিকা.
JSON প্রতিনিধিত্ব |
---|
{ "name": string, "granteeType": enum ( |
গ্রান্টি টাইপ
এই অনুমতির অনুদানকারীর প্রকারগুলি সংজ্ঞায়িত করে৷
Enums | |
---|---|
GRANTEE_TYPE_UNSPECIFIED | ডিফল্ট মান। এই মান অব্যবহৃত. |
USER | একজন ব্যবহারকারীর প্রতিনিধিত্ব করে। সেট করা হলে, আপনাকে অবশ্যই ব্যবহারকারীর জন্য ইমেল ঠিকানা প্রদান করতে হবে। |
GROUP | একটি গোষ্ঠীর প্রতিনিধিত্ব করে। সেট করা হলে, আপনাকে অবশ্যই গ্রুপের জন্য ইমেল ঠিকানা প্রদান করতে হবে। |
EVERYONE | প্রত্যেকের অ্যাক্সেস প্রতিনিধিত্ব করে. কোন অতিরিক্ত তথ্য প্রয়োজন নেই. |
ভূমিকা
এই অনুমতি দ্বারা প্রদত্ত ভূমিকা সংজ্ঞায়িত করে৷
Enums | |
---|---|
ROLE_UNSPECIFIED | ডিফল্ট মান। এই মান অব্যবহৃত. |
OWNER | মালিক সম্পদ ব্যবহার, আপডেট, ভাগ এবং মুছে ফেলতে পারেন। |
WRITER | লেখক সম্পদ ব্যবহার, আপডেট এবং ভাগ করতে পারেন. |
READER | পাঠক সম্পদ ব্যবহার করতে পারেন. |
মেটাডেটা ফিল্টার
Chunk
বা Document
স্তরের মেটাডেটা মানগুলির উপর ভিত্তি করে পুনরুদ্ধার সীমিত করতে ব্যবহারকারী ফিল্টার প্রদান করেছেন। উদাহরণ (জেনার = নাটক বা জেনার = অ্যাকশন): key = "document.custom_metadata.genre" শর্ত = [{stringValue = "drama", operation = EQUAL}, {stringValue = "action", operation = EQUAL}]
key
string
প্রয়োজন। ফিল্টার করার জন্য মেটাডেটার কী।
conditions[]
object ( Condition
)
প্রয়োজন। প্রদত্ত কীটির Condition
যা এই ফিল্টারটিকে ট্রিগার করবে। যৌক্তিক OR দ্বারা একাধিক Condition
যুক্ত হয়।
JSON প্রতিনিধিত্ব |
---|
{
"key": string,
"conditions": [
{
object ( |
অবস্থা
ফিল্টার শর্ত একটি একক কী-তে প্রযোজ্য।
operation
enum ( Operator
)
প্রয়োজন। শর্তটি ট্রিগার করতে অপারেটর প্রদত্ত কী-মানের জোড়ায় প্রয়োগ করেছে৷
value
। মান টাইপ সংশ্লিষ্ট কী-এর ক্ষেত্রে ক্ষেত্রে সংজ্ঞায়িত মান প্রকারের সাথে সামঞ্জস্যপূর্ণ হতে হবে। মান প্রকারগুলি সামঞ্জস্যপূর্ণ না হলে, ফলাফলটি একটি খালি সেট হবে। যখন CustomMetadata
একটি StringList
মান টাইপ থাকে, তখন ফিল্টারিং শর্তে একটি অন্তর্ভুক্ত/বাদ ক্রিয়াকলাপের সাথে যুক্ত string_value
ব্যবহার করা উচিত, অন্যথায় ফলাফলটিও একটি খালি সেট হবে৷ value
নিম্নলিখিতগুলির মধ্যে একটি হতে পারে: stringValue
string
মেটাডেটা ফিল্টার করার জন্য স্ট্রিং মান।
numericValue
number
মেটাডেটা ফিল্টার করার জন্য সাংখ্যিক মান।
JSON প্রতিনিধিত্ব |
---|
{ "operation": enum ( |
অপারেটর
বৈধ অপারেটরগুলিকে সংজ্ঞায়িত করে যা একটি মূল-মান জোড়ায় প্রয়োগ করা যেতে পারে।
Enums | |
---|---|
OPERATOR_UNSPECIFIED | ডিফল্ট মান। এই মান অব্যবহৃত. |
LESS | সাংখ্যিক দ্বারা সমর্থিত. |
LESS_EQUAL | সাংখ্যিক দ্বারা সমর্থিত. |
EQUAL | সংখ্যাসূচক এবং স্ট্রিং দ্বারা সমর্থিত. |
GREATER_EQUAL | সাংখ্যিক দ্বারা সমর্থিত. |
GREATER | সাংখ্যিক দ্বারা সমর্থিত. |
NOT_EQUAL | সংখ্যাসূচক এবং স্ট্রিং দ্বারা সমর্থিত. |
INCLUDES | স্ট্রিং দ্বারা সমর্থিত শুধুমাত্র যখন প্রদত্ত কী-এর জন্য CustomMetadata মান প্রকারের একটি stringListValue থাকে। |
EXCLUDES | স্ট্রিং দ্বারা সমর্থিত শুধুমাত্র যখন প্রদত্ত কী-এর জন্য CustomMetadata মান প্রকারের একটি stringListValue থাকে। |
REST সম্পদ: কর্পোরা
সম্পদ: কর্পাস
একটি Corpus
হল Document
সংগ্রহ। একটি প্রকল্প সর্বোচ্চ 5টি কর্পোরা তৈরি করতে পারে।
name
string
অপরিবর্তনীয়। শনাক্তকারী। Corpus
সম্পদের নাম। আইডি ("কর্পোরা/" উপসর্গ ব্যতীত নাম) 40টি পর্যন্ত অক্ষর থাকতে পারে যা ছোট হাতের বর্ণমালা বা ড্যাশ (-)। আইডি ড্যাশ দিয়ে শুরু বা শেষ হতে পারে না। নামটি তৈরিতে খালি থাকলে, 12 অক্ষরের র্যান্ডম প্রত্যয় সহ displayName
থেকে একটি অনন্য নাম নেওয়া হবে। উদাহরণ: corpora/my-awesome-corpora-123a456b789c
displayName
string
ঐচ্ছিক। Corpus
জন্য মানব-পাঠযোগ্য প্রদর্শন নাম। প্রদর্শনের নামটি স্পেস সহ দৈর্ঘ্যে 512 অক্ষরের বেশি হওয়া উচিত নয়। উদাহরণ: "ডক্স অন সিমেন্টিক রিট্রিভার"
createTime
string ( Timestamp
format)
শুধুমাত্র আউটপুট। Corpus
কখন তৈরি হয়েছিল তার টাইমস্ট্যাম্প।
RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z"
এবং "2014-10-02T15:01:23.045123456Z"
।
updateTime
string ( Timestamp
format)
শুধুমাত্র আউটপুট। কখন Corpus
সর্বশেষ আপডেট করা হয়েছিল তার টাইমস্ট্যাম্প৷
RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z"
এবং "2014-10-02T15:01:23.045123456Z"
।
JSON প্রতিনিধিত্ব |
---|
{ "name": string, "displayName": string, "createTime": string, "updateTime": string } |