MCP Tools Reference: developerknowledge.googleapis.com

টুল: get_documents

এই টুলটি ব্যবহার করে একটিমাত্র ডকুমেন্টের সম্পূর্ণ বিষয়বস্তু অথবা একবারে ২০টি পর্যন্ত ডকুমেন্ট পুনরুদ্ধার করা যায়। search_documents টুলের ফলাফলের parent ফিল্ড থেকে ডকুমেন্টের নামগুলো সংগ্রহ করতে হবে। names প্যারামিটারটিকে ডকুমেন্টের নামগুলোর একটি তালিকা হিসেবে সেট করুন।

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

কার্ল অনুরোধ 
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 tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

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

নথি অনুরোধ পান

JSON উপস্থাপনা 
{
  "names": [
    string
  ]
}
ক্ষেত্র
names[]

string

আবশ্যক। `search_documents` দ্বারা প্রাপ্ত, পুনরুদ্ধার করার জন্য ডকুমেন্টগুলোর নাম। একটি কলে সর্বোচ্চ ২০টি ডকুমেন্ট পুনরুদ্ধার করা যাবে। ডকুমেন্টগুলো অনুরোধে থাকা 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

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

টুল টীকা

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

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

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

ধ্বংসাত্মক ইঙ্গিত: ❌ | স্বকীয় ইঙ্গিত: ✅ | শুধুমাত্র পঠনযোগ্য ইঙ্গিত: ✅ | উন্মুক্ত বিশ্ব ইঙ্গিত: ❌