Saltar al contenido
Todas las herramientas

file_read

Archivos y Finder · macOS · Windows

Efecto: lectura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Lee un archivo de texto sin formato del sistema de archivos local por su ruta (`path`) absoluta: la herramienta principal predeterminada para leer un archivo de texto local (úsela a menos que el archivo sea un documento PDF, Word, Excel o PowerPoint, que tienen sus propios lectores). Lee en cualquier lugar de esta Mac (casa, discos externos, unidades en la nube, /tmp) con una excepción: las ubicaciones de credenciales e identidades (llaveros, ~/.ssh, ~/.aws, inicios de sesión en el navegador, la casa de otro usuario, copias de seguridad de Time Machine) nunca se leen. Admite tipos de archivos de código común.txt,.md,.csv,.json,.xml,.log,.yaml,.toml; detecta automáticamente UTF -8 con respaldo Latin-1/Windows-1252. Para archivos en OneDrive use onedrive_read_file, en Google Drive gdrive_read_file; para archivos PDF pdf_read, Word word_read, Excel excel_read.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

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

Ejemplo documental

Ejemplo de documentación para file_read. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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

Windows

Propósito

Lee un archivo de texto sin formato del sistema de archivos local por su ruta (`path`) absoluta: la herramienta predeterminada para leer un archivo de texto local (use pdf_read / word_read / excel_read / ppt_read para esos tipos de documentos, onedrive_read_file / gdrive_read_file para almacenamiento en la nube). Lee en cualquier ubicación de este PC, excepto las ubicaciones de credenciales e identidad (inicios de sesión del navegador, claves SSH y de la nube, almacenes de credenciales de Windows, el perfil de otro usuario), que nunca se leen. Admite offset/max_bytes para lecturas fragmentadas de archivos grandes: una lectura cortada indica truncated=true y next_offset, el offset desde el que continuar la lectura.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

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

Ejemplo documental

Ejemplo de documentación para file_read. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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