file_search

Archivos y Finder · macOS · Windows

Efecto: lectura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Busca archivos y carpetas por nombre (sin distinguir mayúsculas, coincidencia parcial) a partir de un directorio raíz. Por defecto, la carpeta personal. Devuelve los elementos coincidentes con su ruta, tipo y tamaño, los modificados más recientemente primero. Los archivos de bloqueo de Office (~$name) nunca se devuelven, y nada de ~/Library se devuelve a menos que root apunte dentro de ella.

Entradas obligatorias

query

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

Ejemplo de documentación para file_search. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "query": "launch checklist"
}

Windows

Propósito

Busca archivos y carpetas por nombre (no distingue entre mayúsculas y minúsculas, coincidencia parcial) de forma recursiva desde un directorio raíz (`root`). El valor predeterminado es el directorio de inicio. Devuelve elementos coincidentes con ruta, tipo y tamaño. Lee en cualquier ubicación de este PC, excepto las ubicaciones de credenciales e identidad (inicios de sesión del navegador, claves SSH y de la nube, almacenes de credenciales de Windows, el perfil de otro usuario), que nunca se leen.

Entradas obligatorias

query

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

{
  "query": "launch checklist"
}