file_search

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ç

Bir kök dizinden başlayarak dosya ve klasörleri ada göre (büyük/küçük harfe duyarsız, kısmi eşleşme) arar. Varsayılan olarak ana dizini kullanır. Eşleşen öğeleri yol, tür ve boyut bilgileriyle döndürür.

Zorunlu girdiler

query

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.

Yalnızca kullanıcının bu platformda yetkilendirdiği uygulamaları, hesapları ve kaynakları kullanın. Bağlantı ve izin gereksinimleri için bu aracın platforma özgü açıklamasına bakın; bu katalog ek OAuth kapsamları veya OS yetkileri bulunduğunu ileri sürmez.

İngilizce kanonik teknik şema — macOS

{
  "properties": {
    "file_type": {
      "description": "Filter by extension, e.g. 'pdf', 'docx', 'xlsx'. Omit for all types.",
      "type": "string"
    },
    "max_results": {
      "description": "Maximum number of results to return. Default 50, max 200.",
      "type": "integer"
    },
    "query": {
      "description": "Filename pattern to search for (partial, case-insensitive)",
      "type": "string"
    },
    "root": {
      "description": "Root directory to search from. Defaults to home directory (~).",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Belge örneği

file_search 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.

{
  "query": "launch checklist"
}

Windows