모든 도구

excel_read

문서 · macOS · Windows

효과: 읽기. 상태: 조건부 제공.

‘조건부 제공’은 도구가 버전, 플랫폼, 권한, 계정 또는 설정에 따라 달라질 수 있음을 뜻하며 모든 설치에서 활성화되었다는 의미는 아닙니다.

macOS

목적

Excel 스프레드시트(.xlsx 파일)에서 데이터를 읽습니다. 첫 행은 `headers`로, 나머지 데이터 행은 `rows`로 반환합니다. excel_create의 `headers`/`rows` 매개변수와 대응하므로 읽기→만들기 왕복 시 행 0을 수동으로 처리할 필요가 없습니다.

필수 입력

입력 이름은 도구가 요구하는 정확한 형태로 유지됩니다. 영문 정식 기술 정의는 아래 펼칠 수 있는 스키마에 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 없습니다. 이는 무단 작업을 허용하지 않습니다. 효과를 검토하고 승인을 받으세요.

영문 정식 기술 스키마 — 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"
}

문서 예시

excel_read 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.

{
  "path": "/Users/demo/Documents/launch-checklist.xlsx"
}

Windows

목적

Excel(.xlsx) 파일에서 데이터를 읽고 시트와 셀 값을 반환합니다.

필수 입력

입력 이름은 도구가 요구하는 정확한 형태로 유지됩니다. 영문 정식 기술 정의는 아래 펼칠 수 있는 스키마에 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 없습니다. 이는 무단 작업을 허용하지 않습니다. 효과를 검토하고 승인을 받으세요.

영문 정식 기술 스키마 — 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"
}

문서 예시

excel_read 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.

{
  "path": "C:\\Users\\demo\\Documents\\launch-checklist.xlsx"
}