모든 도구

file_write

파일 및 Finder · macOS · Windows

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

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

macOS

목적

로컬 파일에 텍스트를 써서 만들기, 덮어쓰기 또는 추가를 수행합니다. .txt/.md/.csv/.json/.log와 모든 일반 텍스트 또는 코드 파일을 지원합니다. Word에는 word_create, Excel에는 excel_create, PowerPoint에는 ppt_create를 사용하세요. 이 Mac의 어디에나 쓸 수 있지만 머신이 자체 실행하는 파일(셸 시작 파일, LaunchAgents, git hooks, AI 클라이언트 설정)과 인증 정보 위치에는 절대 쓰지 않습니다. 기존 파일을 덮어쓰려면 confirm=true가 필요하며 첫 호출은 미리보기를 반환합니다. append=true는 끝에 추가하며 확인이 필요 없습니다. 누락된 상위 폴더는 만들어집니다.

필수 입력

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

권한 및 확인

스키마에 명시적 확인 매개변수가 있습니다. 미리보기를 검토하고 플랫폼 계약에 따라 실제 작업을 승인하세요.

영문 정식 기술 스키마 — macOS
{
  "properties": {
    "append": {
      "description": "Append to the end instead of overwriting (default false)",
      "type": "boolean"
    },
    "confirm": {
      "description": "Required (true) to OVERWRITE an existing file. Not needed to create a new file or to append.",
      "type": "boolean"
    },
    "content": {
      "description": "Text content to write",
      "type": "string"
    },
    "path": {
      "description": "Absolute path to the file to write",
      "type": "string"
    }
  },
  "required": [
    "path",
    "content"
  ],
  "type": "object"
}

문서 예시

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

{
  "confirm": false,
  "content": "Meeting agenda: review the launch checklist.",
  "path": "/Users/demo/Documents/meeting-notes.txt"
}

Windows

목적

로컬 파일에 텍스트를 써서 만들기, 덮어쓰기 또는 추가를 수행합니다. 경로는 허용된 폴더 안에 있어야 하며 기본값은 홈 디렉터리이고 fs_allowed_roots 설정 키로 확장할 수 있습니다. 누락된 상위 폴더는 만들어집니다. 기존 파일을 덮어쓰려면 confirm=true가 필요하며 첫 호출은 미리보기를 반환합니다. 새 파일 생성과 append=true에는 확인이 필요 없습니다.

필수 입력

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

권한 및 확인

스키마에 명시적 확인 매개변수가 있습니다. 미리보기를 검토하고 플랫폼 계약에 따라 실제 작업을 승인하세요.

영문 정식 기술 스키마 — Windows
{
  "properties": {
    "append": {
      "description": "Append to the end instead of overwriting (default false).",
      "type": "boolean"
    },
    "confirm": {
      "description": "Required (true) to OVERWRITE an existing file. Not needed to create a new file or to append.",
      "type": "boolean"
    },
    "content": {
      "description": "Text content to write.",
      "type": "string"
    },
    "path": {
      "description": "Absolute path to the file to write.",
      "type": "string"
    }
  },
  "required": [
    "path",
    "content"
  ],
  "type": "object"
}

문서 예시

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

{
  "confirm": false,
  "content": "Meeting agenda: review the launch checklist.",
  "path": "C:\\Users\\demo\\Documents\\meeting-notes.txt"
}