이식 가능한 샌드박스 스냅샷
에이전트는 샌드박스에서 작업을 완료한 후 샌드박스가 사라질 수 있습니다. 새로고침하거나 나중에 실행하면 빈 작업 공간에서 시작합니다. 이식 가능한 스냅샷은 완료된 파일을 영속성에 저장합니다. 나중에 실행하면 파일을 새 샌드박스로 복원합니다.
이 작업은 서버에서 실행됩니다. 클라이언트는 소유한 라우트를 호출합니다.
경로 선택
영속성부터 시작합니다. 그런 다음 해당 작업이 필요할 때만 제품 페이지를 추가합니다.
| 보유 항목 | 원하는 결과 | 필요한 페이지 |
|---|---|---|
| 아직 영속성이 없음 | 새로고침 후 파일이 돌아옴 | 새로고침 후 파일 유지 |
| 채팅 영속성이 이미 있음 | 새로고침 후 파일이 돌아옴 | 새로고침 후 파일 유지 |
| 스냅샷이 이미 연결됨 | 사용자가 한 버전을 표시함 | 이름이 지정된 버전 저장 |
| 스냅샷이 이미 연결됨 | 사용자가 한 버전에서 분기함 | 버전에서 분기 |
| 스냅샷이 이미 연결됨 | 분기하고 두 방향을 비교하는 제품 페이지 | 버전에서 분기 |
| 스냅샷이 이미 연결됨 | 사용자가 생성된 파일을 다운로드함 | 동결된 파일 전송 |
| 스냅샷이 이미 연결됨 | 에이전트가 이 스레드를 저장하거나 분기함 | 에이전트가 저장하고 분기하도록 허용 |
| 스냅샷이 이미 연결됨 | 일부 파일 또는 하나의 파일만 선택함 | 유지할 파일 선택 |
| 스냅샷이 이미 연결됨 | 시크릿, 기본 제외, 복원 안전성 | 스냅샷에 저장되는 항목 |
자동 저장 및 복원에는 구성 페이지만 필요합니다. 저장, 분기, 다운로드 및 파일 정책 페이지는 추가 항목입니다.
체크포인트에 포함되는 항목
터미널 실행이 성공하면 미들웨어는 영속성이 대화를 저장할 때까지 기다립니다. 그런 다음 스레드에 대한 체크포인트 하나를 기록합니다.
체크포인트에는 다음이 포함됩니다.
- 일반 작업 공간 파일
- 빈 디렉터리
- 이미 스레드에 속한 생성된 아티팩트
- 스레드에 대해 저장된 대화
파일 데이터와 아티팩트 데이터는 서로 분리된 콘텐츠 주소 지정 블롭 네임스페이스를 사용합니다. 동일한 파일 데이터는 하나의 파일 블롭을 공유합니다. 동일한 아티팩트 데이터는 하나의 아티팩트 블롭을 공유합니다. 사용되지 않은 블롭은 삭제할 때까지 유지됩니다.
나중에 실행할 때 파일을 복원하는 시점
나중에 실행하면 최신 체크포인트를 새 비공개 샌드박스에만 복원합니다. 복원은 부트스트랩 후, 훅 또는 하네스가 샌드박스를 확인하기 전에 실행됩니다.
실행 중인 재개된 샌드박스는 현재 파일을 유지합니다. 이식 가능한 스냅샷은 해당 샌드박스에 기록하지 않습니다. provider 네이티브 스냅샷은 부트스트랩을 더 빠르게 합니다. 수명 주기 및 스냅샷을 참조하세요.
이름이 지정된 체크포인트는 읽기 또는 선택한 포크에 계속 사용할 수 있습니다. 자동 복원에는 여전히 최신 체크포인트가 사용됩니다.
대화는 내구성 있는 메시지 저장소에서 가져옵니다. 샌드박스 저널은 실행 출력 로그입니다. 에이전트 출력을 재생해야 하는 경우 실행 저널을 참조하세요.
메서드를 호출하는 주체
createSandboxSnapshots 및 memorySandboxSnapshots는 하나의 객체를 반환합니다. 이 객체에는 save, fork, readArtifact가 있습니다. 세션이 스레드에 액세스할 수 있는지 확인한 후 서버에서 해당 메서드를 호출합니다.
체크포인트 id, 스레드 id 또는 아티팩트 id를 액세스 권한의 증거로 취급하지 마세요.