search_emails

macOS

Doel

Gebruik dit wanneer de gebruiker specifieke e-mails op deze Mac wil vinden (Apple Mail — elk account dat aan Mail.app is toegevoegd). Doorzoekt standaard onderwerp en afzender; geef scope="body" of scope="all" door om ook de berichttekst te doorzoeken (zie search_coverage in het antwoord — een zoekopdracht in de tekst kan gedeeltelijk zijn terwijl de lokale index nog wordt opgebouwd). Gebruik m365_search_emails voor een Microsoft 365-postvak dat NIET aan Mail.app is toegevoegd. BELANGRIJK: roep op machines met 2+ accounts aan met account=<name> (uit list_email_accounts). Zonder dit retourneert search_emails, wanneer de snelle index geen antwoord kan geven, de accountlijst in plaats van alle accounts te doorzoeken — alle accounts in één aanroep scannen heeft geen tijdslimiet en kan Mail ook voor andere verzoeken blokkeren. Bij precies 1 account verandert er niets.

Vereiste invoer

• query

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

Machtigingen en bevestiging

Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.

• Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

{
  "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"
}

Documentatievoorbeeld

Documentatievoorbeeld voor search_emails. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

{
  "query": "launch checklist"
}