MCP Tools Reference: people.googleapis.com

Narzędzie: search_directory_people

Wyszukuj osoby w katalogu Google Workspace organizacji. Ta funkcja jest dostępna wyłącznie na kontach Google Workspace (używanych przez firmy, szkoły i inne organizacje) i nie jest dostępna na osobistych kontach Google.

WAŻNE REGUŁY, KTÓRYCH NALEŻY PRZESTRZEGAĆ:

  • Jeśli to narzędzie zwróci wiele wyników, wyświetl je użytkownikowi i poproś go o wyjaśnienie, którego wyniku chcesz użyć.

  • Zabrania się przekazywania danych wyjściowych tego narzędzia do innego narzędzia (np. wysyłania e-maila, tworzenia wersji roboczej, tworzenia wydarzenia itp.) bez wyraźnego potwierdzenia użytkownika.

  • Nawet jeśli znajdziesz tylko 1 wynik, musisz przedstawić użytkownikowi szczegóły znalezionej osoby i poprosić go o potwierdzenie, że to właściwa osoba, zanim przejdziesz do dalszych kroków.

  • Jeśli to narzędzie nie zwróci żadnych wyników, użyj narzędzia search_contacts.

Poniższy przykład pokazuje, jak za pomocą znaku curl wywołać narzędzie search_directory_people MCP.

Żądanie 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
}'

Schemat wejściowy

Wiadomość z prośbą o wywołanie funkcji SearchDirectoryPeople.

SearchDirectoryPeopleMcpRequest

Zapis JSON 
{
  "query": string,
  "pageSize": integer,
  "pageToken": string,
  "sources": [
    enum (DirectorySourceType)
  ]
}
Pola
query

string

Ciąg zapytania do wyszukania.
pageSize

integer

Rozmiar strony. Wartość domyślna to 10, a maksymalna dozwolona wartość to 500.
pageToken

string

Token strony.
sources[]

enum (DirectorySourceType)

Źródła katalogu do zwrócenia. Jeśli nie zostanie ustawiony, domyślna wartość to DOMAIN_PROFILE.

Schemat wyjściowy

Wiadomość odpowiedzi dla SearchDirectoryPeople.

SearchDirectoryPeopleMcpResponse

Zapis JSON 
{
  "results": [
    {
      object (SearchDirectoryResult)
    }
  ],
  "nextPageToken": string
}
Pola
results[]

object (SearchDirectoryResult)

Lista osób, które pasują do zapytania.
nextPageToken

string

Token do pobierania następnej strony wyników.

SearchDirectoryResult

Zapis JSON 
{
  "name": string,
  "email": string
}
Pola
name

string

Wyświetlana nazwa osoby.
email

string

Adres e-mail konta tej osoby.

Adnotacje narzędzi

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌