file_search
File e Finder · macOS · Windows
Effetto: lettura. Stato: disponibilità condizionata.
«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.
macOS
Scopo
Cerca file e cartelle per nome (senza distinzione tra maiuscole e minuscole, corrispondenza parziale) a partire da una directory principale. Il valore predefinito è la directory home. Restituisce gli elementi corrispondenti con percorso, tipo e dimensione.
Input obbligatori
query
I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.
Autorizzazioni e conferma
Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.
- Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.
Schema tecnico canonico in inglese — 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"
}Esempio documentale
Esempio di documentazione per file_search. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.
{
"query": "launch checklist"
}Windows
Scopo
Cerca file e cartelle in base al nome (senza distinzione tra maiuscole e minuscole, corrispondenza parziale) in modo ricorsivo da una directory principale. Il valore predefinito è la directory home. Restituisce gli elementi corrispondenti con percorso, tipo e dimensione. La radice deve trovarsi all'interno di una cartella consentita.
Input obbligatori
query
I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.
Autorizzazioni e conferma
Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.
- Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.
Schema tecnico canonico in inglese — 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"
}Esempio documentale
Esempio di documentazione per file_search. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.
{
"query": "launch checklist"
}