MCP Tools Reference: people.googleapis.com

Công cụ: search_contacts

Tìm kiếm người liên hệ của người dùng.

CÁC 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à nhắc 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 chuyển đầu ra của công cụ này sang 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 kết quả của một người, bạn vẫn phải trình bày thông tin chi tiết của người đó cho người dùng và nhắc người dùng xác minh rằng đây là người mà họ muốn tìm trước khi tiếp tục các bước tiếp theo.

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

Yêu cầu Curl 
curl --location 'https://people.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_contacts",
    "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 SearchContacts.

SearchContactsMcpRequest

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

string

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

integer

Số kết quả tối đa. Giá trị mặc định là 10 và giá trị tối đa được phép là 30.

Giản đồ đầu ra

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

SearchContactsMcpResponse

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

object (SearchContactsResult)

Danh sách người liên hệ khớp với truy vấn.

SearchContactsResult

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 liên hệ.
email

string

Địa chỉ email của tài khoản người liên hệ.

Chú giải công cụ

Gợi ý phá huỷ: ❌ | Gợi ý bất biến: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý 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/contacts.readonly