file_search

ファイルと Finder · macOS · Windows

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

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

macOS

目的

ルートディレクトリを起点に、名前（大文字小文字を区別せず、部分一致）でファイルとフォルダを検索します。既定はホームディレクトリです。一致した項目を、パス、種類、サイズとともに、更新日時の新しい順に返します。Office のロックファイル（~$name）は返されません。root が ~/Library 内を指していない限り、~/Library 配下は何も返されません。

必須入力

query

入力名はツールが要求する正確な形式のままです。英語の正規技術定義は下の展開可能なスキーマにあります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

英語の正規技術スキーマ — 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"
}

ドキュメント例

file_search のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

{
  "query": "launch checklist"
}

Windows

目的

ルートディレクトリから、名前の一部が一致するファイルとフォルダを大文字小文字を区別せず再帰的に検索します。既定のルートはホームディレクトリです。一致した項目のパス、種類、サイズを返します。この PC 上のどこでも読み取れますが、資格情報と ID 情報の保存場所（ブラウザのログイン情報、SSH キーとクラウドのキー、Windows の資格情報ストア、他のユーザーのプロファイル）は例外で、決して読み取りません。

必須入力

query

入力名はツールが要求する正確な形式のままです。英語の正規技術定義は下の展開可能なスキーマにあります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

英語の正規技術スキーマ — Windows

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

ドキュメント例

{
  "query": "launch checklist"
}