MCP Tools Reference: people.googleapis.com

Инструмент: search_directory_people

Поиск пользователей в каталоге Google Workspace вашей организации. Эта функция доступна исключительно для учетных записей Google Workspace (используемых предприятиями, школами и другими организациями) и недоступна для личных учетных записей Google.

ВАЖНЫЕ ПРАВИЛА, КОТОРЫЕ НЕОБХОДИМО СОБЛЮДАТЬ:

  • Если инструмент выдает несколько результатов, следует отобразить их пользователю и попросить его уточнить, какой результат использовать, прежде чем продолжить.

  • Категорически запрещается передавать результаты работы этого инструмента в другой инструмент (например, для отправки электронного письма, создания черновика, создания события и т. д.) без явного подтверждения пользователя.

  • Даже если найден только один человек, необходимо отобразить его данные и предложить пользователю подтвердить, что это именно тот человек, которого вы искали, прежде чем переходить к дальнейшим действиям.

  • Если этот инструмент не выдаст результатов, воспользуйтесь инструментом search_contacts .

В следующем примере показано, как использовать curl для вызова инструмента MCP search_directory_people .

Запрос 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
}'

Схема ввода

Запрос сообщения для SearchDirectoryPeople.

SearchDirectoryPeopleMcpRequest

JSON-представление 
{
  "query": string,
  "pageSize": integer,
  "pageToken": string,
  "sources": [
    enum (DirectorySourceType)
  ]
}
Поля
query

string

Строка запроса для поиска.

pageSize

integer

Размер страницы. Значение по умолчанию — 10, максимально допустимое значение — 500.

pageToken

string

Токен страницы.

sources[]

enum ( DirectorySourceType )

Список каталогов для возврата. По умолчанию используется DOMAIN_PROFILE, если не задано.

Схема вывода

Ответное сообщение для SearchDirectoryPeople.

SearchDirectoryPeopleMcpResponse

JSON-представление 
{
  "results": [
    {
      object (SearchDirectoryResult)
    }
  ],
  "nextPageToken": string
}
Поля
results[]

object ( SearchDirectoryResult )

Список людей, соответствующих запросу.

nextPageToken

string

Токен для перехода на следующую страницу результатов.

SearchDirectoryResult

JSON-представление 
{
  "name": string,
  "email": string
}
Поля
name

string

Отображаемое имя пользователя.

email

string

Адрес электронной почты, указанный в учетной записи пользователя.

Аннотации инструментов

Подсказка о разрушительном эффекте: ❌ | Подсказка об идемпотентности: ✅ | Подсказка только для чтения: ✅ | Подсказка об открытом мире: ❌