Todas as ferramentas

file_write

Ficheiros e Finder · macOS · Windows

Efeito: escrita. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Grava texto em um arquivo local — cria, substitui ou acrescenta. Para .txt/.md/.csv/.json/.log e qualquer arquivo de texto simples ou código. (Para Word, use word_create, Excel excel_create, PowerPoint ppt_create.) Grava em qualquer lugar neste Mac, com duas exceções: arquivos que sua máquina executa sozinha (arquivos de inicialização do shell, LaunchAgents, git hooks, configurações de cliente AI) e locais de credenciais nunca são gravados. A substituição de um arquivo existente requer confirm=true (a primeira chamada retorna uma visualização); append=true é adicionado ao final e nunca precisa de confirmação. Pastas pai ausentes são criadas.

Entradas obrigatórias

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Esquema técnico canónico em inglês — 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"
}

Exemplo documental

Exemplo de documentação para file_write. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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

Windows

Finalidade

Grava texto em um arquivo local — cria, substitui ou acrescenta. O caminho deve estar dentro de uma pasta permitida (diretório inicial por padrão; estender via chave de configuração fs_allowed_roots). Pastas pai ausentes são criadas. A substituição de um arquivo existente requer confirm=true (a primeira chamada retorna uma visualização); criar um novo arquivo e append=true nunca precisa ser confirmado.

Entradas obrigatórias

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Esquema técnico canónico em inglês — 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"
}

Exemplo documental

Exemplo de documentação para file_write. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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