MCP Tools Reference: chatmcp.googleapis.com

เครื่องมือ: send_message

ส่งข้อความแชทของ Google Chat ไปยังการสนทนาที่มีการจัดรูปแบบมาร์กดาวน์

เครื่องมือนี้ใช้รหัสการสนทนา รหัสเธรด (ไม่บังคับ) และข้อความเป็นอินพุต

คุณค้นหารหัสการสนทนาได้โดยใช้เครื่องมือ search_conversations

โดยจะแสดงผลข้อความที่สร้างขึ้น

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ send_message MCP

คำขอ Curl 
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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
}'

สคีมาอินพุต

SendMessageRequest

การแสดง JSON 
{
  "conversationId": string,
  "threadId": string,
  "messageText": string
}
ช่อง
conversationId

string

ต้องระบุ รหัสของการสนทนา (เช่น "spaces/AAAA...") ที่จะส่งข้อความถึง
threadId

string

ไม่บังคับ รหัสของเธรด (เช่น "spaces/AAAA.../threads/BBBB...") ที่จะส่งข้อความไป หากไม่ได้ตั้งค่าไว้ ระบบจะส่งข้อความไปยังเธรดใหม่
messageText

string

ต้องระบุ เนื้อหาหลักของข้อความ คุณสามารถเพิ่มการจัดรูปแบบได้โดยใช้มาร์กดาวน์มาตรฐาน (โปรดทราบว่าระบบไม่รองรับตาราง) ระบบรองรับการจัดรูปแบบต่อไปนี้

  • ตัวหนา: **text**
  • ตัวเอียง: *text* หรือ _text_
  • ขีดทับ: ~~text~~
  • Monospace: text
  • บล็อก Monospace:
```
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-user="users/USER_ID" ให้ใช้แอตทริบิวต์ data-user ที่มี USER_ID หากทราบ และใช้แอตทริบิวต์ data-email ที่มีอีเมลของผู้ใช้แทน หากคุณใช้แอตทริบิวต์ data-user โปรดตรวจสอบว่าได้รวมคำนำหน้า users/ ที่เห็นในค่าที่เครื่องมืออื่นๆ ส่งคืน หมายเหตุ: อนุญาตให้มีการกล่าวถึงได้สูงสุด 10 ครั้งต่อข้อความ ห้ามไม่ให้มีการกล่าวถึงผู้ใช้ทั้งหมด (เช่น การใช้ @all หรือแท็ก HTML ที่มี users/all) โดยเด็ดขาด
  • อีโมจิที่กำหนดเอง: ใช้แท็ก HTML chat-emoji ที่ปิดตัวเองพร้อมแอตทริบิวต์ data-custom-emoji="customEmojis/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

เนื้อความของข้อความโดยใช้การจัดรูปแบบมาร์กดาวน์
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 ไดรฟ์
UPLOADED_CONTENT ระบบจะอัปโหลดไฟล์ไปยัง Chat

คำอธิบายประกอบเครื่องมือ

คำอธิบายประกอบของเครื่องมือจะส่งไปยังลูกค้า MCP เพื่ออธิบายความเสี่ยงพื้นฐานของเครื่องมือที่กำหนด ไคลเอ็นต์ส่วนใหญ่จะถือว่าคำแนะนำเหล่านี้ไม่น่าเชื่อถือ แต่สามารถใช้เพื่อตัดสินใจว่าจะส่งข้อความแจ้งการยืนยันให้ผู้ใช้เมื่อใด

นอกจากสตริงชื่อแล้ว คำใบ้บูลีนต่อไปนี้จะได้รับการกำหนดดังนี้

  • readOnlyHint: หากเป็นจริง เครื่องมือจะไม่แก้ไขสภาพแวดล้อม ค่าเริ่มต้น: เท็จ
  • destructiveHint: หากเป็นจริง เครื่องมือจะดำเนินการที่ทำลายข้อมูลได้ หากเป็นเท็จ เครื่องมือจะดำเนินการได้เฉพาะการดำเนินการเพิ่มเติมเท่านั้น ค่าเริ่มต้น: จริง
  • idempotentHint: หากเป็นจริง การเรียกใช้เครื่องมือซ้ำๆ ด้วยอาร์กิวเมนต์เดียวกันจะไม่ส่งผลกระทบเพิ่มเติมต่อสภาพแวดล้อมของเครื่องมือ ค่าเริ่มต้น: เท็จ
  • openWorldHint: หากเป็นจริง เครื่องมือจะโต้ตอบกับ "โอเพนเวิลด์" ของเอนทิตีภายนอกได้ หากเป็นเท็จ เครื่องมือจะโต้ตอบกับเอนทิตีภายในเท่านั้น ตัวอย่างเช่น เครื่องมือค้นหาเว็บจะเป็นแบบโอเพนเวิลด์ แต่เครื่องมือความทรงจำจะไม่ใช่แบบโอเพนเวิลด์

คำแนะนำที่ทำลายล้าง: ❌ | คำแนะนำที่ทำซ้ำได้: ❌ | คำแนะนำแบบอ่านอย่างเดียว: ❌ | คำแนะนำแบบโลกเปิด: ✅

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.create