MCP Tools Reference: developerknowledge.googleapis.com

टूल: get_documents

इस टूल का इस्तेमाल करके, किसी एक दस्तावेज़ का पूरा कॉन्टेंट या एक बार में ज़्यादा से ज़्यादा 20 दस्तावेज़ों का कॉन्टेंट वापस पाया जा सकता है. search_documents टूल को कॉल करने पर मिलने वाले नतीजों के parent फ़ील्ड से, दस्तावेज़ों के नाम हासिल किए जाने चाहिए. names पैरामीटर को, दस्तावेज़ों के नामों की सूची पर सेट करें.

यहां दिए गए कोड के नमूने में, 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 tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

इनपुट स्कीमा

get_documents के लिए अनुरोध स्कीमा.

GetDocumentsRequest

JSON के काेड में दिखाना 
{
  "names": [
    string
  ]
}
फ़ील्ड
names[]

string

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

डेटा मिटाने वाला हिंट: ❌ | आइडेमपोटेंट हिंट: ✅ | सिर्फ़ पढ़ने की अनुमति देने वाला हिंट: ✅ | ओपन वर्ल्ड हिंट: ❌