Method: answerQuery

গ্রাউন্ডেড জেনারেশন ব্যবহার করে একটি কোয়েরির উত্তর দেয়।

HTTP অনুরোধ

POST https://developerknowledge.googleapis.com/v1alpha:answerQuery

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

অনুরোধকারী শরীর

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

JSON উপস্থাপনা 
{
  "query": string,
  "filter": string
}
ক্ষেত্র
query

string

প্রয়োজনীয়। যে প্রশ্নের উত্তর দিতে হবে।

filter

string

ঐচ্ছিক। উত্তরের ভিত্তি হিসেবে ব্যবহৃত অনুসন্ধানের ফলাফলের উপর একটি কঠোর ফিল্টার প্রয়োগ করে। এই এক্সপ্রেশনটি https://google.aip.dev/160 -এ বর্ণিত সিনট্যাক্সের একটি উপসেট সমর্থন করে।

ফিল্টার করার জন্য সমর্থিত ক্ষেত্রসমূহ:

  • contentLengthBytes (পূর্ণসংখ্যা): Document.content ফিল্ডের দৈর্ঘ্য, যা বাইটে পরিমাপ করা হয়।
  • dataSource (স্ট্রিং): ডকুমেন্টটির উৎস, যেমন docs.cloud.google.com । কর্পাসের ডেটা উৎসগুলোর সম্পূর্ণ তালিকার জন্য https://developers.google.com/knowledge/reference/corpus-reference দেখুন।
  • updateTime (টাইমস্ট্যাম্প): ডকুমেন্টটি সর্বশেষ কখন অর্থপূর্ণভাবে আপডেট করা হয়েছিল তার টাইমস্ট্যাম্প। একটি অর্থপূর্ণ আপডেট হলো এমন একটি আপডেট যা ডকুমেন্টের মার্কডাউন কন্টেন্ট বা মেটাডেটা পরিবর্তন করে।
  • uri (স্ট্রিং): ডকুমেন্ট URI, যেমন https://docs.cloud.google.com/bigquery/docs/tables ।

INTEGER ফিল্ডে = , < , <= , > , এবং >= অপারেটরগুলো সমর্থিত।

STRING ফিল্ডগুলো সম্পূর্ণ স্ট্রিংয়ের সঠিক মিলের জন্য = (সমান) এবং != (অসমান) অপারেটর সমর্থন করে। আংশিক মিল, প্রিফিক্স মিল এবং রেজেক্সপ মিল সমর্থিত নয়।

TIMESTAMP ফিল্ডে = , < , <= , > , এবং >= অপারেটরগুলো সমর্থিত। টাইমস্ট্যাম্প অবশ্যই RFC-3339 ফরম্যাটে হতে হবে, যেমন, "2025-01-01T00:00:00Z" ।

আপনি AND , OR , এবং NOT (বা - ) লজিক্যাল অপারেটর ব্যবহার করে এক্সপ্রেশন একত্রিত করতে পারেন। AND এর চেয়ে OR অগ্রাধিকার বেশি। সুস্পষ্ট অগ্রাধিকার গ্রুপিংয়ের জন্য প্রথম বন্ধনী ব্যবহার করুন।

উদাহরণ:

  • Document.content_length_bytes দ্বারা ফিল্টার করুন : contentLengthBytes < 50000
  • dataSource = "docs.cloud.google.com" OR dataSource = "firebase.google.com"
  • dataSource != "firebase.google.com"
  • updateTime < "2024-01-01T00:00:00Z"
  • updateTime >= "2025-01-22T00:00:00Z" AND (dataSource = "developer.chrome.com" OR dataSource = "web.dev")
  • uri = "https://docs.cloud.google.com/release-notes"

filter স্ট্রিং অবশ্যই ৫০০ অক্ষরের বেশি হবে না; ৫০০ অক্ষরের চেয়ে দীর্ঘ মানের ফলে INVALID_ARGUMENT ত্রুটি দেখা দেবে।

প্রতিক্রিয়া সংস্থা

DeveloperKnowledge.AnswerQuery এর জন্য প্রতিক্রিয়া বার্তা।

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

JSON উপস্থাপনা 
{
  "answer": {
    object (Answer)
  }
}
ক্ষেত্র
answer

object ( Answer )

প্রশ্নটির উত্তর।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/devprofiles.full_control
  • https://www.googleapis.com/auth/developerprofiles.readonly
  • https://www.googleapis.com/auth/cloud-platform

আরও তথ্যের জন্য, দেখুনOAuth 2.0 Overview .

উত্তর

একটি জিজ্ঞাসার উত্তর।

JSON উপস্থাপনা 
{
  "answerText": string,
  "citations": [
    {
      object (AnswerCitation)
    }
  ],
  "references": [
    {
      object (AnswerReference)
    }
  ]
}
ক্ষেত্র
answerText

string

এতে উত্তরের লেখাটি রয়েছে।

citations[]

object ( AnswerCitation )

শুধুমাত্র আউটপুট। উত্তরের জন্য তথ্যসূত্র রয়েছে।

references[]

object ( AnswerReference )

শুধুমাত্র আউটপুট। এতে উত্তরের জন্য তথ্যসূত্র রয়েছে।

উত্তর উদ্ধৃতি

একটি অংশের জন্য উদ্ধৃতি তথ্য।

JSON উপস্থাপনা 
{
  "startIndex": integer,
  "endIndex": integer,
  "sources": [
    {
      object (CitationSource)
    }
  ]
}
ক্ষেত্র
startIndex

integer

শুধুমাত্র আউটপুট। এটি সেগমেন্টের শুরু নির্দেশ করে, যা বাইট (UTF-8 ইউনিকোড) এককে পরিমাপ করা হয়। যদি একাধিক বাইটের অক্ষর, যেমন নন-ASCII অক্ষর থাকে, তবে সূচকের পরিমাপ স্ট্রিংয়ের দৈর্ঘ্যের চেয়ে বেশি হয়।

endIndex

integer

শুধুমাত্র আউটপুট। এটি সেগমেন্টের শেষ নির্দেশ করে, যা বাইটে (UTF-8 ইউনিকোড) পরিমাপ করা হয় এবং এতে কোনো বাইটের উল্লেখ থাকে না। যদি একাধিক বাইটের অক্ষর, যেমন নন-ASCII অক্ষর থাকে, তবে ইনডেক্সের পরিমাপ স্ট্রিংয়ের দৈর্ঘ্যের চেয়ে বেশি হয়।

sources[]

object ( CitationSource )

শুধুমাত্র আউটপুট। এতে আরোপিত অংশের জন্য উদ্ধৃতির উৎস অন্তর্ভুক্ত রয়েছে।

উদ্ধৃতি উৎস

উদ্ধৃতির উৎস।

JSON উপস্থাপনা 
{
  "referenceIndex": integer
}
ক্ষেত্র
referenceIndex

integer

শুধুমাত্র আউটপুট। references repeated' ফিল্ডে Answer.AnswerReference এর ইন্ডেক্সটি থাকে।

উত্তর রেফারেন্স

এটি কোনো উৎসের উল্লেখ বোঝায়।

JSON উপস্থাপনা 
{

  // Union field content can be only one of the following:
  "documentReference": {
    object (DocumentReference)
  }
  // End of list of possible types for union field content.
}
ক্ষেত্র
ইউনিয়ন ফিল্ড content । এতে রেফারেন্সের বিষয়বস্তু থাকে। content নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
documentReference

object ( DocumentReference )

শুধুমাত্র আউটপুট। রেফারেন্স ডকুমেন্ট।

ডকুমেন্ট রেফারেন্স

এটি একটি নথির উল্লেখকে বোঝায়।

JSON উপস্থাপনা 
{
  "documentChunk": {
    object (DocumentChunk)
  }
}
ক্ষেত্র
documentChunk

object ( DocumentChunk )

শুধুমাত্র আউটপুট। এতে ডকুমেন্টের খণ্ডাংশ থাকে। documentChunk.id ফিল্ডটি সেট করা হয় না এবং এটি খালি থাকবে।