MCP Tools Reference: people.googleapis.com

टूल: search_contacts

उपयोगकर्ता के संपर्कों को खोजें.

ज़रूरी नियम:

  • अगर इस टूल से एक से ज़्यादा नतीजे मिलते हैं, तो आपको उपयोगकर्ता को नतीजे दिखाने चाहिए. साथ ही, उससे यह भी पूछना चाहिए कि आगे बढ़ने से पहले, उसे कौनसे नतीजे इस्तेमाल करने हैं.

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

  • अगर खोज में सिर्फ़ एक व्यक्ति की जानकारी मिलती है, तब भी आपको उपयोगकर्ता को उस व्यक्ति की जानकारी दिखानी होगी. साथ ही, उससे यह भी पूछना होगा कि आगे बढ़ने से पहले, वह पुष्टि करे कि यह वही व्यक्ति है जिसकी जानकारी चाहिए.

यहां दिए गए उदाहरण में, search_contacts MCP टूल को शुरू करने के लिए, curl का इस्तेमाल करने का तरीका बताया गया है.

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

इनपुट स्कीमा

SearchContacts के लिए अनुरोध मैसेज.

SearchContactsMcpRequest

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

string

खोजने के लिए क्वेरी स्ट्रिंग.
maxResults

integer

नतीजों की ज़्यादा से ज़्यादा संख्या. डिफ़ॉल्ट रूप से, यह संख्या 10 होती है. इसकी ज़्यादा से ज़्यादा वैल्यू 30 हो सकती है.

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

SearchContacts के लिए जवाब का मैसेज.

SearchContactsMcpResponse

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

object (SearchContactsResult)

क्वेरी से मेल खाने वाले संपर्कों की सूची.

SearchContactsResult

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

string

संपर्क का डिसप्ले नेम.
email

string

संपर्क के खाते का ईमेल पता.

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

डिस्ट्रक्टिव हिंट: ❌ | आइडंपोटेंट हिंट: ✅ | रीड-ओनली हिंट: ✅ | ओपन वर्ल्ड हिंट: ❌