일상 업무

워크스페이스 Archibot 및 공유 드라이브

Console에서 공유 드라이브를 5개 탭에 걸쳐 관리합니다. 파일 탐색 및 편집, 폴더 생성, 증거 업로드, 범위 지정 Archibot 액세스 부여, 스테이징 복원 요청, 고객 드라이브 생성을 할 수 있습니다.

고객 관리자고객 구성원플랫폼 운영자

마지막 업데이트 2026년 6월 18일

공유 드라이브는 Archibot이 Chat, VS Code, API 세션, 워크스페이스, 검토, QA 전반에서 사용할 수 있는 영구 계정 스토리지입니다. 워크스페이스 편집기 내부가 아니라 Console의 공유 드라이브 경로에서 관리합니다. 개인 드라이브는 사용자 본인으로 범위가 한정되며, 고객 드라이브는 계정 관리자가 생성하고 관리합니다.

이 가이드는 Console 화면을 처음부터 끝까지 다룹니다. 5개의 탭, 파일과 폴더 관리, 업로드, 범위 지정 Archibot 액세스 부여, 백업과 스테이징 복원, 그리고 고객 드라이브 생성입니다.

공유 드라이브 열기

1. Console에 로그인하고 왼쪽 탐색에서 공유 드라이브를 엽니다.
2. 헤더에는 두 개의 상태 배지(공유 스토리지와 확장 가능한 개인 저장소)가 표시되며, 관리자에게는 NFS 서비스, 백업, 에이전트 부여에 대한 빠른 상태 칩이 표시됩니다.
3. 드라이브, 파일, 백업 상태를 다시 로드하려면 언제든지 헤더의 새로 고침을 사용합니다.

헤더 아래에는 탭 행이 있습니다. 각 탭 옆의 개수는 계정에 로드된 항목을 반영합니다.

변경할 수 있는 항목은 역할에 따라 다릅니다. 구성원은 자신의 개인 드라이브를 읽고 쓸 수 있습니다. 고객 드라이브 쓰기 작업, 고객 드라이브 생성 양식, 운영 전반 컨트롤은 고객 관리자와 플랫폼 운영자에게만 표시됩니다.

드라이브 검토하기

공유 드라이브 탭에는 범위별로 그룹화된 드라이브가 나열됩니다. 각 카드에는 드라이브 이름, 소유자, 개인 또는 고객 배지, 그리고 사용 가능 또는 대기 중 상태 배지가 표시됩니다.

각 드라이브 카드에는 다음이 포함됩니다.

• 할당량, 사용됨, 스토리지 지표.
• 연결된 화면 배지. 드라이브에 도달할 수 있는 위치(Chat, VS Code, API 세션, 워크스페이스, 검토, QA)를 표시합니다.
• 드라이브 열기. 해당 드라이브의 최근 파일 보기로 바로 이동합니다.
• 확장 요청. 스토리지에 초점을 맞춘 상태로 카탈로그를 엽니다.

좋은 공유 드라이브 콘텐츠는 정제되어 있고 지속성이 있는 것입니다. 짧은 세션 메모와 인계 요약, 재현 단계, 고객이 승인한 스크린샷 또는 텍스트 증거, 다른 화면과 향후 워크스페이스에서 사용하고 싶은 초안 산출물 등입니다.

비밀번호, API 키, 쿠키, 원시 자격 증명 페이로드, 비공개 대화 기록, 고객 데이터 덤프, 라이선스 파일을 공유 드라이브에 저장하지 마세요.

파일 탐색 및 관리

최근 파일을 선택하거나 카드에서 드라이브 열기를 클릭하면 단일 드라이브의 파일 워크벤치가 열립니다.

워크벤치에는 두 개의 영역이 있습니다.

• 왼쪽의 현재 위치 폴더 트리. 폴더를 클릭하면 파일 목록이 해당 폴더로 범위가 한정되며, 파일 목록 위의 이동 경로에 현재 위치가 표시됩니다.
• 오른쪽의 파일 창. 탐색, 폴더, 업로드의 세 가지 하위 탭이 있습니다.

탐색 하위 탭에서 다음을 할 수 있습니다.

1. 폴더 바로 가기 칩(예: uploads/, uploads/notes/)을 사용하여 자주 사용하는 위치 간을 이동합니다.
2. 파일 검색과 폴더 필터로 필터링한 다음 검색을 실행하거나 지우기를 합니다.
3. 각 파일에 대해 다운로드를 사용하여 로컬에 저장합니다.
4. 쓰기 액세스가 있으면 이름 바꾸기를 사용하여 파일 이름을 변경하거나 다른 폴더로 이동한 다음 저장합니다.
5. 쓰기 액세스가 있으면 제거를 사용하여 파일을 삭제합니다. 이 버튼은 삭제 전에 확인을 위해 두 번째 클릭을 요청합니다.

긴 목록은 창 단위로 표시됩니다. 표시된 파일 수와 로드된 파일 수를 알려주는 알림이 표시됩니다. 특정 파일을 찾으려면 스크롤하지 말고 경로 접두사를 좁히거나 검색하세요.

폴더 생성 및 정리

드라이브를 구조화하려면 폴더 하위 탭으로 전환합니다.

1. archibot/sessions/와 같은 폴더 경로를 입력하거나, 활성 폴더 바로 가기를 사용하여 현재 위치에서 필드를 채웁니다.
2. 폴더를 생성합니다. 새 경로가 활성 위치가 됩니다.
3. 기존 폴더는 이름을 바꾸거나(내용을 이동함) 제거할 수 있으며, 둘 다 쓰기 액세스와 확인 단계로 보호됩니다.

작업을 정리해 두기 위한 권장 폴더:

• 짧은 세션 요약과 복구 메모용 archibot/sessions/.
• 정제된 검토 또는 QA 증거용 ci-review/evidence/.
• 워크스페이스보다 오래 남아야 하는 작은 사용자 생성 산출물용 workspace-backups/.

증거 파일 업로드하기

업로드 하위 탭을 사용하여 정제된 메모, 보고서, 텍스트 산출물을 추가하면 Archibot과 팀원이 나중에 참조할 수 있습니다.

1. 파일 이름을 설정합니다(예: release-notes.md).
2. 대상 폴더를 선택하거나 현재 위치 사용을 선택하여 탐색 중인 폴더에 업로드합니다.
3. 구현 증거와 같은 보존 클래스를 선택하여 파일에 용도 태그를 지정합니다.
4. 양식에 내용을 입력하거나 붙여넣거나, 로컬 파일 선택을 사용하여 컴퓨터에서 파일을 첨부합니다. 작은 텍스트 파일은 자동으로 양식에 읽혀지고, 더 크거나 바이너리 파일은 직접 업로드를 위해 스테이징됩니다.
5. 파일을 저장합니다.

로컬 파일 선택에는 크기 제한이 있으므로 전체 데이터 덤프가 아니라 작은 작업 산출물로 업로드를 제한하세요. 업로드가 성공하면 선택한 폴더의 탐색에 파일이 나타납니다.

범위 지정 Archibot 액세스 부여하기

Archibot 액세스 탭은 전체 드라이브를 노출하지 않고 Archibot이 승인된 파일을 읽도록 허용하는 곳입니다. 부여는 범위가 제한되어 있어 원시 스토리지 경로나 대량 파일 콘텐츠를 넘겨주지 않으며, 모든 매니페스트 읽기가 감사됩니다.

부여를 생성하려면:

1. 부여 대상 화면을 선택합니다: Chat, API, VS Code, 워크스페이스, 검토, QA.
2. 액세스 모드를 선택합니다. 읽기, 또는 쓰기 액세스가 있는 경우 읽기 및 쓰기.
3. 부여 폴더 경로 접두사를 설정하며, 선택적으로 현재 위치 사용을 사용합니다.
4. 선택적으로 파일 필터(파일 이름, 소스, 보존, 경로)와 파일 제한을 추가합니다.
5. 만료 기간을 선택합니다: 30분, 4시간, 24시간, 또는 7일.
6. agent-context와 같은 목적을 입력합니다.
7. 부여 생성을 선택합니다.

부여가 생성되면 매니페스트 준비됨 패널에 파일 수, 매니페스트 경로, 만료, 포함된 파일 미리 보기가 표시됩니다. 새 부여를 생성하지 않고 선택한 화면의 기본 매니페스트를 가져오려면 액세스 확인을 사용할 수도 있습니다.

부여는 수명이 짧고 최소 권한의 액세스로 취급하세요. 폴더와 짧은 기간으로 범위를 한정하고, 광범위하고 수명이 긴 읽기 액세스를 부여하기보다는 만료되도록 두세요.

백업 및 스테이징 복원

백업 및 복원 탭에는 드라이브의 최신 백업 상태, 크기, 객체 수와 함께 감사된 복원 워크플로가 표시됩니다. 백업은 관리되는 드라이브 데이터만 복사하며, 원시 워크스페이스 디스크는 이 스냅샷에 포함되지 않습니다.

복원을 요청하려면(쓰기 액세스 필요):

1. 복원에 의존하기 전에 백업 상태 배지가 최신 또는 정상으로 표시되는지 확인합니다.
2. 무엇을 복구하거나 비교해야 하는지 설명하는 복원 메모를 추가합니다. 비밀이나 원시 고객 데이터를 포함하지 마세요.
3. 스테이징 복원 요청을 선택합니다.

복원은 먼저 별도의 검토 경로로 스테이징되며, 활성 드라이브를 덮어쓰지 않습니다. 복원 요청 목록은 스테이징 경로 및 백업 상태와 함께 대기 중 및 과거 요청을 추적하고, 감사 추적은 각 요청을 기록합니다. 스테이징된 파일을 다시 활성 드라이브로 승격하는 작업은 스테이징된 파일이 검토될 때까지 수동으로 유지됩니다.

워크스페이스 캡처

워크스페이스 캡처 탭은 Archibot 세션, 생성된 산출물, 워크스페이스 메모와 같이 사용자 또는 고객 정책이 허용할 때 드라이브로 복사할 수 있는 워크스페이스 생성 자료를 설명합니다. 이것은 정보 제공용으로, 캡처를 실행하는 버튼을 제공하기보다는 무엇이 캡처되는지에 대한 기대치를 설정합니다.

중요한 작업의 경우 짧은 정제된 요약을 직접 드라이브 폴더에 저장하세요. 그러면 로컬 편집기 기록에 의존하는 것보다 향후 Chat, VS Code, API, 워크스페이스 세션에 더 안전한 연속성 지점을 제공합니다.

고객 드라이브 생성하기

고객 관리자와 플랫폼 운영자에게는 계정 전체 스토리지를 설정하기 위한 고객 드라이브 패널이 공유 드라이브 탭에 표시됩니다.

1. 둘 이상의 고객을 관리하는 경우(또는 플랫폼 운영자인 경우) 대상 고객 ID를 선택합니다.
2. CI review evidence와 같은 드라이브 이름을 입력합니다.
3. 기본 액세스 정책을 선택합니다: 구성원은 읽기 가능, 관리자는 쓰기 가능, 또는 에이전트는 승인된 폴더를 읽기 가능.
4. 드라이브의 용도를 설명하는 짧은 목적을 추가합니다.
5. 고객 드라이브 생성을 선택합니다.

새 드라이브는 고객 범위 아래 목록에 나타나며, 설정한 기본 액세스에 따라 계정에서 사용할 수 있게 됩니다. 고객 드라이브는 계정 전체에서 공유됩니다. 쓰기 액세스에 따라 개인 드라이브를 관리하는 것과 동일한 방식으로 부여와 폴더를 관리합니다.

다음으로 갈 곳

• 플랫폼 화면이 처음이신가요? Archibot에 오신 것을 환영합니다와 액세스 역할부터 시작하세요.
• 실행 중인 워크스페이스 내부에서 작업 중이신가요? 워크스페이스 관리와 첫 워크스페이스 생성을 참조하세요.
• 계정 수준 백업 소스와 공유 드라이브 스냅샷이 어떻게 맞물리는지에 대해서는 백업 및 복원 소스를 참조하세요.
• 파일, 부여, 복원 작업이 실패하면 문제 해결을 따르고, 필요한 경우 드라이브 이름, 작업, 시간을 첨부하여 지원 인계를 여세요.