MCP Tools Reference: developerknowledge.googleapis.com

টুল: get_documents

একটি ডকুমেন্টের সম্পূর্ণ কন্টেন্ট বা একটি কলে সর্বাধিক ২০টি ডকুমেন্ট ফিরিয়ে আনতে এই টুল ব্যবহার করুন। ডকুমেন্টের নাম হয় search_documents টুলে কল করার ফলে পাওয়া ফলাফলের parent ফিল্ড থেকে অথবা answer_query টুলের মাধ্যমে পাওয়া references ফিল্ড থেকে পেতে হবে। names প্যারামিটারকে ডকুমেন্টের নামের (documents/...) তালিকায় সেট করুন এবং আপনার চূড়ান্ত উত্তরে ব্যবহৃত প্রামাণ্য সোর্স ডকুমেন্ট উল্লেখ করুন।

get_documents MCP টুল কল করার জন্য কীভাবে curl ব্যবহার করতে হয় তা নিম্নলিখিত কোড স্যাম্পেল থেকে জানতে পারবেন।

Curl অনুরোধ 
curl --location 'https://developerknowledge.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "get_documents",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

get_documents-এর জন্য স্কিমার অনুরোধ করুন।

GetDocumentsRequest

JSON উপস্থাপনা 
{
  "names": [
    string
  ]
}
ফিল্ড
names[]

string

প্রয়োজনীয়। যেসব ডকুমেন্ট ফিরিয়ে আনতে হবে সেগুলির নাম, যেমন search_documents ফলাফলের parent ফিল্ড বা answer_query-এর references ফিল্ড দ্বারা ফিরিয়ে আনা হয়েছে। একবার কল করে সর্বাধিক ২০টি ডকুমেন্ট রিট্রিভ করা যাবে। অনুরোধে names-এর মতো একই ক্রমে ডকুমেন্টগুলি ফেরত দেওয়া হয়। ফর্ম্যাট: documents/{uri_without_scheme} উদাহরণ: documents/docs.cloud.google.com/storage/docs/creating-buckets

আউটপুট স্কিমা

get_documents-এর জন্য উত্তর স্কিমা।

GetDocumentsResponse

JSON উপস্থাপনা 
{
  "documents": [
    {
      object (Document)
    }
  ]
}
ফিল্ড
documents[]

object (Document)

ডকুমেন্টের অনুরোধ করা হয়েছে।

দস্তাবেজ

JSON উপস্থাপনা 
{
  "name": string,
  "uri": string,
  "content": string,
  "description": string,
  "title": string
}
ফিল্ড
name

string

শনাক্তকারী। ডকুমেন্টের রিসোর্স নাম। ফর্ম্যাট: documents/{uri_without_scheme} উদাহরণ: documents/docs.cloud.google.com/storage/docs/creating-buckets
uri

string

শুধু আউটপুট। কন্টেন্টের URI, যেমন https://cloud.google.com/storage/docs/creating-buckets।
content

string

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

string

শুধু আউটপুট। ডকুমেন্টের বিবরণ।
title

string

শুধু আউটপুট। ডকুমেন্টের শীর্ষক।

টুল অ্যানোটেশন

প্রদত্ত টুলের প্রাথমিক ঝুঁকি বর্ণনা করার জন্য MCP ক্লায়েন্টদের টুল অ্যানোটেশন পাঠানো হয়। বেশিরভাগ ক্লায়েন্ট এইসব ইঙ্গিতকে বিশ্বাসযোগ্য বলে মনে করে না, তবে ব্যবহারকারীকে কখন কনফার্মেশন প্রম্পট পাঠানো হবে তা নির্ধারণ করতে এগুলি ব্যবহার করা যেতে পারে।

টাইটেল স্ট্রিংয়ের সাথে, নিম্নলিখিত বুলিয়ান ইঙ্গিতগুলি এইভাবে সংজ্ঞায়িত করা হয়েছে:

  • readOnlyHint: সত্য হলে, টুলটি তার পরিবেশ পরিবর্তন করে না। ডিফল্ট: false.
  • destructiveHint: সত্য হলে, টুলটি ধ্বংসাত্মক অ্যাকশন করতে পারে। মিথ্যা হলে, টুলটি শুধুমাত্র যোগ করার অ্যাকশন করতে পারে। ডিফল্ট: true.
  • idempotentHint: সত্য হলে, একই আর্গুমেন্ট সহ টুলটিকে বারবার কল করলে এর এনভায়রনমেন্টে কোনও অতিরিক্ত প্রভাব পড়বে না। ডিফল্ট: false.
  • openWorldHint: সত্য হলে, টুলটি এক্সটার্নাল এন্টিটির 'মুক্ত পৃথিবী'-র সাথে ইন্টার‍্যাক্ট করতে পারে। মিথ্যা হলে, টুলটি শুধুমাত্র অভ্যন্তরীণ এন্টিটির সাথে ইন্টার‍্যাক্ট করতে পারে। যেমন, ওয়েব সার্চ টুল ওপেন ওয়ার্ল্ড হলেও মেমরি টুল ওপেন ওয়ার্ল্ড নয়।

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌