MCP Tools Reference: chatmcp.googleapis.com

Công cụ: search_conversations

Tìm kiếm cuộc trò chuyện trên Google Chat theo tên hiển thị.

Nếu chỉ cung cấp người tham gia, công cụ này sẽ tìm tin nhắn trực tiếp 1:1 (nếu cung cấp một người tham gia) hoặc cuộc trò chuyện nhóm (nếu cung cấp nhiều người tham gia) có bao gồm những người tham gia được chỉ định và người dùng gọi.

Nếu chỉ cung cấp một truy vấn, công cụ này sẽ tìm kiếm các cuộc trò chuyện trong đó truy vấn là một chuỗi con không phân biệt chữ hoa chữ thường của tên hiển thị của cuộc trò chuyện.

Nếu cung cấp cả người tham gia và truy vấn, công cụ này sẽ tìm cuộc trò chuyện theo người tham gia, sau đó lọc theo tên hiển thị.

Nếu không cung cấp người tham gia cũng như truy vấn, công cụ này sẽ liệt kê tất cả cuộc trò chuyện mà người dùng gọi là thành viên.

Công cụ này chỉ liệt kê những cuộc trò chuyện mà người dùng gọi là thành viên.

QUAN TRỌNG: Danh sách "conversations" (cuộc trò chuyện) trống không có nghĩa là không còn kết quả nào nữa. Nếu có "next_page_token", bạn có thể tìm nạp thêm trang. Nếu bạn nhận được một danh sách trống nhưng có "next_page_token", hãy hỏi người dùng xem bạn có nên tiếp tục tìm kiếm hay không.

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

Yêu cầu Curl 
curl --location 'https://chatmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_conversations",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giản đồ đầu vào

Thông báo yêu cầu cho FindConversations RPC.

SearchConversationsRequest

Biểu diễn dưới dạng JSON 
{
  "spaceNameQuery": string,
  "pageSize": integer,
  "pageToken": string,
  "participants": [
    string
  ]
}
Trường
spaceNameQuery

string

Không bắt buộc. Văn bản cần tìm trong tên hiển thị của không gian.
pageSize

integer

Không bắt buộc. Số lượng phòng tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu không chỉ định, hệ thống sẽ trả về tối đa 100 phòng. Giá trị tối đa là 1000; các giá trị trên 1000 sẽ bị ép buộc thành 1000.
pageToken

string

Không bắt buộc. Mã thông báo trang nhận được từ lệnh gọi search_conversations trước đó. Hãy cung cấp mã này để truy xuất trang tiếp theo.
participants[]

string

Không bắt buộc. Danh sách địa chỉ email của những người tham gia để lọc cuộc trò chuyện, ngoại trừ người gọi.

Giản đồ đầu ra

Thông báo phản hồi cho FindConversations RPC.

SearchConversationsResponse

Biểu diễn dưới dạng JSON 
{
  "conversations": [
    {
      object (Conversation)
    }
  ],
  "nextPageToken": string
}
Trường
conversations[]

object (Conversation)

Danh sách các đối tượng cuộc trò chuyện khớp với tiêu chí tìm kiếm.
nextPageToken

string

Mã thông báo có thể được gửi dưới dạng page_token để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, thì sẽ không có trang tiếp theo.

Cuộc trò chuyện

Biểu diễn dưới dạng JSON 
{
  "conversationId": string,
  "displayName": string,
  "conversationType": enum (ConversationType),
  "lastActiveTimestamp": string
}
Trường
conversationId

string

Mã nhận dạng của cuộc trò chuyện (ví dụ: "spaces/AAAAAAAAA").
displayName

string

Tên hiển thị của cuộc trò chuyện.
conversationType

enum (ConversationType)

Loại cuộc trò chuyện (DIRECT_MESSAGE, GROUP_CHAT hoặc NAMED_SPACE).
lastActiveTimestamp

string (Timestamp format)

Thời gian hoạt động gần đây nhất của cuộc trò chuyện ở định dạng ISO 8601.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

Dấu thời gian

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

string (int64 format)

Biểu thị số giây của thời gian UTC kể từ thời gian bắt đầu của hệ thống Unix 1970-01-01T00:00:00Z. Phải nằm trong khoảng từ -62135596800 đến 253402300799 (tương ứng với 0001-01-01T00:00:00Z đến 9999-12-31T23:59:59Z).
nanos

integer

Phân số không âm của một giây ở độ phân giải nano giây. Trường này là phần nano giây của khoảng thời gian, không phải là một lựa chọn thay thế cho giây. Giá trị giây âm có phân số vẫn phải có giá trị nano giây không âm để đếm tiến theo thời gian. Phải nằm trong khoảng từ 0 đến 999.999.999.

Chú thích công cụ

Gợi ý gây hại: ❌ | Gợi ý về tính chất luỹ đẳng: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý về thế giới mở: ❌