MCP Tools Reference: developerknowledge.googleapis.com

टूल: get_documents

इस टूल का इस्तेमाल करके, एक कॉल में किसी एक दस्तावेज़ या ज़्यादा से ज़्यादा 20 दस्तावेज़ों का पूरा कॉन्टेंट वापस पाया जा सकता है. दस्तावेज़ों के नाम, search_documents टूल को कॉल करने से मिले नतीजों के parent फ़ील्ड या answer_query टूल से मिले references फ़ील्ड से मिलने चाहिए. names पैरामीटर को दस्तावेज़ के नामों (documents/...) की सूची पर सेट करें. साथ ही, अपने जवाब में इस्तेमाल किए गए आधिकारिक सोर्स दस्तावेज़ों का हवाला दें.

यहां दिए गए कोड सैंपल में, curl का इस्तेमाल करके get_documents एमसीपी टूल को कॉल करने का तरीका बताया गया है.

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 फ़ील्ड से मिलते हैं. एक कॉल में ज़्यादा से ज़्यादा 20 दस्तावेज़ों को वापस लाया जा सकता है. दस्तावेज़ उसी क्रम में दिखाए जाते हैं जिस क्रम में अनुरोध में 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

सिर्फ़ आउटपुट के लिए. कॉन्टेंट का यूआरआई, जैसे कि https://cloud.google.com/storage/docs/creating-buckets.
content

string

सिर्फ़ आउटपुट के लिए. Markdown फ़ॉर्मैट में दस्तावेज़ का कॉन्टेंट.
description

string

सिर्फ़ आउटपुट के लिए. दस्तावेज़ का ब्यौरा.
title

string

सिर्फ़ आउटपुट के लिए. दस्तावेज़ का टाइटल.

टूल एनोटेशन

टूल के एनोटेशन, एमसीपी क्लाइंट को भेजे जाते हैं. इससे किसी टूल से जुड़े बुनियादी जोखिम के बारे में जानकारी मिलती है. ज़्यादातर क्लाइंट इन हिंट को भरोसेमंद नहीं मानते. हालांकि, इनका इस्तेमाल यह तय करने के लिए किया जा सकता है कि उपयोगकर्ता को पुष्टि करने का प्रॉम्प्ट कब भेजा जाए.

टाइटल स्ट्रिंग के साथ-साथ, बूलियन हिंट के बारे में यहां बताया गया है:

  • readOnlyHint: अगर इसकी वैल्यू true है, तो टूल अपने एनवायरमेंट में बदलाव नहीं करता. डिफ़ॉल्ट: false.
  • destructiveHint: अगर इसकी वैल्यू true है, तो टूल नुकसान पहुंचाने वाली कार्रवाइयां कर सकता है. अगर यह वैल्यू false पर सेट है, तो टूल सिर्फ़ जोड़ने वाली कार्रवाइयां कर सकता है. डिफ़ॉल्ट: true.
  • idempotentHint: अगर यह वैल्यू true पर सेट है, तो टूल को एक ही आर्ग्युमेंट के साथ बार-बार कॉल करने पर, उसके एनवायरमेंट पर कोई और असर नहीं पड़ेगा. डिफ़ॉल्ट: false.
  • openWorldHint: सही होने पर, टूल बाहरी इकाइयों की 'विशाल दुनिया' के साथ इंटरैक्ट कर सकता है. अगर यह वैल्यू false है, तो टूल सिर्फ़ इंटरनल इकाइयों के साथ इंटरैक्ट कर सकता है. उदाहरण के लिए, वेब सर्च टूल ओपन वर्ल्ड होगा, जबकि मेमोरी टूल ओपन वर्ल्ड नहीं होगा.

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