teams_search_messages

Microsoft Teams · macOS · Windows

Wirkung: Lesen. Status: bedingt verfügbar.

„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.

macOS

Zweck

Durchsucht die Microsoft Teams-Chat- und Kanalnachrichten eines Microsoft 365-Kontos mit Microsoft Search: nach Text und optional nach Absender und Datumsbereich. Verwenden Sie dies, um herauszufinden, wo etwas besprochen wurde, ohne den Chat zu kennen. Die Ergebnisse kommen in der Relevanzreihenfolge von Microsoft (nicht die neuesten zuerst), und body ist ein Ausschnitt rund um den Treffer, nicht die ganze Nachricht; lesen Sie den Chat mit teams_read_chat_messages für den Rest. Gibt höchstens 100 Ergebnisse aus höchstens 4 Seiten der Suche zurück. Wird das Lesen abgebrochen (durch diese Grenze oder weil dem Aufruf die Zeit ausging), enthält die Antwort truncated: true. Erfordert ein mit connect_m365_account verbundenes Microsoft 365-Arbeits- oder -Schulkonto (persönliche Microsoft-Konten haben keinen Teams-Lesezugriff). Ist überhaupt kein Microsoft 365-Konto verbunden, liest es stattdessen den lokalen Cache der Teams-App auf diesem Mac (erfordert Festplattenvollzugriff, kann Stunden oder Tage im Rückstand sein); source in der Antwort gibt an, welche Quelle geantwortet hat (graph oder local_cache).

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

Kanonisches technisches Schema auf Englisch — macOS

{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "from_sender": {
      "description": "Only messages from this sender (name or email; optional)",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 25, max 100)",
      "type": "integer"
    },
    "query": {
      "description": "Text to search for",
      "type": "string"
    },
    "since": {
      "description": "Only messages on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only messages on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für teams_search_messages. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

{
  "limit": 5,
  "query": "launch checklist"
}

Windows

Zweck

Durchsucht Ihren Microsoft Teams-Chat- und Direktnachrichtenverlauf (alle Konversationen gleichzeitig) nach Text, Absendername und/oder Datumsbereich. Verwenden Sie dies, um herauszufinden, wo in Teams etwas besprochen wurde, ohne zu wissen, in welchem Chat. Gibt übereinstimmende Nachrichten (die relevantesten zuerst) zurück, jeweils mit einem Ausschnitt und dem Chat, aus dem sie stammen. Gibt höchstens 100 Ergebnisse aus höchstens 4 Seiten der Suche zurück. Wird das Lesen abgebrochen (durch diese Grenze oder weil dem Aufruf die Zeit ausging), enthält die Antwort truncated: true.

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

Kanonisches technisches Schema auf Englisch — Windows

{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "from_sender": {
      "description": "Filter to a sender by name (optional)",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 25, max 100)",
      "type": "integer"
    },
    "query": {
      "description": "Text to find in messages",
      "type": "string"
    },
    "since": {
      "description": "Only messages on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only messages on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "type": "object"
}

Dokumentationsbeispiel

{
  "limit": 5,
  "query": "launch checklist"
}