파일

파일은 에이전트가 실행 중에 읽을 수 있는 문서로, 지침, 참고 데이터, 예시 등이 해당합니다. 조직에 한 번 업로드해 두고, 실행이나 워크플로마다 어떤 파일을 어느 위치에 마운트할지 선택합니다.

파일 업로드

파일은 대시보드의 파일에서, POST /v1/files로, 또는 ephemeral files upload로 업로드합니다. 파일마다 file_9c41… 같은 ID와 이름이 부여됩니다. 이름은 guides/refunds.md처럼 상대 경로이며 최대 240자입니다.

이미 있는 이름으로 다시 업로드하면 새 ID를 가진 새 파일이 추가됩니다. 파일 목록에는 이름별로 가장 최근에 업로드한 파일이 표시됩니다. 이전 업로드는 삭제하기 전까지 ID로 계속 사용할 수 있습니다.

실행에 파일 제공

실행의 files 배열에 파일을 나열합니다. 각 항목은 파일 하나를 원하는 path에 마운트합니다. 내용을 지정하는 방법은 세 가지입니다.

업로드한 파일은 path의 기본값이 파일 이름입니다. 인라인 파일은 반드시 지정해야 합니다. 경로는 상대 경로여야 하며 실행 안에서 고유해야 합니다.

"files": [
  { "file": "guides/refunds.md", "path": "instructions/refunds.md" },
  { "file": "file_9c41d2a07be35f1e8a6c0d4b9e2f7a13" },
  { "path": "context.md", "content": "The customer is on the annual plan." }
]

microVM 내부

워커는 파일을 읽기 전용 디렉터리로 받고, 각 파일의 경로를 안내받습니다. 파일을 변경할 수는 없습니다. 워커의 작업 디렉터리는 별도의 임시 공간입니다. 그곳에 쓴 내용은 microVM이 폐기될 때 사라지므로, 파일이 실행 간에 공유되는 일은 없습니다. 실행의 결과는 텍스트 출력입니다.

실행은 대기열을 떠날 때 파일 내용을 읽습니다. 해당 파일을 사용하는 실행이 아직 대기 중일 때 파일을 삭제하면 그 실행은 실패합니다.

한도

업로드, 다운로드, 이름 변경, 삭제는 파일 API를 참고하세요.