Chunks

REST সম্পদ: corpora.documents.chunks

সম্পদ: খণ্ড

একটি Chunk হল একটি Document একটি সাবপার্ট যা ভেক্টর প্রতিনিধিত্ব এবং স্টোরেজের উদ্দেশ্যে একটি স্বাধীন ইউনিট হিসাবে বিবেচিত হয়। একটি Corpus সর্বোচ্চ 1 মিলিয়ন Chunk হতে পারে।

JSON প্রতিনিধিত্ব
{
  "name": string,
  "data": {
    object (ChunkData)
  },
  "customMetadata": [
    {
      object (CustomMetadata)
    }
  ],
  "createTime": string,
  "updateTime": string,
  "state": enum (State)
}
ক্ষেত্র
name string

অপরিবর্তনীয়। শনাক্তকারী। Chunk সম্পদের নাম। ID ("corpora/*/documents/*/chunks/" উপসর্গ ব্যতীত নাম) 40টি পর্যন্ত অক্ষর থাকতে পারে যা ছোট হাতের বর্ণমালা বা ড্যাশ (-)। আইডি ড্যাশ দিয়ে শুরু বা শেষ হতে পারে না। নামটি তৈরি করার সময় খালি থাকলে, একটি র্যান্ডম 12-অক্ষরের অনন্য আইডি তৈরি করা হবে। উদাহরণ: corpora/{corpus_id}/documents/{document_id}/chunks/123a456b789c

data object ( ChunkData )

প্রয়োজন। Chunk জন্য বিষয়বস্তু, যেমন টেক্সট স্ট্রিং। প্রতি খণ্ডে টোকেনের সর্বোচ্চ সংখ্যা 2043।

customMetadata[] object ( CustomMetadata )

ঐচ্ছিক। ব্যবহারকারীর প্রদান করা কাস্টম মেটাডেটা কী-মান জোড়া হিসাবে সংরক্ষণ করা হয়েছে। প্রতি খণ্ডে CustomMetadata সর্বাধিক সংখ্যা 20।

createTime string ( Timestamp format)

শুধুমাত্র আউটপুট। Chunk কখন তৈরি করা হয়েছিল তার টাইমস্ট্যাম্প।

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z" ।

updateTime string ( Timestamp format)

শুধুমাত্র আউটপুট। Chunk শেষবার কখন আপডেট করা হয়েছিল তার টাইমস্ট্যাম্প৷

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z" ।

state enum ( State )

শুধুমাত্র আউটপুট। Chunk বর্তমান অবস্থা।

চুংকডাটা

নিষ্কাশিত ডেটা যা Chunk বিষয়বস্তুর প্রতিনিধিত্ব করে।

JSON প্রতিনিধিত্ব
{

  // Union field data can be only one of the following:
  "stringValue": string
  // End of list of possible types for union field data.
}
ক্ষেত্র

ইউনিয়ন ক্ষেত্রের data ।

data নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

stringValue string

একটি স্ট্রিং হিসাবে Chunk বিষয়বস্তু. প্রতি খণ্ডে টোকেনের সর্বোচ্চ সংখ্যা 2043।

অবস্থা

একটি Chunk জীবনচক্রের জন্য রাজ্যগুলি।

Enums
STATE_UNSPECIFIED ডিফল্ট মান। এই মানটি ব্যবহার করা হয় যদি রাষ্ট্রটি বাদ দেওয়া হয়।
STATE_PENDING_PROCESSING Chunk প্রক্রিয়া করা হচ্ছে (এমবেডিং এবং ভেক্টর স্টোরেজ)।
STATE_ACTIVE Chunk প্রক্রিয়া করা হয় এবং অনুসন্ধানের জন্য উপলব্ধ।
STATE_FAILED Chunk ব্যর্থ প্রক্রিয়াকরণ.

পদ্ধতি: corpora.documents.chunks.create

একটি Chunk তৈরি করে।

শেষপ্রান্ত

পোস্ট https://generativelanguage.googleapis.com/v1beta/{parent=corpora/*/documents/*}/chunks

পাথ প্যারামিটার

parent string

প্রয়োজন। Document নাম যেখানে এই Chunk তৈরি করা হবে। উদাহরণ: corpora/my-corpus-123/documents/the-doc-abc এটি corpora/{corpora}/documents/{document} ফর্ম নেয়।

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

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

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

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

পদ্ধতি: corpora.documents.chunks.list

একটি Document সমস্ত Chunk তালিকাভুক্ত করে।

শেষপ্রান্ত

https://generativelanguage.googleapis.com/v1beta/{parent=corpora/*/documents/*}/chunks পান

পাথ প্যারামিটার

parent string

প্রয়োজন। Chunk s ধারণকারী Document নাম। উদাহরণ: corpora/my-corpus-123/documents/the-doc-abc এটি corpora/{corpora}/documents/{document} ফর্ম নেয়।

ক্যোয়ারী প্যারামিটার

pageSize integer

ঐচ্ছিক। (প্রতি পৃষ্ঠায়) ফেরত দেওয়ার জন্য সর্বাধিক সংখ্যক Chunk । পরিষেবা কম Chunk s ফেরত দিতে পারে.

অনির্দিষ্ট থাকলে, সর্বাধিক 10টি Chunk ফেরত দেওয়া হবে। সর্বোচ্চ আকার সীমা প্রতি পৃষ্ঠায় 100 Chunk s।

pageToken string

ঐচ্ছিক। একটি পৃষ্ঠা টোকেন, একটি পূর্ববর্তী chunks.list কল থেকে প্রাপ্ত।

পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করার জন্য পরবর্তী অনুরোধের যুক্তি হিসাবে প্রতিক্রিয়াতে ফেরত দেওয়া nextPageToken প্রদান করুন।

পেজিনেট করার সময়, chunks.list এ প্রদত্ত অন্যান্য সমস্ত প্যারামিটার অবশ্যই পেজ টোকেন প্রদানকারী কলের সাথে মেলে।

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

অনুরোধের বডি খালি হতে হবে।

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

chunks.list থেকে প্রতিক্রিয়া যা Chunk s-এর একটি পৃষ্ঠাযুক্ত তালিকা রয়েছে। Chunk ক্রমবর্ধমান chunk.create_time দ্বারা সাজানো হয়।

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

ক্ষেত্র
chunks[] object ( Chunk )

ফিরে আসা Chunk এস.

nextPageToken string

একটি টোকেন, যা পরবর্তী পৃষ্ঠা পুনরুদ্ধার করতে pageToken হিসাবে পাঠানো যেতে পারে। যদি এই ক্ষেত্রটি বাদ দেওয়া হয়, তাহলে আর কোনো পৃষ্ঠা নেই।

JSON প্রতিনিধিত্ব
{
  "chunks": [
    {
      object (Chunk)
    }
  ],
  "nextPageToken": string
}

পদ্ধতি: corpora.documents.chunks.get

একটি নির্দিষ্ট Chunk সম্পর্কে তথ্য পায়।

শেষপ্রান্ত

https://generativelanguage.googleapis.com/v1beta/{name=corpora/*/documents/*/chunks/*} পান

পাথ প্যারামিটার

name string

প্রয়োজন। পুনরুদ্ধার করার জন্য Chunk নাম। উদাহরণ: corpora/my-corpus-123/documents/the-doc-abc/chunks/some-chunk এটি corpora/{corpora}/documents/{document}/chunks/{chunk} রূপ নেয়।

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

অনুরোধের বডি খালি হতে হবে।

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

সফল হলে, প্রতিক্রিয়া বডিতে Chunk এর একটি উদাহরণ থাকে।

পদ্ধতি: corpora.documents.chunks.patch

একটি Chunk আপডেট করে।

শেষপ্রান্ত

প্যাচ https://generativelanguage.googleapis.com/v1beta/{chunk.name=corpora/*/documents/*/chunks/*}
PATCH https://generativelanguage.googleapis.com/v1beta/{chunk.name=corpora/*/documents/*/chunks/*}

পাথ প্যারামিটার

chunk.name string

অপরিবর্তনীয়। শনাক্তকারী। Chunk সম্পদের নাম। ID ("corpora/*/documents/*/chunks/" উপসর্গ ব্যতীত নাম) 40টি পর্যন্ত অক্ষর থাকতে পারে যা ছোট হাতের বর্ণমালা বা ড্যাশ (-)। আইডি ড্যাশ দিয়ে শুরু বা শেষ হতে পারে না। নামটি তৈরি করার সময় খালি থাকলে, একটি র্যান্ডম 12-অক্ষরের অনন্য আইডি তৈরি করা হবে। উদাহরণ: corpora/{corpus_id}/documents/{document_id}/chunks/123a456b789c এটি corpora/{corpora}/documents/{document}/chunks/{chunk} রূপ নেয়।

ক্যোয়ারী প্যারামিটার

updateMask string ( FieldMask format)

প্রয়োজন। আপডেট করার জন্য ক্ষেত্রগুলির তালিকা৷ বর্তমানে, এটি শুধুমাত্র customMetadata এবং data আপডেট করা সমর্থন করে।

এটি ক্ষেত্রগুলির সম্পূর্ণরূপে যোগ্য নামের একটি কমা দ্বারা পৃথক করা তালিকা৷ উদাহরণ: "user.displayName,photo" ।

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

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

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

সফল হলে, প্রতিক্রিয়া বডিতে Chunk এর একটি উদাহরণ থাকে।

পদ্ধতি: corpora.documents.chunks.delete

একটি Chunk মুছে দেয়।

শেষপ্রান্ত

https://generativelanguage.googleapis.com/v1beta/{name=corpora/*/documents/*/chunks/*} মুছুন

পাথ প্যারামিটার

name string

প্রয়োজন। মুছে ফেলার Chunk সম্পদের নাম। উদাহরণ: corpora/my-corpus-123/documents/the-doc-abc/chunks/some-chunk এটি corpora/{corpora}/documents/{document}/chunks/{chunk} রূপ নেয়।

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

অনুরোধের বডি খালি হতে হবে।

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

সফল হলে, প্রতিক্রিয়া বডি খালি।

পদ্ধতি: corpora.documents.chunks.batchCreate

ব্যাচ Chunk গুলি তৈরি করুন।

শেষপ্রান্ত

পোস্ট https://generativelanguage.googleapis.com/v1beta/{parent=corpora/*/documents/*}/chunks:batchCreate

পাথ প্যারামিটার

parent string

ঐচ্ছিক। Document নাম যেখানে Chunk s-এর এই ব্যাচ তৈরি করা হবে। প্রতিটি CreateChunkRequest এর মূল ক্ষেত্র অবশ্যই এই মানটির সাথে মেলে। উদাহরণ: corpora/my-corpus-123/documents/the-doc-abc এটি corpora/{corpora}/documents/{document} ফর্ম নেয়।

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

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

ক্ষেত্র
requests[] object ( CreateChunkRequest )

প্রয়োজন। অনুরোধের বার্তাগুলি তৈরি করার জন্য Chunk নির্দিষ্ট করে। একটি ব্যাচে সর্বাধিক 100 Chunk তৈরি করা যেতে পারে।

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

chunks.batchCreate থেকে প্রতিক্রিয়া তৈরি করা Chunk একটি তালিকা রয়েছে।

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

ক্ষেত্র
chunks[] object ( Chunk )

Chunk তৈরি করা হয়েছে।

JSON প্রতিনিধিত্ব
{
  "chunks": [
    {
      object (Chunk)
    }
  ]
}

CreateChunkRequest

একটি Chunk তৈরি করার জন্য অনুরোধ করুন।

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

প্রয়োজন। Document নাম যেখানে এই Chunk তৈরি করা হবে। উদাহরণ: corpora/my-corpus-123/documents/the-doc-abc

chunk object ( Chunk )

প্রয়োজন। Chunk তৈরি করতে.

পদ্ধতি: corpora.documents.chunks.batchUpdate

ব্যাচ আপডেট Chunk এস.

শেষপ্রান্ত

https://generativelanguage.googleapis.com/v1beta/{parent=corpora/*/documents/*}/chunks:batchUpdate পোস্ট করুন

পাথ প্যারামিটার

parent string

ঐচ্ছিক। আপডেট করার জন্য Chunk s ধারণকারী Document নাম। প্রতিটি UpdateChunkRequest এর মূল ক্ষেত্র অবশ্যই এই মানটির সাথে মেলে। উদাহরণ: corpora/my-corpus-123/documents/the-doc-abc এটি corpora/{corpora}/documents/{document} ফর্ম নেয়।

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

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

ক্ষেত্র
requests[] object ( UpdateChunkRequest )

প্রয়োজন। অনুরোধের বার্তাগুলি আপডেট করার জন্য Chunk নির্দিষ্ট করে। একটি ব্যাচে সর্বাধিক 100টি Chunk আপডেট করা যেতে পারে।

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

chunks.batchUpdate থেকে প্রতিক্রিয়া আপডেট করা Chunk একটি তালিকা সহ।

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

ক্ষেত্র
chunks[] object ( Chunk )

Chunk আপডেট করা হয়েছে.

JSON প্রতিনিধিত্ব
{
  "chunks": [
    {
      object (Chunk)
    }
  ]
}

UpdateChunkRequest

একটি Chunk আপডেট করার জন্য অনুরোধ করুন।

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

প্রয়োজন। আপডেট করার জন্য Chunk .

updateMask string ( FieldMask format)

প্রয়োজন। আপডেট করার জন্য ক্ষেত্রগুলির তালিকা৷ বর্তমানে, এটি শুধুমাত্র customMetadata এবং data আপডেট করা সমর্থন করে।

এটি ক্ষেত্রগুলির সম্পূর্ণরূপে যোগ্য নামের একটি কমা দ্বারা পৃথক করা তালিকা৷ উদাহরণ: "user.displayName,photo" ।

পদ্ধতি: corpora.documents.chunks.batchDelete

ব্যাচ মুছে ফেলুন Chunk এস.

শেষপ্রান্ত

পোস্ট https://generativelanguage.googleapis.com/v1beta/{parent=corpora/*/documents/*}/chunks:batchDelete

পাথ প্যারামিটার

parent string

ঐচ্ছিক। মুছে ফেলার Chunk s ধারণকারী Document নাম। প্রতিটি DeleteChunkRequest এর মূল ক্ষেত্র অবশ্যই এই মানটির সাথে মেলে। উদাহরণ: corpora/my-corpus-123/documents/the-doc-abc এটি corpora/{corpora}/documents/{document} ফর্ম নেয়।

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

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

ক্ষেত্র
requests[] object ( DeleteChunkRequest )

প্রয়োজন। অনুরোধ বার্তা মুছে ফেলার Chunk নির্দিষ্ট করে.

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

সফল হলে, প্রতিক্রিয়া বডি খালি।

DeleteChunkRequest

একটি Chunk মুছে ফেলার জন্য অনুরোধ করুন।

JSON প্রতিনিধিত্ব
{
  "name": string
}
ক্ষেত্র
name string

প্রয়োজন। মুছে ফেলার Chunk সম্পদের নাম। উদাহরণ: corpora/my-corpus-123/documents/the-doc-abc/chunks/some-chunk