MCP Tools Reference: chatmcp.googleapis.com

כלי: send_message

שליחת הודעה ב-Google Chat לשיחה עם עיצוב Markdown.

הכלי הזה משתמש במזהה שיחה, במזהה אשכול אופציונלי ובטקסט של ההודעה כמקורות קלט. אפשר למצוא את מזהי השיחות באמצעות הכלי search_conversations. הפונקציה מחזירה את ההודעה שנוצרה.

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

בקשת 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": "send_message",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

שליחת בקשה לשליחת הודעה בשיחה ב-Google Chat.

SendMessageRequest

ייצוג JSON 
{
  "conversationId": string,
  "threadId": string,
  "messageText": string
}
שדות
conversationId

string

חובה. המזהה של השיחה (לדוגמה, 'spaces/AAAA...‎') שאליה רוצים לשלוח את ההודעה.
threadId

string

אופציונלי. המזהה של השרשור (לדוגמה, 'spaces/AAAA.../threads/BBBB...‎') שאליו רוצים לשלוח את ההודעה. אם לא מגדירים את האפשרות הזו, ההודעה תישלח לשרשור חדש.
messageText

string

חובה. התוכן העיקרי של ההודעה. אפשר להוסיף עיצוב באמצעות Markdown רגיל (שימו לב שאין תמיכה בטבלאות). הפורמטים הבאים נתמכים:

  • מודגש: **text**
  • נטוי: *text* או _text_
  • קו חוצה: ~~text~~
  • Monospace: text
  • בלוק ברוחב קבוע:
```
line 1
line 2
```
  • רשימה עם תבליטים:
* item 1
* item 2
  • רשימה ממוספרת:
1. item 1
2. item 2
  • ציטוט בלוק: > quoted text
  • היפר-קישור: [label](url)
  • אזכור משתמש: משתמשים בתג HTML שנסגר מעצמו chat-user עם המאפיינים data-email="user@example.com" או data-name="USER_ID". מומלץ להשתמש במאפיין data-name עם USER_ID אם הוא ידוע, ואם לא, להשתמש במאפיין data-email עם כתובת האימייל של המשתמש. אם משתמשים במאפיין data-name, חשוב להשתמש ב-USER_ID המספרי הגולמי ולא לכלול את הקידומת users/ שמופיעה בערכי ההחזרה של כלים אחרים. הערה: אפשר לתייג עד 10 אנשים בהודעה. אסור בתכלית האיסור לתייג את כל המשתמשים (למשל, באמצעות @all או תג HTML עם users/all).
  • אמוג'י מותאם אישית: משתמשים בתג HTML שנסגר מעצמו chat-custom-emoji עם המאפיינים data-uid="abc" ו-data-emoji-name=":xyz:".

סכימת הפלט

תשובה לשליחת הודעה לשיחה ב-Google Chat.

SendMessageResponse

ייצוג JSON 
{
  "message": {
    object (ChatMessage)
  }
}
שדות
message

object (ChatMessage)

ההודעה שנשלחה.

ChatMessage

ייצוג JSON 
{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ]
}
שדות
messageId

string

שם המשאב של ההודעה. פורמט: spaces/{space}/messages/{message}
threadId

string

השרשור שההודעה שייכת אליו. השדה הזה יהיה ריק אם ההודעה לא שייכת לשרשור. פורמט: spaces/{space}/threads/{thread}
plaintextBody

string

גוף ההודעה בפורמט Markdown.
sender

object (User)

השולח של ההודעה.
createTime

string

פלט בלבד. חותמת זמן של מועד יצירת ההודעה.
threadedReply

boolean

האם ההודעה היא תשובה בשרשור.
attachments[]

object (ChatAttachmentMetadata)

קבצים מצורפים שכלולים בהודעה.
reactionSummaries[]

object (ReactionSummary)

סיכום התגובות באמוג'י שמופיע בהודעה.

משתמש

ייצוג JSON 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
שדות
userId

string

שם המשאב של משתמש ב-Chat. פורמט: users/{user}.
displayName

string

השם המוצג של המשתמש ב-Chat.
email

string

כתובת האימייל של המשתמש. השדה הזה מאוכלס רק כשסוג המשתמש הוא HUMAN.
userType

enum (UserType)

סוג המשתמש.

ChatAttachmentMetadata

ייצוג JSON 
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
שדות
attachmentId

string

שם המשאב של הקובץ המצורף. פורמט: spaces/{space}/messages/{message}/attachments/{attachment}.
filename

string

שם הקובץ המצורף.
mimeType

string

סוג התוכן (סוג MIME).
source

enum (Source)

המקור של הקובץ המצורף.

ReactionSummary

ייצוג JSON 
{
  "emoji": string,
  "count": integer
}
שדות
emoji

string

מחרוזת ה-Unicode של האמוג'י או שם האמוג'י בהתאמה אישית.
count

integer

המספר הכולל של התגובות באמוג'י המשויך.

UserType

הסוג של משתמש Google Chat.

טיפוסים בני מנייה (enum)
USER_TYPE_UNSPECIFIED לא צוין.
HUMAN משתמש אנושי.
APP משתמש באפליקציה.

מקור

המקור של הקובץ המצורף.

טיפוסים בני מנייה (enum)
SOURCE_UNSPECIFIED שמורות.
DRIVE_FILE הקובץ הוא קובץ Google Drive.
UPLOADED_CONTENT הקובץ יועלה ל-Chat.

הערות על כלים

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