file_search
Bestanden en Finder · macOS · Windows
Effect: lezen. Status: voorwaardelijk beschikbaar.
‘Voorwaardelijke beschikbaarheid’ betekent dat het hulpmiddel kan afhangen van versie, platform, machtigingen, account of configuratie. Het is niet in elke installatie actief.
macOS
Doel
Zoekt op naam naar bestanden en mappen (niet hoofdlettergevoelig, gedeeltelijke overeenkomst) vanaf een hoofdmap. Standaard de thuismap. Geeft overeenkomende items terug met pad, type en grootte, het laatst gewijzigde eerst. Vergrendelingsbestanden van Office (~$name) worden nooit teruggegeven, en niets onder ~/Library, tenzij root erbinnen wijst.
Vereiste invoer
query
De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.
Machtigingen en bevestiging
Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.
- Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.
Canoniek technisch schema in het Engels — 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"
}Documentatievoorbeeld
Documentatievoorbeeld voor file_search. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.
{
"query": "launch checklist"
}Windows
Doel
Zoekt vanaf een hoofddirectory recursief op naam naar bestanden en mappen (hoofdletterongevoelig, gedeeltelijke overeenkomst). Standaard wordt de thuismap gebruikt. Geeft de overeenkomende items terug met pad, type en grootte. Leest overal op deze PC, behalve op locaties met inloggegevens en identiteitsgegevens (browseraanmeldingen, SSH- en cloudsleutels, Windows-referentieopslag, het profiel van een andere gebruiker); die worden nooit gelezen.
Vereiste invoer
query
De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.
Machtigingen en bevestiging
Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.
- Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.
Canoniek technisch schema in het Engels — 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"
}Documentatievoorbeeld
Documentatievoorbeeld voor file_search. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.
{
"query": "launch checklist"
}