file_search

Dateien und Finder · 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

Sucht ausgehend von einem Stammverzeichnis nach Dateien und Ordnern nach Namen (ohne Berücksichtigung der Groß-/Kleinschreibung, teilweise Übereinstimmung). Standardmäßig wird das Home-Verzeichnis verwendet. Gibt passende Elemente mit Pfad, Typ und Größe zurück.

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.

Kanonisches technisches Schema auf Englisch — macOS

{
  "properties": {
    "file_type": {
      "description": "Filter by extension, e.g. 'pdf', 'docx', 'xlsx'. Omit for all types.",
      "type": "string"
    },
    "max_results": {
      "description": "Maximum number of results to return. Default 50, max 200.",
      "type": "integer"
    },
    "query": {
      "description": "Filename pattern to search for (partial, case-insensitive)",
      "type": "string"
    },
    "root": {
      "description": "Root directory to search from. Defaults to home directory (~).",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für file_search. 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"
}

Windows