Tous les outils

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 les fichiers et les dossiers par nom (insensible à la casse, correspondance partielle) à 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.

Entrées requises

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.

Schéma technique canonique en anglaismacOS
{
  "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. La racine doit se trouver dans un dossier autorisé.

Entrées requises

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.

Schéma technique canonique en anglaisWindows
{
  "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).",
      "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

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