excel_read

Документы · macOS · Windows

Эффект: чтение. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Читает данные из таблицы Excel (.xlsx). Возвращает первую строку как `headers`, остальные как `rows`, в соответствии с параметрами excel_create; поэтому цикл чтение→создание не требует ручной обработки строки 0.

Обязательные входные данные

path

Имена сохранены в точности как их требует инструмент. Канонические технические определения на английском находятся в раскрываемой схеме ниже.

Разрешения и подтверждение

Схема не объявляет явного параметра подтверждения. Это не разрешает действовать без согласия: проверьте эффект и получите разрешение.

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — 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_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"
}

Пример для документации

Пример документации для excel_read. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

{
  "path": "/Users/demo/Documents/launch-checklist.xlsx"
}

Windows

Назначение

Читает файл Excel (.xlsx). Возвращает листы и значения ячеек.

Обязательные входные данные

path

Разрешения и подтверждение

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — Windows

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

Пример для документации

{
  "path": "C:\\Users\\demo\\Documents\\launch-checklist.xlsx"
}