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": {
    "force_download": {
      "description": "If the file is stored in the cloud and evicted from this Mac (dataless), request the download and wait for it instead of failing. Off by default: a download can take minutes and use metered data, so it is the caller's decision.",
      "type": "boolean"
    },
    "max_bytes": {
      "description": "Maximum bytes to read (default 256 KB, max 2 MB). A longer file comes back with truncated=true and next_offset: pass next_offset as offset to continue.",
      "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). 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. Prend en charge offset/max_bytes pour les lectures fragmentées de fichiers volumineux : une lecture tronquée indique truncated=true et next_offset, l'offset à partir duquel poursuivre la lecture.

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": {
    "force_download": {
      "description": "For a cloud placeholder (OneDrive online-only) bigger than 25 MB: download it and wait up to 60 s. Smaller ones are downloaded on their own.",
      "type": "boolean"
    },
    "max_bytes": {
      "description": "Maximum bytes to read (default 256 KB, max 2 MB). A cut read says next_offset.",
      "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"
}