MCP Tools Reference: paydeveloper.googleapis.com

टूल: search_documentation

यह टूल, Google Pay और Google Wallet के डेवलपर के लिए बने आधिकारिक दस्तावेज़ों और कोड के नमूनों में से, सबसे काम के और अप-टू-डेट सेक्शन खोजकर उन्हें वापस लाता है.

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

कर्ल अनुरोध 
curl --location 'https://paydeveloper.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_documentation",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

इनपुट स्कीमा

दस्तावेज़ खोजने के लिए अनुरोध वाला मैसेज.

SearchDocumentationRequest

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

string

ज़रूरी है. सर्च करने के लिए क्वेरी.
languageCode

string

ज़रूरी नहीं. सर्च क्वेरी का IETF BCP-47 भाषा कोड.

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

दस्तावेज़ खोजने के लिए जवाब वाला मैसेज.

SearchDocumentationResponse

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

object (DocumentChunk)

सर्च क्वेरी से मेल खाने वाले दस्तावेज़ के हिस्से. इन्हें, काम के होने के स्कोर के हिसाब से क्रम में लगाया जाता है. यह स्कोर, उपयोगकर्ता की क्वेरी और हिस्से के कॉन्टेंट के बीच समानता का आकलन करता है.

DocumentChunk

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

string

उस दस्तावेज़ का टाइटल बताता है जिसका यह हिस्सा है.
uri

string

उस दस्तावेज़ का यूआरआई बताता है जिसका यह हिस्सा है.
content

string

इसमें हिस्से का कॉन्टेंट शामिल होता है.

टूल के एनोटेशन

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

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

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

डेटा मिटाने वाला हिंट: ❌ | एक ही आर्ग्युमेंट के साथ टूल को बार-बार कॉल करने पर, उसके एनवायरमेंट पर कोई अतिरिक्त असर नहीं पड़ेगा: ✅ | सिर्फ़ पढ़ने की अनुमति देने वाला हिंट: ✅ | ओपन वर्ल्ड वाला हिंट: ❌