finder_search
Ficheiros e Finder · macOS
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
Procura arquivos por nome em qualquer lugar deste Mac (usa mdfind/Spotlight); passe path= para definir o escopo para uma pasta. Os locais de credenciais e identidade são recusados.
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": {
"limit": {
"description": "Max results (default 50)",
"type": "integer"
},
"path": {
"description": "Limit search to this directory (optional)",
"type": "string"
},
"query": {
"description": "Filename or content to search for",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
}Exemplo documental
Exemplo de documentação para finder_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"
}