Todas as ferramentas

file_read

Ficheiros e Finder · macOS · Windows

Efeito: leitura. 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

Lê um arquivo de texto simples do sistema de arquivos local por seu caminho absoluto — a principal ferramenta padrão para ler um arquivo de texto local (use-a a menos que o arquivo seja um documento PDF, Word, Excel ou PowerPoint, que possuem seus próprios leitores). Lê em qualquer lugar neste Mac – casa, discos externos, unidades de nuvem, /tmp – com uma exceção: locais de credenciais e identidade (chaveiros, ~/.ssh, ~/.aws, logins de navegador, casa de outro usuário, backups do Time Machine) nunca são lidos. Suporta .txt, .md, .csv, .json, .xml, .log, .yaml, .toml e tipos de arquivos de código comuns; detecta automaticamente UTF-8 com fallback Latin-1/Windows-1252. Para arquivos no OneDrive use onedrive_read_file, no Google Drive gdrive_read_file; para PDFs pdf_read, Word word_read, Excel excel_read.

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 não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

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

Exemplo documental

Exemplo de documentação para file_read. 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.

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

Windows

Finalidade

Lê um arquivo de texto simples do sistema de arquivos local por seu caminho absoluto — a ferramenta padrão para ler um arquivo de texto local (use pdf_read/word_read/excel_read/ppt_read para esses tipos de documentos, onedrive_read_file/gdrive_read_file para armazenamento em nuvem). O caminho deve estar dentro de uma pasta permitida (o diretório inicial por padrão; estendido por meio da chave de configuração fs_allowed_roots). Suporta offset/max_bytes para leituras fragmentadas de arquivos grandes.

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 não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

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

Exemplo documental

Exemplo de documentação para file_read. 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.

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