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ó 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à 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.

LƯU Ý QUAN TRỌNG: Danh sách "cuộc trò chuyện" trống không có nghĩa là không có kết quả nào khác. Nếu có "next_page_token", bạn có thể tìm nạp thêm các trang khác. 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ụ search_conversations 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": "search_conversations",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giản đồ đầu vào

Yêu cầu tìm kiếm cuộc trò chuyện trên Google Chat bằng bộ lọc.

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 không gian 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 không gian. Giá trị tối đa là 1000; các giá trị trên 1000 sẽ bị ép 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 cần lọc cuộc trò chuyện, ngoại trừ người gọi.

Giản đồ đầu ra

Phản hồi chứa danh sách các cuộc trò chuyện phù hợp.

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 phù hợ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ã 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. Các 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.

ConversationType

Xác định loại cuộc trò chuyện.

Enum
CONVERSATION_TYPE_UNSPECIFIED Không xác định.
NAMED_SPACE Không gian có tên.
GROUP_CHAT Cuộc trò chuyện nhóm giữa 3 người trở lên.
DIRECT_MESSAGE Tin nhắn trực tiếp giữa hai người hoặc giữa một người và một ứng dụng Chat.

Chú thích công cụ

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