file_read

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

Lit un fichier texte brut à partir du système de fichiers local par son chemin absolu - l'outil principal par défaut pour lire un fichier texte local (à utiliser sauf si le fichier est un document PDF, Word, Excel ou PowerPoint, qui ont leurs propres lecteurs). Lit n'importe où sur ce Mac : domicile, disques externes, lecteurs cloud, /tmp - à une exception : les emplacements d'informations d'identification et d'identité (porte-clés, ~/.ssh, ~/.aws, connexions du navigateur, domicile d'un autre utilisateur, sauvegardes Time Machine) ne sont jamais lus. Prend en charge les types de fichiers .txt, .md, .csv, .json, .xml, .log, .yaml, .toml et les types de fichiers de code courants ; détecte automatiquement UTF-8 avec le repli Latin-1/Windows-1252. Pour les fichiers dans OneDrive, utilisez onedrive_read_file, dans Google Drive gdrive_read_file ; pour PDFs pdf_read, Word word_read, Excel excel_read.

Entrées requises

path

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": {
    "max_bytes": {
      "description": "Maximum bytes to read (default 1 MB, max 10 MB)",
      "type": "integer"
    },
    "offset": {
      "description": "Start reading at this byte offset (default 0)",
      "type": "integer"
    },
    "path": {
      "description": "Absolute path to the file",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

Exemple documentaire

Exemple de documentation pour file_read. 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.

{
  "path": "/Users/demo/Documents/meeting-notes.txt"
}

Windows

Objectif

Lit un fichier en texte brut à partir du système de fichiers local par son chemin absolu - l'outil par défaut pour lire un fichier texte local (utilisez pdf_read/word_read/excel_read/ppt_read pour ces types de documents, onedrive_read_file / gdrive_read_file pour le stockage dans le cloud). Le chemin doit être dans un dossier autorisé (le répertoire personnel par défaut ; étendre via la clé de configuration fs_allowed_roots). Prend en charge offset/max_bytes pour les lectures fragmentées de fichiers volumineux.

Entrées requises

path

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": {
    "max_bytes": {
      "description": "Maximum bytes to read (default 1 MB, max 10 MB).",
      "type": "integer"
    },
    "offset": {
      "description": "Start reading at this byte offset (default 0).",
      "type": "integer"
    },
    "path": {
      "description": "Absolute path to the file (a leading ~ is expanded).",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

Exemple documentaire

{
  "path": "C:\\Users\\demo\\Documents\\meeting-notes.txt"
}