MCP Tools Reference: people.googleapis.com

Công cụ: search_directory_people

Tìm kiếm người dùng trong thư mục Google Workspace của tổ chức. Tính năng này chỉ dành cho các tài khoản Google Workspace (do doanh nghiệp, trường học và các tổ chức khác sử dụng) và không dành cho Tài khoản Google cá nhân.

QUY TẮC QUAN TRỌNG CẦN TUÂN THỦ:

  • Nếu công cụ này trả về nhiều kết quả, bạn nên trình bày các kết quả đó cho người dùng và yêu cầu người dùng làm rõ kết quả nào cần sử dụng trước khi tiếp tục.

  • Bạn tuyệt đối không được truyền đầu ra của công cụ này vào một công cụ khác (ví dụ: gửi email, tạo bản nháp, tạo sự kiện, v.v.) mà không có sự xác nhận rõ ràng của người dùng.

  • Ngay cả khi chỉ tìm thấy một kết quả về người dùng, bạn vẫn phải trình bày thông tin chi tiết của người dùng tìm thấy cho người dùng và yêu cầu người dùng xác minh rằng đây là người dùng dự định trước khi tiếp tục các bước tiếp theo.

  • Nếu công cụ này không trả về kết quả nào, hãy quay lại sử dụng công cụ search_contacts.

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

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

Lược đồ đầu vào

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

SearchDirectoryPeopleMcpRequest

Biểu diễn dưới dạng JSON 
{
  "query": string,
  "pageSize": integer,
  "pageToken": string,
  "sources": [
    enum (DirectorySourceType)
  ]
}
Trường
query

string

Chuỗi truy vấn để tìm kiếm.
pageSize

integer

Kích thước trang. Giá trị mặc định là 10 và giá trị tối đa được phép là 500.
pageToken

string

Mã thông báo trang.
sources[]

enum (DirectorySourceType)

Nguồn thư mục cần trả về. Giá trị mặc định là DOMAIN_PROFILE nếu không được đặt.

Lược đồ đầu ra

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

SearchDirectoryPeopleMcpResponse

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

object (SearchDirectoryResult)

Danh sách những người dùng khớp với truy vấn.
nextPageToken

string

Mã thông báo để truy xuất trang kết quả tiếp theo.

SearchDirectoryResult

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

string

Tên hiển thị của người dùng.
email

string

Địa chỉ email của tài khoản người dùng.

Chú thích công cụ

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