file_read

Bestanden en Finder · macOS · Windows

Effect: lezen. Status: voorwaardelijk beschikbaar.

‘Voorwaardelijke beschikbaarheid’ betekent dat het hulpmiddel kan afhangen van versie, platform, machtigingen, account of configuratie. Het is niet in elke installatie actief.

macOS

Doel

Leest een tekstbestand via zijn absolute pad uit het lokale bestandssysteem; dit is de standaardtool, behalve voor PDF-, Word-, Excel- en PowerPoint-documenten met eigen lezers. Leest overal op deze Mac, inclusief externe schijven, cloudmappen en /tmp, behalve afgeschermde locaties zoals keychains, ~/.ssh, ~/.aws, browserlogins, andere thuismappen en Time Machine-back-ups. Ondersteunt .txt, .md, .csv, .json, .xml, .log, .yaml, .toml en gangbare code. Voor OneDrive gebruik je onedrive_read_file, voor Google Drive gdrive_read_file, en voor documenten pdf_read, word_read of excel_read.

Vereiste invoer

path

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

Machtigingen en bevestiging

Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.

Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

Canoniek technisch schema in het Engels — 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"
}

Documentatievoorbeeld

Documentatievoorbeeld voor file_read. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

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

Windows

Doel

Leest een bestand met platte tekst via zijn absolute pad uit het lokale bestandssysteem — de standaardtool voor het lezen van een lokaal tekstbestand (gebruik pdf_read/word_read/excel_read/ppt_read voor die documenttypen en onedrive_read_file / gdrive_read_file voor cloudopslag). Leest overal op deze PC, behalve op locaties met inloggegevens en identiteitsgegevens (browseraanmeldingen, SSH- en cloudsleutels, Windows-referentieopslag, het profiel van een andere gebruiker); die worden nooit gelezen. Ondersteunt offset/max_bytes voor het in delen lezen van grote bestanden: een afgekapte leesactie meldt truncated=true en next_offset, de offset vanaf waar verder moet worden gelezen.

Vereiste invoer

path

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

Machtigingen en bevestiging

Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.

Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

Canoniek technisch schema in het Engels — 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"
}

Documentatievoorbeeld

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