file_read

Файлы и Finder · macOS · Windows

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

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

macOS

Назначение

Читает текстовый файл по абсолютному пути — основной инструмент для локальных текстовых файлов, кроме PDF, Word, Excel и PowerPoint, у которых есть отдельные средства чтения. Читает на этом Mac в домашней папке, внешних дисках, облачных каталогах и /tmp, кроме keychains, ~/.ssh, ~/.aws, входов браузера, домашней папки другого пользователя и резервных копий Time Machine. Поддерживает .txt, .md, .csv, .json, .xml, .log, .yaml, .toml и распространенный код, автоматически определяя UTF-8 с резервом Latin-1/Windows-1252. Для OneDrive используйте onedrive_read_file, Google Drive — gdrive_read_file, для PDF — pdf_read, Word — word_read, Excel — excel_read.

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

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

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

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

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

Windows

Назначение

Читает текстовый файл из локальной файловой системы по абсолютному пути — стандартный инструмент для чтения локального текстового файла (для соответствующих типов документов используйте pdf_read/word_read/excel_read/ppt_read, для облачных хранилищ — onedrive_read_file / gdrive_read_file). Читает в любом месте этого PC, кроме расположений учетных и идентификационных данных (логины браузеров, ключи SSH и облачных сервисов, хранилища учетных данных Windows, профиль другого пользователя), которые никогда не читаются. Поддерживает offset/max_bytes для чтения больших файлов частями: при обрезанном чтении сообщаются truncated=true и next_offset — смещение, с которого следует продолжить чтение.

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

path

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

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

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

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

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