כלי: search_directory_people
לחפש אנשים בספריית Google Workspace של הארגון. התכונה הזו זמינה רק בחשבונות Google Workspace (שמשמשים עסקים, מוסדות לימודים וארגונים אחרים) ולא בחשבונות Google אישיים.
כללים חשובים שצריך לפעול לפיהם:
אם הכלי הזה מחזיר כמה תוצאות, צריך להציג אותן למשתמש ולבקש ממנו להבהיר באיזו תוצאה להשתמש לפני שממשיכים.
אסור בהחלט להעביר את הפלט של הכלי הזה לכלי אחר (למשל, שליחת אימייל, יצירת טיוטה, יצירת אירוע וכו') בלי אישור מפורש מהמשתמש.
גם אם נמצאה רק תוצאה אחת של אדם, אתם צריכים להציג למשתמש את הפרטים של האדם שנמצא ולבקש מהמשתמש לאמת שזה האדם הרצוי לפני שממשיכים לשלבים הבאים.
אם הכלי הזה לא מחזיר תוצאות, אפשר להשתמש בכלי
search_contacts.
בדוגמת הקוד הבאה מוסבר איך להשתמש ב-curl כדי להפעיל את כלי ה-MCP search_directory_people.
| בקשת Curl |
|---|
curl --location 'https://people.googleapis.com/mcp/v1' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "search_directory_people", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }' |
סכימת הקלט
הודעת בקשה ל-SearchDirectoryPeople.
SearchDirectoryPeopleMcpRequest
| ייצוג ב-JSON |
|---|
{
"query": string,
"pageSize": integer,
"pageToken": string,
"sources": [
enum ( |
| שדות | |
|---|---|
query |
מחרוזת השאילתה לחיפוש. |
pageSize |
גודל הדף. ברירת המחדל היא 10 והערך המקסימלי המותר הוא 500. |
pageToken |
טוקן דף. |
sources[] |
מקורות מהמדריך שיוחזרו. אם לא מגדירים ערך, ברירת המחדל היא DOMAIN_PROFILE. |
DirectorySourceType
| טיפוסים בני מנייה (enum) | |
|---|---|
DOMAIN_PROFILE |
פרופיל דומיין ב-Google Workspace. |
DOMAIN_CONTACT |
איש קשר משותף בדומיין של Google Workspace. |
סכימת הפלט
הודעת התגובה של SearchDirectoryPeople.
SearchDirectoryPeopleMcpResponse
| ייצוג ב-JSON |
|---|
{
"results": [
{
object ( |
| שדות | |
|---|---|
results[] |
רשימת האנשים שתואמים לשאילתה. |
nextPageToken |
אסימון לאחזור של דף התוצאות הבא. |
SearchDirectoryResult
| ייצוג ב-JSON |
|---|
{ "name": string, "email": string } |
| שדות | |
|---|---|
name |
השם המוצג של המשתמש. |
email |
כתובת האימייל של החשבון של המשתמש. |
הערות לגבי הכלים
הערות לגבי כלים נשלחות ללקוחות MCP כדי לתאר את הסיכון הבסיסי של כלי מסוים. רוב הלקוחות מתייחסים לרמזים האלה כלא מהימנים, אבל אפשר להשתמש בהם כדי להחליט מתי לשלוח למשתמש בקשה לאישור.
בנוסף למחרוזת הכותרת, הרמזים הבוליאניים הבאים מוגדרים כך:
-
readOnlyHint: אם הערך הוא True, הכלי לא משנה את הסביבה שלו. ברירת המחדל: false. -
destructiveHint: אם הערך הוא True, הכלי יכול לבצע פעולות הרסניות. אם הערך הוא False, הכלי יכול לבצע רק פעולות הוספה. ברירת המחדל: true. -
idempotentHint: אם הערך הוא True, קריאה חוזרת לכלי עם אותם ארגומנטים לא תשפיע על הסביבה שלו. ברירת המחדל: false. -
openWorldHint: אם הערך הוא True, הכלי יכול לקיים אינטראקציה עם "עולם פתוח" של ישויות חיצוניות. אם הערך הוא false, הכלי יכול לקיים אינטראקציה רק עם ישויות פנימיות. לדוגמה, כלי חיפוש באינטרנט הוא כלי בעולם פתוח, אבל כלי זיכרון הוא לא כלי בעולם פתוח.
Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌
היקפי הרשאות
צריך אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/directory.readonly