MCP Tools Reference: people.googleapis.com

כלי: search_contacts

חיפוש אנשי הקשר של משתמש.

כללים חשובים:

  • אם הכלי הזה מחזיר כמה תוצאות, צריך להציג את התוצאות למשתמש ולבקש ממנו הבהרה לגבי התוצאה שבה רוצים להשתמש לפני שממשיכים.

  • חל איסור מוחלט להעביר את הפלט של הכלי הזה לכלי אחר (למשל, שליחת אימייל, יצירת טיוטה, יצירת אירוע וכו') ללא אישור מפורש מהמשתמש.

  • גם אם נמצאה רק תוצאה אחת של אדם, אתם צריכים להציג למשתמש את הפרטים של האדם שנמצא ולבקש ממנו לאמת שאכן מדובר באדם הרצוי לפני שתמשיכו לשלבים הבאים.

בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להפעיל את כלי ה-MCP‏ search_contacts.

בקשת 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

כתובת האימייל בחשבון של איש הקשר.

הערות על כלי

רמז הרסני: ❌ | רמז אידמפוטנטי: ✅ | רמז לקריאה בלבד: ✅ | רמז לעולם פתוח: ❌