MCP Tools Reference: people.googleapis.com

Alat: search_contacts

Menelusuri kontak pengguna.

ATURAN PENTING YANG HARUS DIIKUTI:

  • Jika alat ini menampilkan beberapa hasil, Anda harus menampilkan hasil tersebut kepada pengguna dan meminta pengguna untuk mengklarifikasi hasil mana yang akan digunakan sebelum melanjutkan.

  • Anda dilarang keras meneruskan output alat ini ke alat lain (misalnya, mengirim email, membuat draf, membuat acara, dll.) tanpa konfirmasi eksplisit dari pengguna.

  • Meskipun hanya satu hasil orang yang ditemukan, Anda harus menampilkan detail orang yang ditemukan kepada pengguna dan meminta pengguna untuk memverifikasi bahwa orang tersebut adalah orang yang dimaksud sebelum melanjutkan ke langkah selanjutnya.

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP search_contacts.

Permintaan 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
}'

Skema Input

Pesan permintaan untuk SearchContacts.

SearchContactsMcpRequest

Representasi JSON 
{
  "query": string,
  "maxResults": integer
}
Kolom
query

string

String kueri yang akan ditelusuri.
maxResults

integer

Jumlah maksimum hasil. Nilai defaultnya adalah 10 dan nilai maksimum yang diizinkan adalah 30.

Skema Output

Pesan respons untuk SearchContacts.

SearchContactsMcpResponse

Representasi JSON 
{
  "results": [
    {
      object (SearchContactsResult)
    }
  ]
}
Kolom
results[]

object (SearchContactsResult)

Daftar kontak yang cocok dengan kueri.

SearchContactsResult

Representasi JSON 
{
  "name": string,
  "email": string
}
Kolom
name

string

Nama tampilan kontak.
email

string

Alamat email akun kontak.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ❌