> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 여러 아티팩트 지원을 위해 이전 프로젝트 업데이트하기

> URL, 데이터, 배포를 보존하는 일회성 구조 업데이트로 이전 Replit 프로젝트에 두 번째 아티팩트를 추가하세요.

2026년 3월 11일 이전에 만들어진 프로젝트의 경우, Agent가 두 번째 아티팩트를 추가하기 전에 일회성 구조 업데이트가 필요할 수 있습니다. 이 페이지에서는 그 이유, 변경되는 내용, 그리고 업데이트 가능한 프로젝트 조건을 설명합니다.

## 배경

**2026년 3월 11일**, Replit은 [Agent 4](/updates/2026/03/13/changelog)를 출시했습니다. 이 릴리즈의 가장 큰 변경사항 중 하나는 **다중 아티팩트 지원**이었습니다: 단일 [프로젝트](/references/projects-and-artifacts/projects)가 이제 동일한 데이터베이스, 백엔드, 시크릿, 배포를 공유하는 여러 [아티팩트](/references/projects-and-artifacts/artifacts)(예: 웹 앱, 모바일 앱, 피치 덱)를 담을 수 있습니다.

2026년 3월 11일 이전에는 각 프로젝트가 다른 파일 레이아웃으로 단일 앱 중심으로 빌드되었습니다. 이전 구조는 백엔드가 하나 이상의 아티팩트를 호스팅하는 데 필요한 분리를 갖추지 못했습니다. 이러한 차이로 인해 2026년 3월 11일 이전에 만들어진 프로젝트는 Agent가 두 번째 아티팩트를 추가하기 전에 **일회성 구조 업데이트**가 필요합니다. 해당 날짜 이후에 만들어진 프로젝트는 이미 새 레이아웃을 사용하므로 이 단계가 필요하지 않습니다.

## 업데이트가 하는 일

이전 프로젝트에 두 번째 아티팩트를 추가하도록 Agent에게 요청하면(예: 기존 웹 앱에 모바일 앱 추가), Agent가 먼저 프로젝트를 새로운 다중 아티팩트 레이아웃으로 재편성합니다. URL, 협업자, 시크릿, 데이터베이스, 도메인은 모두 보존됩니다. 내부 구조만 변경됩니다.

## 작동 방식

<Steps>
  <Step title="이전 프로젝트에 새 아티팩트 요청">
    Agent에게 "내 웹사이트를 위한 피치 슬라이드 덱을 만들어줘"와 같이 요청하세요.
  </Step>

  <Step title="검토 및 승인">
    Agent는 변경사항을 적용하기 전에 잠시 멈추고 채팅에서 제안을 보여줍니다. 최대 두 개의 업데이트 가능한 프로젝트에 대해 프로젝트 업데이트를 시작하는 데 도움이 되는 일회성 **\$5 크레딧** 제공이 함께 표시됩니다. **Update project**를 클릭해 계속하거나 **Not now**를 클릭해 건너뛰세요.

    <Frame>
      <img src="https://mintcdn.com/replit/PUjTWRdx_TNp0SaN/images/replitai/multi-artifact-update-approval.png?fit=max&auto=format&n=PUjTWRdx_TNp0SaN&q=85&s=952936728a532ab0241de383ddcd0172" alt="Agent chat panel showing the 'Update project to create mobile app' approval card with a $5 credit offer and Not now / Update project buttons." width="991" height="589" data-path="images/replitai/multi-artifact-update-approval.png" />
    </Frame>
  </Step>

  <Step title="재편성 완료 대기">
    Agent가 작업에서 프로젝트를 새 구조로 재편성합니다 — 작업 목록에서 진행 상황을 따라갈 수 있습니다. 원본 앱은 변경 전에 백업되므로 문제가 발생해도 이전 작업을 잃지 않습니다.

    <Frame>
      <img src="https://mintcdn.com/replit/PUjTWRdx_TNp0SaN/images/replitai/multi-artifact-update-task-progress.png?fit=max&auto=format&n=PUjTWRdx_TNp0SaN&q=85&s=1550c9c6b80b93ef9cb002f9aa73ba51" alt="Agent chat panel showing the 'Updating your project' task in progress, with the 'Port existing coffee website' subtask active." width="989" height="587" data-path="images/replitai/multi-artifact-update-task-progress.png" />
    </Frame>
  </Step>

  <Step title="요청한 새 아티팩트 받기">
    원본 앱이 새 구조에서 실행되면 Agent가 처음에 요청한 아티팩트를 빌드합니다.
  </Step>
</Steps>

## 업데이트 가능 조건

현재 모든 프로젝트를 업데이트할 수 있는 것은 아닙니다. 프로젝트가 다음 유형 중 하나여야 합니다:

* **웹 앱** (풀스택 JavaScript)
* **디자인-to-앱 목업**
* **모바일 앱** (Expo)

2026년 3월 11일 이전에 만들어진 다른 프로젝트 유형 — Python, Flask, Streamlit, 게임 스택, 비디오 프로젝트, 에이전트 스택 — 은 지원되지 않습니다. 이러한 경우 여러 아티팩트가 필요하면 [새 프로젝트를 만드세요](/references/projects-and-artifacts/projects).

프로젝트의 포트와 워크플로도 해당 유형의 기본 설정과 일치해야 합니다. `.replit`을 수동으로 편집한 경우 다음 메시지가 표시됩니다:

> *This project cannot be migrated automatically: workflow config does not match expected.*

이를 해결하려면 포트 또는 워크플로 커스터마이징을 기본값으로 되돌리고 다시 시도하세요.

## 자주 묻는 질문

<AccordionGroup>
  <Accordion title="왜 내 프로젝트에 업데이트가 필요한가요?">
    2026년 3월 11일(Agent 4 출시) 이전에 만들어진 프로젝트는 단일 앱 레이아웃을 사용했습니다. 새로운 공유 작업 공간 레이아웃이 웹 앱, 모바일 앱, 관리자 대시보드가 함께 동일한 데이터베이스와 백엔드를 공유할 수 있게 해줍니다. 업데이트는 해당 레이아웃으로 전환하기 위한 일회성 단계입니다.
  </Accordion>

  <Accordion title="업데이트하고 싶지 않으면 어떻게 하나요?">
    **Not now**를 클릭하세요. Agent가 기존 단일 아티팩트 레이아웃에서 계속 빌드합니다. 필요가 바뀌면 나중에 제안을 다시 검토할 수 있습니다.
  </Accordion>

  <Accordion title="두 번 이상 업데이트할 수 있나요?">
    아니요. 프로젝트가 새 구조로 전환되면 추가 업데이트가 필요하지 않습니다. 이후 아티팩트는 별도의 업데이트 단계 없이 직접 추가됩니다.
  </Accordion>

  <Accordion title="내 프로젝트가 업데이트 조건에 맞지 않습니다. 어떤 선택지가 있나요?">
    새 아티팩트를 위한 별도의 프로젝트를 만들거나, 처음부터 여러 아티팩트를 지원하는 새 프로젝트를 시작하세요.
  </Accordion>
</AccordionGroup>

## 참고 자료

* [아티팩트란?](/references/projects-and-artifacts/artifacts)
* [프로젝트란?](/references/projects-and-artifacts/projects)
* [여러 아티팩트 vs. 별도 프로젝트](/references/projects-and-artifacts/multiple-artifacts-vs-projects)