İçeriğe geç
Tüm araçlar

file_read

Dosyalar ve Finder · macOS · Windows

Etki: okuma. Durum: koşullu kullanılabilir.

“Koşullu kullanılabilirlik”, aracın sürüme, platforma, izinlere, hesaba veya yapılandırmaya bağlı olabileceğini belirtir. Her kurulumda etkin olduğu anlamına gelmez.

macOS

Amaç

Yerel dosya sisteminden mutlak yoluyla bir düz metin dosyasını okur; yerel metin dosyasını okumak için birincil, varsayılan araçtır (kendi okuyucuları olan PDF, Word, Excel veya PowerPoint belgeleri dışında bunu kullanın). Bu Mac'te ana dizin, harici diskler, bulut sürücüleri ve /tmp dahil her yerden okur; tek istisna kimlik bilgisi ve kimlik konumlarıdır (keychains, ~/.ssh, ~/.aws, browser logins, başka bir kullanıcının ana dizini, Time Machine yedekleri) ve bunlar asla okunmaz. .txt, .md, .csv, .json, .xml, .log, .yaml, .toml ve yaygın kod dosyalarını destekler; Latin-1/Windows-1252 geri dönüşüyle UTF-8'i otomatik algılar. OneDrive dosyaları için onedrive_read_file, Google Drive için gdrive_read_file; PDF'ler için pdf_read, Word için word_read, Excel için excel_read kullanın.

Zorunlu girdiler

Girdi adları aracın istediği biçimde aynen korunur. İngilizce kanonik teknik tanımlar aşağıdaki açılır şemadadır.

İzinler ve onay

Şema açık bir onay parametresi bildirmez. Bu, izinsiz işlem yapma yetkisi vermez; etkiyi inceleyin ve yetki alın.

İngilizce kanonik teknik şema — 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"
}

Belge örneği

file_read için örnek belge. Bu örneği çalıştırmayın. Gösterilen bağımsız değişkenler kurgusal bir veri kümesine aittir; gerçek bir çağrıdan önce gerçek tanıtıcıları bulun ve izin alın.

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

Windows

Amaç

Yerel dosya sisteminden mutlak yoluyla bir düz metin dosyasını okur; yerel metin dosyası okumak için varsayılan araçtır (bu belge türlerinde pdf_read/word_read/excel_read/ppt_read, bulut depolamada onedrive_read_file / gdrive_read_file kullanın). Bu PC'de her yeri okur; kimlik bilgisi ve kimlik konumları (tarayıcı oturum açma bilgileri, SSH ve bulut anahtarları, Windows kimlik bilgisi depoları, başka bir kullanıcının profili) hariçtir ve bunlar asla okunmaz. Büyük dosyaları parçalı okumak için offset/max_bytes destekler: kesilen bir okuma truncated=true ve okumaya devam edilecek konum olan next_offset değerini bildirir.

Zorunlu girdiler

Girdi adları aracın istediği biçimde aynen korunur. İngilizce kanonik teknik tanımlar aşağıdaki açılır şemadadır.

İzinler ve onay

Şema açık bir onay parametresi bildirmez. Bu, izinsiz işlem yapma yetkisi vermez; etkiyi inceleyin ve yetki alın.

İngilizce kanonik teknik şema — 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"
}

Belge örneği

file_read için örnek belge. Bu örneği çalıştırmayın. Gösterilen bağımsız değişkenler kurgusal bir veri kümesine aittir; gerçek bir çağrıdan önce gerçek tanıtıcıları bulun ve izin alın.

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