file_read

ファイルと Finder · macOS · Windows

効果: 読み取り. 状態: 条件付き提供.

「条件付き提供」は、バージョン、プラットフォーム、権限、アカウント、設定に依存する可能性を示し、すべての環境で有効という意味ではありません。

macOS

目的

絶対パスを指定して、ローカルファイルシステム上のプレーンテキストファイルを読み取ります。ローカルのテキストファイルを読むための主要かつ既定のツールです（PDF、Word、Excel、PowerPoint 文書には専用リーダーがあるため、それ以外ではこのツールを使用します）。この Mac 上のホーム、外付けディスク、クラウドドライブ、/tmp を含む任意の場所を読めますが、認証情報や本人確認情報の保存場所（キーチェーン、~/.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、Word、Excel、PowerPoint 文書には pdf_read/word_read/excel_read/ppt_read を、クラウドストレージには onedrive_read_file / gdrive_read_file を使用します）。パスは許可されたフォルダ内（既定ではホームディレクトリ）でなければならず、fs_allowed_roots 設定キーで拡張できます。.txt、.md、.csv、.json、.xml、.log、.yaml、.toml、および一般的なコードファイル形式に対応します。大きなファイルは 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"
}