excel_read
Documentos · 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
Lê dados de uma planilha Excel (arquivo .xlsx). Retorna a primeira linha como `headers` e os dados restantes rows como `rows` - espelhando os parâmetros `headers`/`rows` de excel_create, portanto, uma viagem de ida e volta de leitura → criação não precisa de manipulação manual da linha 0.
Entradas obrigatórias
path
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": {
"force_download": {
"description": "If the file is stored in the cloud and evicted from this Mac (dataless), request the download and wait for it instead of failing. Off by default: a download can take minutes and use metered data, so it is the caller's decision.",
"type": "boolean"
},
"max_rows": {
"description": "Max rows to return (default 100)",
"type": "integer"
},
"path": {
"description": "Absolute path to the .xlsx file",
"type": "string"
},
"sheet_name": {
"description": "Sheet name to read (optional, reads first sheet)",
"type": "string"
}
},
"required": [
"path"
],
"type": "object"
}Exemplo documental
Exemplo de documentação para excel_read. 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.
{
"path": "/Users/demo/Documents/launch-checklist.xlsx"
}Windows
Finalidade
Lê dados de um arquivo Excel (.xlsx). Retorna planilhas e valores de células.
Entradas obrigatórias
path
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": {
"max_rows": {
"description": "Maximum rows to return (default: 100)",
"type": "number"
},
"path": {
"description": "Absolute path to the .xlsx file",
"type": "string"
},
"sheet_name": {
"description": "Name of the sheet to read (default: first sheet)",
"type": "string"
}
},
"required": [
"path"
],
"type": "object"
}Exemplo documental
Exemplo de documentação para excel_read. 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.
{
"path": "C:\\Users\\demo\\Documents\\launch-checklist.xlsx"
}