file_search

파일 및 Finder · macOS · Windows

효과: 읽기. 상태: 조건부 제공.

‘조건부 제공’은 도구가 버전, 플랫폼, 권한, 계정 또는 설정에 따라 달라질 수 있음을 뜻하며 모든 설치에서 활성화되었다는 의미는 아닙니다.

macOS

목적

루트 디렉터리에서 시작하여 이름이 부분 일치하는 파일과 폴더를 대소문자 구분 없이 검색합니다. 기본값은 홈 디렉터리입니다. 일치 항목의 경로, 유형과 크기를 반환합니다.

필수 입력

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

목적

루트 디렉터리에서 파일과 폴더 이름을 부분 일치 및 대소문자 구분 없이 재귀 검색합니다. 기본값은 홈 디렉터리입니다. 일치 항목의 경로, 유형과 크기를 반환합니다. 루트는 허용된 폴더 안에 있어야 합니다.

필수 입력

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).",
      "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"
}