Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

MCP Tools Reference: chatmcp.googleapis.com

Công cụ: `search_conversations`

Tìm kiếm các cuộc trò chuyện trên Google Chat để tìm mã cuộc trò chuyện. Bạn có thể tìm thấy không gian có tên bằng tên hiển thị (space_name_query). Bạn chỉ có thể tìm thấy tin nhắn trực tiếp (DM) và cuộc trò chuyện nhóm bằng địa chỉ email của người tham gia (participants).

Công cụ này tìm kiếm siêu dữ liệu của cuộc trò chuyện, KHÔNG tìm kiếm nội dung tin nhắn. Để tìm kiếm trong nhật ký tin nhắn hoặc tìm tin nhắn theo từ khoá/người gửi/dấu thời gian, hãy dùng search_messages.

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

Nếu bạn chỉ cung cấp space_name_query, thì công cụ này CHỈ tìm kiếm những không gian có tên mà trong đó, cụm từ tìm kiếm là một chuỗi con không phân biệt chữ hoa chữ thường trong tên hiển thị của không gian. Tin nhắn trực tiếp và cuộc trò chuyện nhóm không bao giờ được trả về, vì vậy, KHÔNG chuyển tên của một người dưới dạng space_name_query để tìm tin nhắn trực tiếp với họ; hãy tra cứu địa chỉ email của họ và chuyển địa chỉ đó vào participants.

Nếu bạn cung cấp cả participants và space_name_query, công cụ này sẽ tìm tin nhắn trực tiếp hoặc cuộc trò chuyện nhóm theo người tham gia, sau đó lọc theo tên hiển thị.

Nếu bạn không cung cấp cả participants và space_name_query, thì công cụ này sẽ liệt kê các không gian có tên mà người dùng gọi là thành viên (không bao gồm tin nhắn trực tiếp và cuộc trò chuyện nhóm).

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.

Trả về danh sách các đối tượng cuộc trò chuyện chứa mã cuộc trò chuyện (định dạng: spaces/{space}), tên hiển thị và loại cuộc trò chuyện.

QUAN TRỌNG: Danh sách conversations trống không có nghĩa là không còn kết quả nào khác. Nếu có next_page_token, bạn có thể tìm nạp thêm trang. Nếu bạn nhận được 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ã mẫu sau đây cho biết 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/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": "search_conversations", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }'

Yêu cầu 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": "search_conversations",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giản đồ đầu vào

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 cuộc trò chuyện (khớp chuỗi con không phân biệt chữ hoa chữ thường). Nếu `participants` trống, thì chỉ những không gian có tên mới được tìm kiếm và tin nhắn trực tiếp (DM) cũng như cuộc trò chuyện nhóm sẽ không bao giờ được trả về. Do đó, việc tìm kiếm tên của một người tại đây sẽ không tìm thấy tin nhắn trực tiếp với người đó. Để tìm tin nhắn trực tiếp hoặc cuộc trò chuyện nhóm, hãy cung cấp địa chỉ email của thành viên trong `participants`. Nếu bạn đặt `participants`, thì truy vấn này sẽ lọc thêm các tin nhắn trực tiếp hoặc cuộc trò chuyện nhóm phù hợp theo tên hiển thị.
`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 được chỉ định, hệ thống sẽ trả về tối đa 20 không gian. Giá trị tối đa là 1000; các giá trị trên 1000 sẽ được chuyển 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 đó. 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, không bao gồm người gọi. Sử dụng bộ lọc này để tìm tin nhắn trực tiếp (DM) và cuộc trò chuyện nhóm: một người tham gia sẽ trả về tin nhắn trực tiếp 1:1 với người đó và nhiều người tham gia sẽ trả về cuộc trò chuyện nhóm có tất cả những người đó. Không gian có tên sẽ không được trả về khi bạn đặt trường này.

Giản đồ đầu ra

Nội dung 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

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. Mỗi cuộc trò chuyện bao gồm conversation_id (định dạng: spaces/{space}), display_name, conversation_type và last_active_timestamp.
`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 trường này bị bỏ qua, thì sẽ không có trang tiếp theo. Chỉ được điền sẵn nếu yêu cầu được lọc theo `participants`.

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. Mỗi cuộc trò chuyện bao gồm conversation_id (định dạng: spaces/{space}), display_name, conversation_type và last_active_timestamp.

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 trường này bị bỏ qua, thì sẽ không có trang tiếp theo.

Chỉ được điền sẵn nếu yêu cầu được lọc theo participants.

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. Đối với không gian có tên, đây là tên không gian. Đối với tin nhắn trực tiếp 1:1, đây là tên của người tham gia còn lại. Đối với cuộc trò chuyện nhóm chưa đặt tên, đây là tên được tạo dựa trên tên của các thành viê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

Trường
`seconds`	`string (int64 format)` Biểu thị số giây theo giờ UTC kể từ thời gian 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 thời lượng, không phải là giá trị thay thế cho giây. Giá trị giây âm có phân số vẫn phải có giá trị nano không âm, được tính theo thời gian. Phải nằm trong khoảng từ 0 đến 999.999.999.

seconds

string (int64 format)

Biểu thị số giây theo giờ UTC kể từ thời gian 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 thời lượng, không phải là giá trị thay thế cho giây. Giá trị giây âm có phân số vẫn phải có giá trị nano không âm, được tính 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`	Một 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 về công cụ

Chú thích về công cụ được gửi đến ứng dụng MCP để mô tả rủi ro cơ bản của một công cụ nhất định. Hầu hết ứng dụng đều coi những gợi ý này là không đáng tin cậy, nhưng có thể dùng chúng để quyết định thời điểm gửi lời nhắc xác nhận cho người dùng.

Cùng với chuỗi tiêu đề, các gợi ý boolean sau đây được xác định như sau:

readOnlyHint: Nếu đúng, công cụ sẽ không sửa đổi môi trường của nó. Mặc định: false.
destructiveHint: Nếu đúng, thì công cụ có thể thực hiện các hành động có tính huỷ diệt. Nếu là false, thì công cụ chỉ có thể thực hiện các hành động bổ sung. Mặc định: true.
idempotentHint: Nếu đúng, thì việc gọi công cụ nhiều lần với cùng một đối số sẽ không có thêm hiệu ứng nào đối với môi trường của công cụ đó. Mặc định: false.
openWorldHint: Nếu đúng, thì công cụ này có thể tương tác với "thế giới mở" của các thực thể bên ngoài. Nếu là false, thì công cụ chỉ có thể tương tác với các thực thể nội bộ. Ví dụ: công cụ tìm kiếm trên web sẽ là công cụ thế giới mở, còn công cụ ghi nhớ sẽ không phải là công cụ thế giới mở.

Gợi ý về thao tác huỷ bỏ: ❌ | Gợi ý về thao tác không thay đổi giá trị: ✅ | Gợi ý về thao tác chỉ đọc: ✅ | Gợi ý về thế giới mở: ❌

Phạm vi cấp phép

Yêu cầu một trong các phạm vi OAuth sau:

https://www.googleapis.com/auth/chat.memberships.readonly
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.spaces.readonly