search_emails

macOS

Zweck

Verwenden Sie es, wenn der Benutzer bestimmte E-Mails auf diesem Mac finden möchte (Apple Mail – jedes zu Mail.app hinzugefügte Konto). Durchsucht standardmäßig Betreff und Absender; übergeben Sie scope="body" oder scope="all", um auch den Nachrichtentext zu durchsuchen (siehe search_coverage in der Antwort – eine Textsuche kann unvollständig sein, solange der lokale Index noch aufgebaut wird). Papierkorb- und Junk-Ordner bleiben außen vor, es sei denn include_trash=true oder mailbox nennt einen. Für ein Microsoft-365-Postfach, das NICHT zu Mail.app hinzugefügt wurde, verwenden Sie m365_search_emails. WICHTIG: Rufen Sie auf Rechnern mit 2+ Konten mit account=<name> auf (aus list_email_accounts). Ohne dies, und wenn der schnelle Index nicht antworten kann, gibt search_emails die Kontoliste zurück, statt alle zu durchsuchen – das Durchsuchen aller Konten in einem Aufruf hat kein Zeitlimit und kann Mail auch für andere Anfragen blockieren. Genau 1 Konto ist nicht betroffen.

Erforderliche Eingaben

• query

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

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.

{
  "properties": {
    "account": {
      "description": "Mail.app account to search (from list_email_accounts). On a Mac with 2+ accounts this is effectively required: without it, and when the fast index cannot answer, the tool returns the account list instead of scanning them all.",
      "type": "string"
    },
    "include_trash": {
      "default": "false",
      "description": "Also return matches from trash and junk folders. Default false: a search of every folder leaves them out. Not needed when mailbox names the folder.",
      "type": "boolean"
    },
    "limit": {
      "default": "20",
      "description": "Maximum number of matches to return.",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "mailbox": {
      "description": "Restrict the search to one folder, by name (see list_email_folders). Defaults to every folder of the account.",
      "type": "string"
    },
    "query": {
      "description": "What to look for. Matched against subject and sender, or also the body when scope is \"body\" or \"all\".",
      "type": "string"
    },
    "recipient": {
      "description": "Only messages sent to this address or name (To or Cc), e.g. one of the user's own aliases. Narrows the matches of query.",
      "type": "string"
    },
    "scope": {
      "default": "metadata",
      "description": "\"metadata\" (default, subject+sender — fast, unchanged behavior), \"body\" (message body only, via a local index — see search_coverage in the response), or \"all\" (subject+sender+body).",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für search_emails. 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.

{
  "query": "launch checklist"
}