MCP Tools Reference: chatmcp.googleapis.com

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

ค้นหาข้อความ Google Chat โดยใช้คีย์เวิร์ดและตัวกรองที่แสดงข้อความในรูปแบบมาร์กดาวน์ ทำงานในทุกพื้นที่ที่ผู้ใช้มีสิทธิ์เข้าถึง หรือกำหนดขอบเขตให้เฉพาะการสนทนาที่เจาะจงได้

โปรดปฏิบัติตามคำแนะนำนี้เมื่อตัดสินใจว่าจะใช้ search_messages หรือเครื่องมือค้นหาหรืออ่านอื่นๆ

• ใช้ search_messages เมื่อต้องการค้นหาเนื้อหาข้อความ คีย์เวิร์ด การกล่าวถึง ลิงก์ ผู้ส่ง หรือข้อความที่ยังไม่ได้อ่านที่อาจอยู่ในพื้นที่ทำงานหลายแห่งหรือไม่มีรหัสการสนทนาที่ทราบ
• ใช้ list_messages เมื่อทราบรหัสพื้นที่หรือเธรดที่เฉพาะเจาะจงและต้องการอ่านข้อความตามลำดับตามลำดับเวลา
• ใช้ search_conversations เพื่อค้นหาข้อมูลเมตาของพื้นที่ทำงาน เช่น รหัสการสนทนาตามชื่อที่แสดงของพื้นที่ทำงานหรือผู้เข้าร่วม (ระบบจะค้นหาเฉพาะข้อมูลเมตา ไม่ใช่เนื้อหาของข้อความ)

หากระบุ searchParameters โดยไม่มีตัวกรองที่เฉพาะเจาะจง ระบบจะแสดงข้อความล่าสุดในการสนทนาทั้งหมดที่ผู้ใช้เข้าถึงได้

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

สคีมาอินพุต

{
  "searchParameters": {
    object (SearchParameters)
  },
  "pageSize": integer,
  "pageToken": string
}

{
  "keywords": [
    string
  ],
  "conversationId": string,
  "sender": string,
  "isUnread": boolean,
  "hasLink": boolean,
  "startTime": string,
  "endTime": string,
  "mentionsMe": boolean,
  "conversationIncludesUser": string,
  "spaceDisplayNames": [
    string
  ]
}

สคีมาเอาต์พุต

{
  "messages": [
    {
      object (ChatMessage)
    }
  ],
  "nextPageToken": string
}

{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ]
}

{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}

{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}

{
  "emoji": string,
  "count": integer
}

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

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

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

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

టీपที่ทำลายล้าง: ❌ | টিপที่ไม่มีผลข้างเคียง: ✅ | টিপแบบอ่านอย่างเดียว: ✅ | টিপแบบโลกเปิด: ❌

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

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

• https://www.googleapis.com/auth/chat.messages.readonly
• https://www.googleapis.com/auth/chat.spaces.readonly
• https://www.googleapis.com/auth/chat.memberships.readonly
• https://www.googleapis.com/auth/chat.users.readstate.readonly