MCP Tools Reference: people.googleapis.com

الأداة: search_contacts

البحث في جهات اتصال المستخدم

قواعد مهمة يجب اتّباعها:

  • إذا عرضت هذه الأداة نتائج متعددة، عليك عرض النتائج للمستخدم وطلب توضيح بشأن النتيجة التي يجب استخدامها قبل المتابعة.

  • يُحظر تمامًا نقل نتائج هذه الأداة إلى أداة أخرى (مثل إرسال رسالة إلكترونية أو إنشاء مسودة أو إنشاء حدث أو غير ذلك) بدون تأكيد صريح من المستخدم.

  • حتى إذا تم العثور على نتيجة واحدة فقط لشخص، عليك عرض تفاصيل الشخص الذي تم العثور عليه للمستخدم ومطالبته بالتأكّد من أنّ هذا هو الشخص المقصود قبل المتابعة إلى الخطوات التالية.

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة search_contacts MCP.

طلب 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

عنوان البريد الإلكتروني لحساب جهة الاتصال

التعليقات التوضيحية للأدوات

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