Tutti gli strumenti

file_write

File e Finder · macOS · Windows

Effetto: scrittura. Stato: disponibilità condizionata.

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

macOS

Scopo

Scrive testo in un file locale: crea, sovrascrivi o aggiungi. Per .txt/.md/.csv/.json/.log e qualsiasi file di testo semplice o di codice. (Per Word utilizzare word_create, Excel excel_create, PowerPoint ppt_create.) Scrive ovunque su questo Mac, con due eccezioni: i file che il tuo computer esegue da solo (file di avvio della shell, LaunchAgent, hook git, configurazioni client AI) e le posizioni delle credenziali non vengono mai scritte. La sovrascrittura di un file esistente richiede confirm=true (la prima chiamata restituisce invece un'anteprima); append=true aggiunge alla fine e non necessita mai di conferma. Vengono create le cartelle principali mancanti.

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 dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Schema tecnico canonico in inglese — macOS
{
  "properties": {
    "append": {
      "description": "Append to the end instead of overwriting (default false)",
      "type": "boolean"
    },
    "confirm": {
      "description": "Required (true) to OVERWRITE an existing file. Not needed to create a new file or to append.",
      "type": "boolean"
    },
    "content": {
      "description": "Text content to write",
      "type": "string"
    },
    "path": {
      "description": "Absolute path to the file to write",
      "type": "string"
    }
  },
  "required": [
    "path",
    "content"
  ],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per file_write. 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.

{
  "confirm": false,
  "content": "Meeting agenda: review the launch checklist.",
  "path": "/Users/demo/Documents/meeting-notes.txt"
}

Windows

Scopo

Scrive testo in un file locale: crea, sovrascrivi o aggiungi. Il percorso deve trovarsi all'interno di una cartella consentita (directory home per impostazione predefinita; estensione tramite chiave di configurazione fs_allowed_roots). Vengono create le cartelle principali mancanti. La sovrascrittura di un file esistente richiede confirm=true (la prima chiamata restituisce invece un'anteprima); creando un nuovo file e append=true non è mai necessario confermare.

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 dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Schema tecnico canonico in inglese — Windows
{
  "properties": {
    "append": {
      "description": "Append to the end instead of overwriting (default false).",
      "type": "boolean"
    },
    "confirm": {
      "description": "Required (true) to OVERWRITE an existing file. Not needed to create a new file or to append.",
      "type": "boolean"
    },
    "content": {
      "description": "Text content to write.",
      "type": "string"
    },
    "path": {
      "description": "Absolute path to the file to write.",
      "type": "string"
    }
  },
  "required": [
    "path",
    "content"
  ],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per file_write. 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.

{
  "confirm": false,
  "content": "Meeting agenda: review the launch checklist.",
  "path": "C:\\Users\\demo\\Documents\\meeting-notes.txt"
}