Tutti gli strumenti

file_read

File e Finder · macOS · Windows

Effetto: lettura. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Legge un file di testo semplice dal filesystem locale in base al suo percorso assoluto: lo strumento principale predefinito per leggere un file di testo locale (usalo a meno che il file non sia un documento PDF, Word, Excel o PowerPoint, che ha i propri lettori). Legge ovunque su questo Mac (casa, dischi esterni, unità cloud, /tmp) con un'eccezione: le posizioni delle credenziali e delle identità (portachiavi, ~/.ssh, ~/.aws, accessi al browser, casa di un altro utente, backup di Time Machine) non vengono mai lette. Supporta .txt, .md, .csv, .json, .xml, .log, .yaml, .toml e tipi di file di codice comuni; rileva automaticamente UTF-8 con fallback Latin-1/Windows-1252. Per i file in OneDrive utilizzare onedrive_read_file, in Google Drive gdrive_read_file; per PDF pdf_read, Word word_read, Excel excel_read.

Input obbligatori

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per file_read. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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

Windows

Scopo

Legge un file di testo semplice dal filesystem locale in base al suo percorso assoluto: lo strumento predefinito per leggere un file di testo locale (usa pdf_read/word_read/excel_read/ppt_read per questi tipi di documenti, onedrive_read_file / gdrive_read_file per l'archiviazione nel cloud). Il percorso deve trovarsi all'interno di una cartella consentita (la directory home per impostazione predefinita; estesa tramite la chiave di configurazione fs_allowed_roots). Supporta offset/max_bytes per letture in blocchi di file di grandi dimensioni.

Input obbligatori

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per file_read. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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