MCP Tools Reference: chatmcp.googleapis.com

Công cụ: send_message

Gửi tin nhắn Google Chat đến một cuộc trò chuyện.

Công cụ này sử dụng mã nhận dạng cuộc trò chuyện, mã nhận dạng luồng không bắt buộc và văn bản tin nhắn làm dữ liệu đầu vào. Bạn có thể tìm thấy mã nhận dạng cuộc trò chuyện bằng công cụ search_conversations. Phương thức này trả về thông báo đã tạo.

Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ send_message MCP.

Yêu cầu 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
}'

Giản đồ đầu vào

Yêu cầu gửi tin nhắn đến một cuộc trò chuyện trên Google Chat.

SendMessageRequest

Biểu diễn dưới dạng JSON 
{
  "conversationId": string,
  "threadId": string,
  "messageText": string
}
Trường
conversationId

string

Bắt buộc. Mã nhận dạng của cuộc trò chuyện (ví dụ: "spaces/AAAA...") để gửi tin nhắn đến.
threadId

string

Không bắt buộc. Mã nhận dạng của chuỗi (ví dụ: "spaces/AAAA.../threads/BBBB...") để gửi tin nhắn đến. Nếu bạn không đặt giá trị này, thì thông báo sẽ được gửi đến một luồng mới.
messageText

string

Bắt buộc. Nội dung chính của thông báo. Bạn có thể thêm định dạng cơ bản bằng cách sử dụng một phần của Markdown. Để biết thông tin về cách định dạng thông báo, hãy xem bài viết Định dạng thông báo. Chúng tôi hỗ trợ các định dạng sau:

  • In đậm: *text*
  • In nghiêng: _text_
  • Gạch ngang chữ: ~text~
  • Monospace: text
  • Khối đơn cách:
```
line 1
line 2
```
  • Danh sách có dấu đầu dòng:
* item 1
* item 2
  • Khối trích dẫn: > quoted text
  • Siêu liên kết: <url|display text>
  • Đề cập đến người dùng: <users/{user_id}>

Giản đồ đầu ra

Phản hồi khi gửi tin nhắn đến một cuộc trò chuyện trên Google Chat.

SendMessageResponse

Biểu diễn dưới dạng JSON 
{
  "message": {
    object (ChatMessage)
  }
}
Trường
message

object (ChatMessage)

Tin nhắn đã được gửi.

ChatMessage

Biểu diễn dưới dạng JSON 
{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ]
}
Trường
messageId

string

Tên tài nguyên của thông báo. Định dạng spaces/{space}/messages/{message}
threadId

string

Chuỗi thư mà thư này thuộc về. Khoá này sẽ trống nếu tin nhắn không được phân luồng. Định dạng: spaces/{space}/threads/{thread}
plaintextBody

string

Nội dung văn bản thuần tuý của thư.
sender

object (User)

Người gửi tin nhắn.
createTime

string

Chỉ có đầu ra. Dấu thời gian cho biết thời điểm tạo thông báo.
threadedReply

boolean

Tin nhắn có phải là tin nhắn trả lời trong một chuỗi hay không.
attachments[]

object (ChatAttachmentMetadata)

Tệp đính kèm có trong thư.
reactionSummaries[]

object (ReactionSummary)

Bản tóm tắt về các lượt thể hiện cảm xúc bằng biểu tượng trong thư.

Người dùng

Biểu diễn dưới dạng JSON 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
Trường
userId

string

Tên tài nguyên của một người dùng Chat. Định dạng: users/{user}.
displayName

string

Tên hiển thị của người dùng Chat.
email

string

Địa chỉ email của người dùng. Trường này chỉ được điền sẵn khi loại người dùng là HUMAN.
userType

enum (UserType)

Loại người dùng.

ChatAttachmentMetadata

Biểu diễn dưới dạng JSON 
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
Trường
attachmentId

string

Tên tài nguyên của tệp đính kèm. Định dạng: spaces/{space}/messages/{message}/attachments/{attachment}.
filename

string

Tên của tệp đính kèm.
mimeType

string

Loại nội dung (loại MIME).
source

enum (Source)

Nguồn của tệp đính kèm.

ReactionSummary

Biểu diễn dưới dạng JSON 
{
  "emoji": string,
  "count": integer
}
Trường
emoji

string

Chuỗi unicode biểu tượng cảm xúc hoặc tên biểu tượng cảm xúc tuỳ chỉnh.
count

integer

Tổng số lượt thể hiện cảm xúc bằng biểu tượng cảm xúc liên quan.

UserType

Loại người dùng Google Chat.

Enum
USER_TYPE_UNSPECIFIED Không xác định.
HUMAN Người dùng thực.
APP Người dùng ứng dụng.

Nguồn

Nguồn của tệp đính kèm.

Enum
SOURCE_UNSPECIFIED Đã đặt trước.
DRIVE_FILE Tệp này là tệp trên Google Drive.
UPLOADED_CONTENT Tệp sẽ được tải lên Chat.

Chú giải công cụ

Gợi ý mang tính huỷ diệt: ❌ | Gợi ý mang tính luỹ đẳng: ❌ | Gợi ý chỉ đọc: ❌ | Gợi ý về thế giới mở: ✅