Corpora

REST সম্পদ: কর্পোরা

সম্পদ: কর্পাস

একটি Corpus হল Document সংগ্রহ। একটি প্রকল্প সর্বোচ্চ 5টি কর্পোরা তৈরি করতে পারে।

JSON প্রতিনিধিত্ব
{
  "name": string,
  "displayName": string,
  "createTime": string,
  "updateTime": string
}
ক্ষেত্র
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" ।

পদ্ধতি: corpora.create

একটি খালি Corpus তৈরি করে।

শেষপ্রান্ত

https://generativelanguage.googleapis.com/v1beta/corpora পোস্ট করুন

শরীরের অনুরোধ

অনুরোধের অংশে Corpus একটি উদাহরণ রয়েছে।

প্রতিক্রিয়া শরীর

সফল হলে, রেসপন্স বডিতে Corpus একটি নতুন তৈরি উদাহরণ থাকে।

পদ্ধতি: 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 (Corpus)
    }
  ],
  "nextPageToken": string
}

পদ্ধতি: 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 (RelevantChunk)
    }
  ]
}

পদ্ধতি: 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 একটি উদাহরণ রয়েছে।

প্রতিক্রিয়া শরীর

সফল হলে, প্রতিক্রিয়া বডিতে 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 সংস্থানগুলিতে নির্দিষ্ট ক্রিয়া সম্পাদন করতে দেয়৷ ব্যবহারকারী, গোষ্ঠী বা পরিষেবা অ্যাকাউন্টগুলিতে সেগুলি উপলব্ধ করতে, আপনি ভূমিকা নির্ধারণ করেন৷ আপনি যখন একটি ভূমিকা বরাদ্দ করেন, তখন আপনি অনুমতি দেন যে ভূমিকাটি রয়েছে৷

তিনটি কেন্দ্রীভূত ভূমিকা আছে। প্রতিটি ভূমিকা পূর্ববর্তী ভূমিকার অনুমোদিত ক্রিয়াকলাপগুলির একটি সুপারসেট:

  • পাঠক অনুমানের জন্য সম্পদ (যেমন টিউন করা মডেল, কর্পাস) ব্যবহার করতে পারেন
  • লেখকের পাঠকের অনুমতি আছে এবং অতিরিক্ত সম্পাদনা এবং ভাগ করতে পারেন
  • মালিকের লেখকের অনুমতি আছে এবং অতিরিক্ত মুছে ফেলতে পারে
JSON প্রতিনিধিত্ব
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}
ক্ষেত্র
name string

শুধুমাত্র আউটপুট। শনাক্তকারী। অনুমতির নাম। একটি অনন্য নাম তৈরি করা হবে. উদাহরণ: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} শুধুমাত্র আউটপুট।

granteeType enum ( GranteeType )

ঐচ্ছিক। অপরিবর্তনীয়। অনুদানকারীর ধরন।

emailAddress string

ঐচ্ছিক। অপরিবর্তনীয়। গোষ্ঠীর ব্যবহারকারীর ইমেল ঠিকানা যা এই অনুমতিটি বোঝায়। অনুমতির অনুদানের ধরন প্রত্যেকে হলে ক্ষেত্র সেট করা হয় না।

role enum ( Role )

প্রয়োজন। এই অনুমতি দ্বারা প্রদত্ত ভূমিকা.

গ্রান্টি টাইপ

এই অনুমতির অনুদানকারীর প্রকারগুলি সংজ্ঞায়িত করে৷

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}]

JSON প্রতিনিধিত্ব
{
  "key": string,
  "conditions": [
    {
      object (Condition)
    }
  ]
}
ক্ষেত্র
key string

প্রয়োজন। ফিল্টার করার জন্য মেটাডেটার কী।

conditions[] object ( Condition )

প্রয়োজন। প্রদত্ত কীটির Condition যা এই ফিল্টারটিকে ট্রিগার করবে। যৌক্তিক OR দ্বারা একাধিক Condition যুক্ত হয়।

অবস্থা

ফিল্টার শর্ত একটি একক কী-তে প্রযোজ্য।

JSON প্রতিনিধিত্ব
{
  "operation": enum (Operator),

  // Union field value can be only one of the following:
  "stringValue": string,
  "numericValue": number
  // End of list of possible types for union field value.
}
ক্ষেত্র
operation enum ( Operator )

প্রয়োজন। শর্তটি ট্রিগার করতে অপারেটর প্রদত্ত কী-মানের জোড়ায় প্রয়োগ করেছে৷

ইউনিয়ন ক্ষেত্রের value । মান টাইপ সংশ্লিষ্ট কী-এর ক্ষেত্রে ক্ষেত্রে সংজ্ঞায়িত মান প্রকারের সাথে সামঞ্জস্যপূর্ণ হতে হবে। মান প্রকারগুলি সামঞ্জস্যপূর্ণ না হলে, ফলাফলটি একটি খালি সেট হবে। যখন CustomMetadata একটি StringList মান টাইপ থাকে, তখন ফিল্টারিং শর্তে একটি অন্তর্ভুক্ত/বাদ ক্রিয়াকলাপের সাথে যুক্ত string_value ব্যবহার করা উচিত, অন্যথায় ফলাফলটিও একটি খালি সেট হবে৷ value নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
stringValue string

মেটাডেটা ফিল্টার করার জন্য স্ট্রিং মান।

numericValue number

মেটাডেটা ফিল্টার করার জন্য সাংখ্যিক মান।

অপারেটর

বৈধ অপারেটরগুলিকে সংজ্ঞায়িত করে যা একটি মূল-মান জোড়ায় প্রয়োগ করা যেতে পারে।

Enums
OPERATOR_UNSPECIFIED ডিফল্ট মান। এই মান অব্যবহৃত.
LESS সাংখ্যিক দ্বারা সমর্থিত.
LESS_EQUAL সাংখ্যিক দ্বারা সমর্থিত.
EQUAL সংখ্যাসূচক এবং স্ট্রিং দ্বারা সমর্থিত.
GREATER_EQUAL সাংখ্যিক দ্বারা সমর্থিত.
GREATER সাংখ্যিক দ্বারা সমর্থিত.
NOT_EQUAL সংখ্যাসূচক এবং স্ট্রিং দ্বারা সমর্থিত.
INCLUDES স্ট্রিং দ্বারা সমর্থিত শুধুমাত্র যখন প্রদত্ত কী-এর জন্য CustomMetadata মান প্রকারের একটি stringListValue থাকে।
EXCLUDES স্ট্রিং দ্বারা সমর্থিত শুধুমাত্র যখন প্রদত্ত কী-এর জন্য CustomMetadata মান প্রকারের একটি stringListValue থাকে।

প্রাসঙ্গিকচঙ্ক

একটি প্রশ্নের সাথে প্রাসঙ্গিক একটি অংশের জন্য তথ্য।

JSON প্রতিনিধিত্ব
{
  "chunkRelevanceScore": number,
  "chunk": {
    object (Chunk)
  }
}
ক্ষেত্র
chunkRelevanceScore number

প্রশ্নের সাথে Chunk প্রাসঙ্গিকতা.

chunk object ( Chunk )

প্রশ্নের সাথে যুক্ত Chunk .