> ## 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](/ko/updates/2026/03/13/changelog)를 출시했습니다. 이 릴리스에서 가장 큰 변화 중 하나는 **다중 아티팩트 지원**이었습니다. 이제 하나의 [프로젝트](/ko/features/projects-and-artifacts/projects)가 같은 데이터베이스, 백엔드, 시크릿, 배포를 공유하는 여러 개의 [아티팩트](/ko/features/projects-and-artifacts/artifacts)(예: 웹 앱, 모바일 앱, 피치 덱)를 가질 수 있게 되었습니다.

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

## 업데이트가 하는 일

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

## 동작 방식

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

  <Step title="검토 및 승인">
    Agent는 변경을 시작하기 전에 멈추고 채팅에서 제안을 보여줍니다. 대상이 되는 프로젝트 최대 2개에 대해서는 프로젝트 업데이트를 시작하는 데 사용할 수 있는 일회성 **5달러 크레딧** 제공도 확인할 수 있습니다. 계속하려면 **프로젝트 업데이트**를 클릭하고, 건너뛰려면 **나중에**를 클릭하세요.

    <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="'모바일 앱을 만들기 위해 프로젝트 업데이트' 승인 카드가 5달러 크레딧 제공과 나중에 / 프로젝트 업데이트 버튼과 함께 표시된 Agent 채팅 패널" 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 채팅 패널, '기존 커피 웹사이트 포팅' 하위 작업이 활성화된 모습" width="989" height="587" data-path="images/replitai/multi-artifact-update-task-progress.png" />
    </Frame>
  </Step>

  <Step title="요청한 새 아티팩트 받기">
    기존 앱이 새로운 구조에서 실행되면 Agent가 처음 요청한 아티팩트를 만듭니다.
  </Step>
</Steps>

## 대상 조건

현재 모든 프로젝트가 업데이트 대상은 아닙니다. 프로젝트는 다음 유형 중 하나여야 합니다.

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

Python, Flask, Streamlit, 게임 스택, 영상 프로젝트, Agent 스택 등 2026년 3월 11일 이전에 만들어진 다른 유형의 프로젝트는 지원되지 않습니다. 이런 경우 여러 개의 아티팩트가 필요하다면 대신 [새 프로젝트를 만드세요](/ko/features/projects-and-artifacts/projects).

프로젝트의 포트와 워크플로도 해당 유형의 기본 구성과 일치해야 합니다. `.replit`을 수동으로 편집했다면 다음과 같은 메시지가 표시됩니다.

> *이 프로젝트는 자동으로 마이그레이션할 수 없습니다: 워크플로 구성이 예상과 일치하지 않습니다.*

이 문제를 해결하려면 포트나 워크플로 사용자 지정을 기본값으로 되돌린 후 다시 시도하세요.

## 자주 묻는 질문

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

  <Accordion title="업데이트를 원하지 않으면 어떻게 되나요?">
    **나중에**를 클릭하세요. Agent는 기존의 단일 아티팩트 구조로 계속 작업을 진행합니다. 필요가 바뀌면 나중에 다시 제안을 확인할 수 있습니다.
  </Accordion>

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

  <Accordion title="내 프로젝트가 대상이 아니에요. 어떤 방법이 있나요?">
    새 아티팩트를 위한 별도의 프로젝트를 만들거나, 처음부터 다중 아티팩트를 지원하는 새 프로젝트를 시작하세요.
  </Accordion>
</AccordionGroup>

## 함께 보기

* [아티팩트란 무엇인가요?](/ko/features/projects-and-artifacts/artifacts)
* [프로젝트란 무엇인가요?](/ko/features/projects-and-artifacts/projects)
* [여러 개의 아티팩트 vs. 별도의 프로젝트](/ko/features/projects-and-artifacts/multiple-artifacts-vs-projects)