file_search
Ficheiros e Finder · macOS · Windows
Efeito: leitura. Estado: disponibilidade condicionada.
«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.
macOS
Finalidade
Pesquisa arquivos e pastas por nome (correspondência parcial, sem distinção entre maiúsculas e minúsculas) começando em um diretório raiz. O padrão é o diretório inicial. Retorna itens correspondentes com caminho, tipo e tamanho.
Entradas obrigatórias
query
Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.
Permissões e confirmação
O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.
- Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.
Esquema técnico canónico em 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"
}Exemplo documental
Exemplo de documentação para file_search. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.
{
"query": "launch checklist"
}Windows
Finalidade
Pesquisa arquivos e pastas por nome (sem distinção entre maiúsculas e minúsculas, correspondência parcial) recursivamente em um diretório raiz. O padrão é o diretório inicial. Retorna itens correspondentes com caminho, tipo e tamanho. A raiz deve estar dentro de uma pasta permitida.
Entradas obrigatórias
query
Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.
Permissões e confirmação
O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.
- Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.
Esquema técnico canónico em 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).",
"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"
}Exemplo documental
Exemplo de documentação para file_search. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.
{
"query": "launch checklist"
}