Todas las herramientas

excel_read

Documentos · 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 datos de una hoja de cálculo de Excel (archivo.xlsx). Devuelve la primera fila como `headers` y las filas de datos restantes como `rows`, lo que refleja los parámetros `headers` / `rows` de excel_create, por lo que un viaje de ida y vuelta de lectura→creación no necesita manejo manual de la fila 0.

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ésmacOS
{
  "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_rows": {
      "description": "Max rows to return (default 100)",
      "type": "integer"
    },
    "path": {
      "description": "Absolute path to the .xlsx file",
      "type": "string"
    },
    "sheet_name": {
      "description": "Sheet name to read (optional, reads first sheet)",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para excel_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/launch-checklist.xlsx"
}

Windows

Propósito

Lee datos de un archivo Excel (.xlsx). Devuelve hojas y valores de celda.

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ésWindows
{
  "properties": {
    "max_rows": {
      "description": "Maximum rows to return (default: 100)",
      "type": "number"
    },
    "path": {
      "description": "Absolute path to the .xlsx file",
      "type": "string"
    },
    "sheet_name": {
      "description": "Name of the sheet to read (default: first sheet)",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para excel_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\\launch-checklist.xlsx"
}