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/v1' \
--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, כולל.

ConversationType

הגדרה של סוג השיחה.

טיפוסים בני מנייה (enum)
CONVERSATION_TYPE_UNSPECIFIED לא צוין.
NAMED_SPACE מרחב עם שם.
GROUP_CHAT צ'אט קבוצתי בין שלושה אנשים או יותר.
DIRECT_MESSAGE צ'אט ישיר בין שני בני אדם, או בין בן אדם לאפליקציית Chat.

הערות על כלי

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