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": {
    "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"
}

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). La ruta debe estar dentro de una carpeta permitida (el directorio de inicio de forma predeterminada; extender mediante la clave de configuración fs_allowed_roots). Admite offset/ max_bytes para lecturas fragmentadas de archivos grandes.

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": {
    "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"
}

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"
}