MCP Tools Reference: people.googleapis.com

Công cụ: search_contacts

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

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 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à yêu cầu 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 '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ú 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ở: ❌