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

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

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

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

Windows

Назначение

Читает текстовый файл по абсолютному пути — стандартный инструмент, кроме документов, для которых используются pdf_read/word_read/excel_read/ppt_read, onedrive_read_file или gdrive_read_file. Путь должен находиться в разрешенной папке; список расширяется через fs_allowed_roots. Поддерживает offset/max_bytes для чтения больших файлов частями.

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

path

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

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

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

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

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