search_emails

macOS

Zweck

Verwenden Sie dies, wenn der Benutzer bestimmte E-Mails auf diesem Mac finden möchte (Apple Mail – jedes zu Mail.app hinzugefügte Konto). Sucht standardmäßig nach Betreff und Absender; Übergeben Sie scope="body" oder scope="all", um auch die Nachricht body zu durchsuchen (siehe search_coverage in der Antwort – eine body-Suche kann teilweise erfolgen, während der lokale Index noch erstellt wird). Für ein zu Mail.app hinzugefügtes Microsoft 365-Postfach NOT verwenden Sie m365_search_emails. IMPORTANT: auf Maschinen mit mehr als 2 Konten, call mit account=<name> (von list_email_accounts). Ohne sie und wenn der schnelle Index nicht antworten kann, gibt search_emails die Kontoliste zurück, anstatt sie zu scannen. Das Scannen jedes Kontos in einem call ist zeitlich unbegrenzt und kann E-Mails 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": {
      "type": "string"
    },
    "limit": {
      "default": "20",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "mailbox": {
      "type": "string"
    },
    "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"
}