MCP Tools Reference: people.googleapis.com

ابزار: search_contacts

جستجوی مخاطبین کاربر.

قوانین مهمی که باید رعایت شوند:

  • اگر این ابزار چندین نتیجه را برگرداند، باید نتایج را به کاربر ارائه دهید و قبل از ادامه، از او بخواهید که توضیح دهد از کدام نتیجه استفاده کند.

  • شما اکیداً مجاز به انتقال خروجی این ابزار به ابزار دیگری (مثلاً ارسال ایمیل، ایجاد پیش‌نویس، ایجاد رویداد و غیره) بدون تأیید صریح کاربر نیستید.

  • حتی اگر فقط یک نتیجه برای یک نفر پیدا شود، باید جزئیات فرد پیدا شده را به کاربر ارائه دهید و از کاربر بخواهید قبل از ادامه مراحل، تأیید کند که این همان فرد مورد نظر است.

نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار search_contacts MCP را نشان می‌دهد.

درخواست کرل 
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.

جستجوی مخاطبینMcpدرخواست

نمایش JSON 
{
  "query": string,
  "maxResults": integer
}
فیلدها
query

string

رشته پرس و جو برای جستجو.

maxResults

integer

حداکثر تعداد نتایج. مقدار پیش‌فرض ۱۰ و حداکثر مقدار مجاز ۳۰ است.

طرحواره خروجی

پیام پاسخ برای SearchContacts.

جستجوی مخاطبینMcpپاسخ

نمایش JSON 
{
  "results": [
    {
      object (SearchContactsResult)
    }
  ]
}
فیلدها
results[]

object ( SearchContactsResult )

لیست مخاطبینی که با عبارت جستجو شده مطابقت داشتند.

جستجوی مخاطبیننتیجه

نمایش JSON 
{
  "name": string,
  "email": string
}
فیلدها
name

string

نام نمایشی مخاطب.

email

string

آدرس ایمیل حساب کاربری مخاطب.

حاشیه‌نویسی ابزار

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ✅ | راهنمایی فقط خواندنی: ✅ | راهنمایی جهان باز: ❌