MCP Tools Reference: chatmcp.googleapis.com

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

Выполняет поиск переписки в Google Chat по отображаемому имени.

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

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

Если указаны и участники, и запрос, этот инструмент находит беседы по участникам, а затем фильтрует их по отображаемому имени.

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

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

ВАЖНО: Пустой список «диалогов» не означает, что результатов больше нет. Если присутствует «next_page_token», можно получить доступ к дополнительным страницам. Если список пуст, но присутствует «next_page_token», спросите пользователя, следует ли продолжить поиск.

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

Запрос Curl 
curl --location 'https://chatmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_conversations",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Схема ввода

Сообщение запроса для RPC FindConversations.

SearchConversationsRequest

JSON-представление 
{
  "spaceNameQuery": string,
  "pageSize": integer,
  "pageToken": string,
  "participants": [
    string
  ]
}
Поля
spaceNameQuery

string

Необязательно. Текст для поиска в отображаемых именах пространства.

pageSize

integer

Необязательный параметр. Максимальное количество возвращаемых символов. Сервис может вернуть меньше этого значения. Если параметр не указан, будет возвращено не более 100 символов. Максимальное значение — 1000; значения выше 1000 будут преобразованы в 1000.

pageToken

string

Необязательный параметр. Токен страницы, полученный из предыдущего вызова search_conversations . Укажите его, чтобы получить следующую страницу.

participants[]

string

Необязательно. Список адресов электронной почты участников для фильтрации разговоров, исключая звонившего.

Схема вывода

Ответное сообщение для RPC-запроса FindConversations.

SearchConversationsResponse

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

object ( Conversation )

Список объектов диалога, соответствующих критериям поиска.

nextPageToken

string

Токен, который можно отправить в качестве page_token для получения следующей страницы. Если это поле опущено, последующих страниц не будет.

Беседа

JSON-представление 
{
  "conversationId": string,
  "displayName": string,
  "conversationType": enum (ConversationType),
  "lastActiveTimestamp": string
}
Поля
conversationId

string

Идентификатор беседы (например, "spaces/AAAAAAAAAA").

displayName

string

Отображаемое имя беседы.

conversationType

enum ( ConversationType )

Тип беседы (DIRECT_MESSAGE, GROUP_CHAT или NAMED_SPACE).

lastActiveTimestamp

string ( Timestamp format)

Время последней активности разговора в формате ISO 8601.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

Отметка времени

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

string ( int64 format)

Обозначает количество секунд UTC-времени с начала эпохи Unix 1970-01-01T00:00:00Z. Должно находиться в диапазоне от -62135596800 до 253402300799 включительно (что соответствует периоду с 0001-01-01T00:00:00Z по 9999-12-31T23:59:59Z).

nanos

integer

Неотрицательные доли секунды с разрешением в наносекунды. Это поле представляет собой наносекундную часть длительности, а не альтернативу секундам. Отрицательные значения секунд с дробными долями должны по-прежнему иметь неотрицательные значения в наносекундах, отсчитываемые вперед во времени. Должны быть в диапазоне от 0 до 999 999 999 включительно.

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

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