MCP Tools Reference: chatmcp.googleapis.com

ابزار: send_message

یک پیام گوگل چت به یک مکالمه ارسال می‌کند.

این ابزار از یک شناسه مکالمه، یک شناسه رشته (که اختیاری است) و یک متن پیام به عنوان ورودی استفاده می‌کند. شناسه‌های مکالمه را می‌توان با استفاده از ابزار search_conversations پیدا کرد. این ابزار پیام ایجاد شده را برمی‌گرداند.

نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار send_message MCP را نشان می‌دهد.

درخواست کرل 
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
}'

طرحواره ورودی

درخواست ارسال پیام به مکالمه گوگل چت.

ارسال درخواست پیام

نمایش JSON 
{
  "conversationId": string,
  "threadId": string,
  "messageText": string
}
فیلدها
conversationId

string

الزامی. شناسه مکالمه (مثلاً 'فاصله/AAAA...') برای ارسال پیام.

threadId

string

اختیاری. شناسه‌ی رشته (مثلاً 'spaces/AAAA.../threads/BBBB...') که پیام به آن ارسال می‌شود. اگر تنظیم نشود، پیام به یک رشته‌ی جدید ارسال خواهد شد.

messageText

string

الزامی. محتوای اصلی پیام. قالب‌بندی اولیه را می‌توان با استفاده از زیرمجموعه‌ای از Markdown اضافه کرد. برای اطلاعات در مورد نحوه قالب‌بندی پیام‌ها، به بخش قالب‌بندی پیام‌ها مراجعه کنید. قالب‌بندی زیر پشتیبانی می‌شود:

  • پررنگ: *text*
  • ایتالیک: _text_
  • خط خورده: ~text~
  • تک‌فاصله: text
  • بلوک تک‌فضا: 
```
line 1
line 2
```
  • لیست گلوله‌ای: 
* item 1
* item 2
  • نقل قول بلوک: > quoted text
  • پیوند: <url|display text>
  • کاربر را ذکر کنید: <users/{user_id}>

طرحواره خروجی

پاسخ به ارسال پیام به مکالمه گوگل چت.

ارسال پیامپاسخ

نمایش JSON 
{
  "message": {
    object (ChatMessage)
  }
}
فیلدها
message

object ( 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

رشته‌ای که این پیام به آن تعلق دارد. اگر پیام رشته‌بندی نشده باشد، این قسمت خالی خواهد بود. قالب: space/{space}/threads/{thread}

plaintextBody

string

متن ساده‌ی پیام.

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

نام منبع یک کاربر چت. فرمت: users/{user}.

displayName

string

نام نمایشی کاربر چت.

email

string

آدرس ایمیل کاربر. این فیلد فقط زمانی پر می‌شود که نوع کاربر HUMAN باشد.

userType

enum ( UserType )

نوع کاربر.

فراداده پیوست چت

نمایش JSON 
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
فیلدها
attachmentId

string

نام منبع پیوست. قالب: space/{space}/messages/{message}/attachments/{attachment}.

filename

string

نام فایل پیوست.

mimeType

string

نوع محتوا (نوع MIME).

source

enum ( Source )

منبع پیوست.

خلاصه واکنش

نمایش JSON 
{
  "emoji": string,
  "count": integer
}
فیلدها
emoji

string

رشته یونیکد ایموجی یا نام ایموجی سفارشی.

count

integer

تعداد کل واکنش‌ها با استفاده از ایموجی مرتبط.

نوع کاربر

نوع کاربر گوگل چت.

انوم‌ها
USER_TYPE_UNSPECIFIED نامشخص.
HUMAN کاربر انسانی.
APP کاربر برنامه.

منبع

منبع پیوست.

انوم‌ها
SOURCE_UNSPECIFIED رزرو شده.
DRIVE_FILE فایل، فایل گوگل درایو است.
UPLOADED_CONTENT فایل در چت آپلود شد.

حاشیه‌نویسی ابزار

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ❌ | راهنمایی فقط خواندنی: ❌ | راهنمایی جهان باز: ✅