MCP Tools Reference: people.googleapis.com

Araç: search_contacts

Kullanıcının kişilerini arama

UYULMASI GEREKEN ÖNEMLİ KURALLAR:

  • Bu araç birden fazla sonuç döndürürse sonuçları kullanıcıya göstermeli ve devam etmeden önce hangi sonucun kullanılacağı konusunda kullanıcıdan açıklama istemelisiniz.

  • Bu aracın çıktısını, kullanıcının açık onayı olmadan başka bir araca (ör. e-posta gönderme, taslak oluşturma, etkinlik oluşturma vb.) aktarmanız kesinlikle yasaktır.

  • Yalnızca bir kişi sonucu bulunsa bile, bulunan kişinin ayrıntılarını kullanıcıya sunmanız ve sonraki adımlara geçmeden önce kullanıcının bu kişinin amaçlanan kişi olduğunu doğrulamasını istemeniz gerekir.

Aşağıdaki örnekte, curl kullanılarak search_contacts MCP aracının nasıl çağrılacağı gösterilmektedir.

Curl İsteği 
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
}'

Giriş Şeması

SearchContacts için istek mesajı.

SearchContactsMcpRequest

JSON gösterimi 
{
  "query": string,
  "maxResults": integer
}
Alanlar
query

string

Aranacak sorgu dizesi.
maxResults

integer

Maksimum sonuç sayısı. Varsayılan değer 10, izin verilen maksimum değer ise 30'dur.

Çıkış şeması

SearchContacts için yanıt mesajı.

SearchContactsMcpResponse

JSON gösterimi 
{
  "results": [
    {
      object (SearchContactsResult)
    }
  ]
}
Alanlar
results[]

object (SearchContactsResult)

Sorguyla eşleşen kişilerin listesi.

SearchContactsResult

JSON gösterimi 
{
  "name": string,
  "email": string
}
Alanlar
name

string

Kişinin görünen adı.
email

string

Kişinin hesap e-posta adresi.

Araç Ek Açıklamaları

Yıkıcı İpucu: ❌ | İdempotent İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌