file_search

Fichiers et Finder · macOS · Windows

Effet: lecture. État: disponibilité conditionnelle.

«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.

macOS

Objectif

Recherche des fichiers et dossiers par nom (insensible à la casse, correspondance partielle) à partir d’un répertoire racine. Le dossier personnel par défaut. Renvoie les éléments correspondants avec leur chemin, leur type et leur taille, les plus récemment modifiés en premier. Les fichiers de verrouillage Office (~$name) ne sont jamais renvoyés, et rien sous ~/Library ne l’est sauf si root pointe à l’intérieur.

Entrées requises

query

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — 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"
}

Exemple documentaire

Exemple de documentation pour file_search. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

{
  "query": "launch checklist"
}

Windows

Objectif

Recherche les fichiers et les dossiers par nom (insensible à la casse, correspondance partielle) de manière récursive à partir d'un répertoire racine. La valeur par défaut est le répertoire personnel. Renvoie les éléments correspondants avec le chemin, le type et la taille. Lit n'importe où sur ce PC, à l'exception des emplacements d'identifiants et d'identité (connexions de navigateur, clés SSH et cloud, magasins d'identifiants Windows, profil d'un autre utilisateur), qui ne sont jamais lus.

Entrées requises

query

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — Windows

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

Exemple documentaire

{
  "query": "launch checklist"
}