MCP Tools Reference: chatmcp.googleapis.com

Narzędzie: search_conversations

Wyszukuje rozmowy w Google Chat według wyświetlanej nazwy.

Jeśli podani są tylko uczestnicy, to narzędzie znajduje czaty 1:1 (jeśli podany jest 1 uczestnik) lub czaty grupowe (jeśli podanych jest kilku uczestników), które obejmują określonych uczestników i użytkownika wywołującego.

Jeśli podane jest tylko zapytanie, to narzędzie wyszukuje rozmowy, w których zapytanie jest podciągiem wyświetlanej nazwy rozmowy bez uwzględniania wielkości liter.

Jeśli podani są zarówno uczestnicy, jak i zapytanie, to narzędzie znajduje rozmowy według uczestników, a następnie filtruje je według wyświetlanej nazwy.

Jeśli nie podano ani uczestników, ani zapytania, to narzędzie wyświetla listę wszystkich rozmów, których członkiem jest użytkownik wywołujący.

To narzędzie wyświetla tylko rozmowy, których członkiem jest użytkownik wywołujący.

WAŻNE: pusta lista „conversations” nie oznacza, że nie ma więcej wyników. Jeśli występuje „next_page_token”, można pobrać więcej stron. Jeśli otrzymasz pustą listę, ale „next_page_token”, zapytaj użytkownika, czy chcesz kontynuować wyszukiwanie.

Poniższy przykład pokazuje, jak użyć curl, aby wywołać narzędzie MCP search_conversations.

Żądanie Curl 
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \
--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
}'

Schemat wejściowy

Komunikat żądania dla RPC FindConversations.

SearchConversationsRequest

Zapis JSON 
{
  "spaceNameQuery": string,
  "pageSize": integer,
  "pageToken": string,
  "participants": [
    string
  ]
}
Pola
spaceNameQuery

string

Opcjonalnie. Tekst do wyszukania w wyświetlanych nazwach pokoi.
pageSize

integer

Opcjonalnie. Maksymalna liczba pokoi do zwrócenia. Usługa może zwrócić mniej niż tę wartość. Jeśli nie zostanie określona, zostanie zwróconych co najwyżej 100 pokoi. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.
pageToken

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania search_conversations. Podaj go, aby pobrać następną stronę.
participants[]

string

Opcjonalnie. Lista adresów e-mail uczestników, według których mają być filtrowane rozmowy, z wyłączeniem rozmówcy.

Schemat wyjściowy

Komunikat odpowiedzi dla RPC FindConversations.

SearchConversationsResponse

Zapis JSON 
{
  "conversations": [
    {
      object (Conversation)
    }
  ],
  "nextPageToken": string
}
Pola
conversations[]

object (Conversation)

Lista obiektów rozmów, które pasują do kryteriów wyszukiwania.
nextPageToken

string

Token, który można wysłać jako page_token, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

Rozmowa

Zapis JSON 
{
  "conversationId": string,
  "displayName": string,
  "conversationType": enum (ConversationType),
  "lastActiveTimestamp": string
}
Pola
conversationId

string

Identyfikator rozmowy (np. „spaces/AAAAAAAAA”).
displayName

string

Wyświetlana nazwa rozmowy.
conversationType

enum (ConversationType)

Typ rozmowy (DIRECT_MESSAGE, GROUP_CHAT lub NAMED_SPACE).
lastActiveTimestamp

string (Timestamp format)

Czas ostatniej aktywności w rozmowie w formacie ISO 8601.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

Sygnatura czasowa

Zapis JSON 
{
  "seconds": string,
  "nanos": integer
}
Pola
seconds

string (int64 format)

Liczba sekund czasu UTC od epoki uniksowej (1970-01-01T00:00:00Z). Musi mieścić się w zakresie od -62135596800 do 253402300799 włącznie (co odpowiada okresowi od 0001-01-01T00:00:00Z do 9999-12-31T23:59:59Z).
nanos

integer

Nieujemne ułamki sekundy z dokładnością do nanosekundy. To pole jest częścią czasu trwania w nanosekundach, a nie alternatywą dla sekund. Wartości ujemne sekund z ułamkami muszą nadal mieć nieujemne wartości nanos, które liczą się do przodu w czasie. Musi mieścić się w zakresie od 0 do 999 999 999 włącznie.

ConversationType

Określa typ rozmowy.

Wartości w polu enum
CONVERSATION_TYPE_UNSPECIFIED Nie określono.
NAMED_SPACE Nazwany pokój.
GROUP_CHAT Czat grupowy między co najmniej 3 osobami.
DIRECT_MESSAGE Wiadomość bezpośrednia między 2 osobami lub między osobą a aplikacją Chat.

Adnotacje narzędzi

Wskazówka dotycząca działania destrukcyjnego: ❌ | Wskazówka dotycząca idempotentności: ✅ | Wskazówka dotycząca trybu tylko do odczytu: ✅ | Wskazówka dotycząca otwartego świata: ❌