MCP Tools Reference: developerknowledge.googleapis.com

टूल: search_documents

Google Developers प्रॉडक्ट के बारे में दस्तावेज़ ढूंढने के लिए, इस टूल का इस्तेमाल करें. इन दस्तावेज़ों में आधिकारिक एपीआई, कोड स्निपेट, प्रॉडक्ट की जानकारी, सबसे सही तरीके, गाइड, डीबग की जानकारी वगैरह शामिल होती है. इसमें ये प्रॉडक्ट और डोमेन शामिल हैं:

  • ADK: adk.dev

  • Android: developer.android.com

  • Apigee: docs.apigee.com

  • Chrome: developer.chrome.com

  • Dart: dart.dev

  • Firebase: firebase.google.com

  • Flutter: docs.flutter.dev

  • Fuchsia: fuchsia.dev

  • Gemini CLI: geminicli.com

  • Genkit: genkit.dev

  • Go: go.dev

  • Google AI: ai.google.dev

  • Google Antigravity: antigravity.google

  • Google Cloud: cloud.google.com और docs.cloud.google.com

  • Google Developers, Ads, Search, Google Maps, YouTube: developers.google.com

  • Google Home: developers.home.google.com

  • Google Maps Platform: mapsplatform.google.com

  • Google Workspace: knowledge.workspace.google.com

  • TensorFlow: www.tensorflow.org

  • वेब: web.dev

यह टूल, मैच होने वाले दस्तावेज़ों के लिए टेक्स्ट, नाम, और यूआरआई के चंक दिखाता है. जब आपको सटीक कोड सैंपल, सीएलआई फ़्लैग, गड़बड़ी के खास मैसेज, ट्यूटोरियल के बारे में पूरी जानकारी या डिटरमिनिस्टिक कीवर्ड लुकअप की ज़रूरत हो, तो search_documents के बाद get_documents को प्राथमिकता दें. अगर मिले चंक में उपयोगकर्ता के सवाल का जवाब देने के लिए ज़रूरी जानकारी नहीं है, तो पूरे दस्तावेज़ का कॉन्टेंट पाने के लिए, इस टूल के आउटपुट से parent के साथ get_documents का इस्तेमाल करें. उपयोगकर्ता को जवाब देते समय, हमेशा भरोसेमंद सोर्स दस्तावेज़ के संसाधन के नाम (documents/...) या यूआरआई का हवाला दें.

यहां दिए गए कोड सैंपल में, curl का इस्तेमाल करके search_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": "search_documents",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

इनपुट स्कीमा

search_documents के लिए स्कीमा का अनुरोध करें. Google डेवलपर के दस्तावेज़ खोजने के लिए, query फ़ील्ड का इस्तेमाल करें.

SearchDocumentChunksRequest

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

string

ज़रूरी है. उपयोगकर्ता की ओर से दी गई रॉ क्वेरी स्ट्रिंग, जैसे कि "Cloud Storage बकेट कैसे बनाएं?".

आउटपुट स्कीमा

search_documents के लिए रिस्पॉन्स स्कीमा.

SearchDocumentChunksResponse

JSON के काेड में दिखाना 
{
  "results": [
    {
      object (DocumentChunk)
    }
  ]
}
फ़ील्ड
results[]

object (DocumentChunk)

दी गई क्वेरी के लिए खोज के नतीजे. इस सूची में मौजूद हर DocumentChunk में, खोज क्वेरी से जुड़े कॉन्टेंट का स्निपेट होता है. पूरे दस्तावेज़ का कॉन्टेंट वापस पाने के लिए, get_documents के साथ हर नतीजे के DocumentChunk.parent फ़ील्ड का इस्तेमाल करें.

DocumentChunk

JSON के काेड में दिखाना 
{
  "parent": string,
  "id": string,
  "content": string
}
फ़ील्ड
parent

string

सिर्फ़ आउटपुट के लिए. उस दस्तावेज़ के संसाधन का नाम जिससे यह चंक लिया गया है. फ़ॉर्मैट: documents/{uri_without_scheme} उदाहरण: documents/docs.cloud.google.com/storage/docs/creating-buckets
id

string

सिर्फ़ आउटपुट के लिए. दस्तावेज़ में मौजूद इस चंक का आईडी. चंक आईडी, किसी दस्तावेज़ में यूनीक होता है. हालांकि, यह सभी दस्तावेज़ों में यूनीक नहीं होता. चंक आईडी स्थिर नहीं होता है और समय के साथ बदल सकता है.
content

string

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

टूल एनोटेशन

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

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

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

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