MCP Tools Reference: chatmcp.googleapis.com

Outil : search_messages

Recherchez des messages Google Chat à l'aide de mots clés et de filtres, et renvoyez-les au format Markdown. Fonctionne dans tous les espaces auxquels l'utilisateur a accès ou peut être limité à une conversation spécifique.

Suivez ces conseils pour décider d'utiliser search_messages ou d'autres outils de recherche ou de lecture :

• Utilisez search_messages lorsque vous recherchez du contenu de message spécifique, des mots clés, des mentions, des liens, des expéditeurs ou des messages non lus potentiellement dans plusieurs espaces ou sans ID de conversation connu.
• Utilisez list_messages lorsque vous connaissez l'ID de l'espace ou du fil de discussion spécifique et que vous souhaitez lire les messages de manière séquentielle, par ordre chronologique.
• Utilisez search_conversations pour trouver des métadonnées d'espace telles que les ID de conversation par nom à afficher de l'espace ou par participants (la recherche ne porte que sur les métadonnées, et non sur le contenu des messages).

Si searchParameters est fourni sans filtres spécifiques, les messages récents de toutes les conversations accessibles à l'utilisateur sont renvoyés.

L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP search_messages.

Schéma d'entrée

{
  "searchParameters": {
    object (SearchParameters)
  },
  "pageSize": integer,
  "pageToken": string
}

{
  "keywords": [
    string
  ],
  "conversationId": string,
  "sender": string,
  "isUnread": boolean,
  "hasLink": boolean,
  "startTime": string,
  "endTime": string,
  "mentionsMe": boolean,
  "conversationIncludesUser": string,
  "spaceDisplayNames": [
    string
  ],
  "conversationTypes": [
    enum (ConversationType)
  ]
}

Schéma de sortie

{
  "messages": [
    {
      object (ChatMessage)
    }
  ],
  "nextPageToken": string
}

{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ]
}

{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}

{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}

{
  "emoji": string,
  "count": integer
}

Annotations d'outils

Les annotations d'outil sont envoyées aux clients MCP pour décrire le risque de base d'un outil donné. La plupart des clients traitent ces indices comme non fiables, mais ils peuvent être utilisés pour déterminer quand un message de confirmation peut être envoyé à un utilisateur.

En plus de la chaîne de titre, les indications booléennes suivantes sont définies comme suit :

• readOnlyHint : si la valeur est "true", l'outil ne modifie pas son environnement. Valeur par défaut : "false".
• destructiveHint : si la valeur est "true", l'outil peut effectuer des actions destructrices. Si la valeur est "false", l'outil ne peut effectuer que des actions d'ajout. Valeur par défaut : "true".
• idempotentHint : si la valeur est "true", appeler l'outil à plusieurs reprises avec les mêmes arguments n'aura aucun effet supplémentaire sur son environnement. Valeur par défaut : "false".
• openWorldHint : si la valeur est "true", l'outil peut interagir avec un "monde ouvert" d'entités externes. Si la valeur est "false", l'outil ne peut interagir qu'avec des entités internes. Par exemple, un outil de recherche Web serait en monde ouvert, tandis qu'un outil de mémoire ne le serait pas.

Indication destructive : ❌ | Indication d'idempotence : ✅ | Indication de lecture seule : ✅ | Indication de monde ouvert : ❌

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

• https://www.googleapis.com/auth/chat.messages.readonly
• https://www.googleapis.com/auth/chat.spaces.readonly
• https://www.googleapis.com/auth/chat.memberships.readonly
• https://www.googleapis.com/auth/chat.users.readstate.readonly