MCP Tools Reference: chatmcp.googleapis.com

כלי: search_conversations

חיפוש שיחות ב-Google Chat לפי השם המוצג.

אם מספקים רק משתתפים, הכלי הזה מוצא שיחות ישירות אחד על אחד (אם מספקים משתתף אחד) או צ'אטים קבוצתיים (אם מספקים כמה משתתפים) שכוללים את המשתתפים שצוינו ואת המשתמש שמתקשר.

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

אם מספקים גם את המשתתפים וגם את השאילתה, הכלי מוצא שיחות לפי המשתתפים ואז מסנן אותן לפי השם המוצג.

אם לא מספקים את המשתתפים ולא את השאילתה, הכלי הזה מציג רשימה של כל השיחות שהמשתמש שמתקשר הוא חלק מהן.

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

חשוב: אם רשימת השיחות ריקה, זה לא אומר שאין עוד תוצאות. אם קיים הערך next_page_token, אפשר לאחזר דפים נוספים. אם מקבלים רשימה ריקה אבל next_page_token, שואלים את המשתמש אם להמשיך בחיפוש.

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

בקשת Curl 
curl --location 'https://chatmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_conversations",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת קלט

הודעת בקשה ל-RPC של FindConversations.

SearchConversationsRequest

ייצוג JSON 
{
  "spaceNameQuery": string,
  "pageSize": integer,
  "pageToken": string,
  "participants": [
    string
  ]
}
שדות
spaceNameQuery

string

אופציונלי. הטקסט לחיפוש בשמות המוצגים של המרחבים.
pageSize

integer

אופציונלי. המספר המקסימלי של מרחבים שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא מציינים ערך, המערכת תחזיר עד 100 מקומות. הערך המקסימלי הוא 1,000. ערכים גבוהים יותר יומרו ל-1,000.
pageToken

string

אופציונלי. טוקן של דף שהתקבל מקריאה קודמת של search_conversations. צריך להזין את הטוקן כדי לאחזר את הדף הבא.
participants[]

string

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

סכימת פלט

הודעת התגובה ל-RPC של FindConversations.

SearchConversationsResponse

ייצוג JSON 
{
  "conversations": [
    {
      object (Conversation)
    }
  ],
  "nextPageToken": string
}
שדות
conversations[]

object (Conversation)

רשימה של אובייקטים של שיחות שתואמים לקריטריונים לחיפוש.
nextPageToken

string

טוקן שאפשר לשלוח כ-page_token כדי לאחזר את הדף הבא. אם משמיטים את השדה הזה, לא יופיעו דפים נוספים.

שיחה

ייצוג JSON 
{
  "conversationId": string,
  "displayName": string,
  "conversationType": enum (ConversationType),
  "lastActiveTimestamp": string
}
שדות
conversationId

string

המזהה של השיחה (למשל, spaces/AAAAAAAAA).
displayName

string

השם המוצג של השיחה.
conversationType

enum (ConversationType)

סוג השיחה (DIRECT_MESSAGE,‏ GROUP_CHAT או NAMED_SPACE).
lastActiveTimestamp

string (Timestamp format)

השעה האחרונה שבה הייתה פעילות בשיחה בפורמט ISO 8601.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

חותמת זמן

ייצוג JSON 
{
  "seconds": string,
  "nanos": integer
}
שדות
seconds

string (int64 format)

מייצג את השניות של זמן UTC מאז ראשית זמן יוניקס (Unix epoch) ב-1970-01-01T00:00:00Z. הערך חייב להיות בין ‎-62135596800 ל-253402300799, כולל (שמתאים לטווח 0001-01-01T00:00:00Z עד 9999-12-31T23:59:59Z).
nanos

integer

שברים לא שליליים של שנייה ברזולוציית ננו-שנייה. השדה הזה מייצג את החלק של משך הזמן בננו-שניות, ולא מהווה חלופה לשניות. ערכי שניות שליליים עם שברים עדיין צריכים לכלול ערכי ננו-שניות לא שליליים שסופרים קדימה בזמן. הערך חייב להיות בין 0 ל-999,999,999, כולל.

הערות על כלי

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