메인 콘텐츠로 건너뛰기

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.

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

​
배경

2026년 3월 11일, Replit은 Agent 4를 출시했습니다. 이 릴리즈의 가장 큰 변경사항 중 하나는 다중 아티팩트 지원이었습니다: 단일 프로젝트가 이제 동일한 데이터베이스, 백엔드, 시크릿, 배포를 공유하는 여러 아티팩트(예: 웹 앱, 모바일 앱, 피치 덱)를 담을 수 있습니다. 2026년 3월 11일 이전에는 각 프로젝트가 다른 파일 레이아웃으로 단일 앱 중심으로 빌드되었습니다. 이전 구조는 백엔드가 하나 이상의 아티팩트를 호스팅하는 데 필요한 분리를 갖추지 못했습니다. 이러한 차이로 인해 2026년 3월 11일 이전에 만들어진 프로젝트는 Agent가 두 번째 아티팩트를 추가하기 전에 일회성 구조 업데이트가 필요합니다. 해당 날짜 이후에 만들어진 프로젝트는 이미 새 레이아웃을 사용하므로 이 단계가 필요하지 않습니다.

​
업데이트가 하는 일

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

​
작동 방식

1

이전 프로젝트에 새 아티팩트 요청

Agent에게 “내 웹사이트를 위한 피치 슬라이드 덱을 만들어줘”와 같이 요청하세요.
2

검토 및 승인

Agent는 변경사항을 적용하기 전에 잠시 멈추고 채팅에서 제안을 보여줍니다. 최대 두 개의 업데이트 가능한 프로젝트에 대해 프로젝트 업데이트를 시작하는 데 도움이 되는 일회성 $5 크레딧 제공이 함께 표시됩니다. Update project를 클릭해 계속하거나 Not now를 클릭해 건너뛰세요.
Agent chat panel showing the 'Update project to create mobile app' approval card with a $5 credit offer and Not now / Update project buttons.
3

재편성 완료 대기

Agent가 작업에서 프로젝트를 새 구조로 재편성합니다 — 작업 목록에서 진행 상황을 따라갈 수 있습니다. 원본 앱은 변경 전에 백업되므로 문제가 발생해도 이전 작업을 잃지 않습니다.
Agent chat panel showing the 'Updating your project' task in progress, with the 'Port existing coffee website' subtask active.
4

요청한 새 아티팩트 받기

원본 앱이 새 구조에서 실행되면 Agent가 처음에 요청한 아티팩트를 빌드합니다.

​
업데이트 가능 조건

현재 모든 프로젝트를 업데이트할 수 있는 것은 아닙니다. 프로젝트가 다음 유형 중 하나여야 합니다:
  • 웹 앱 (풀스택 JavaScript)
  • 디자인-to-앱 목업
  • 모바일 앱 (Expo)
2026년 3월 11일 이전에 만들어진 다른 프로젝트 유형 — Python, Flask, Streamlit, 게임 스택, 비디오 프로젝트, 에이전트 스택 — 은 지원되지 않습니다. 이러한 경우 여러 아티팩트가 필요하면 새 프로젝트를 만드세요. 프로젝트의 포트와 워크플로도 해당 유형의 기본 설정과 일치해야 합니다. .replit을 수동으로 편집한 경우 다음 메시지가 표시됩니다:
This project cannot be migrated automatically: workflow config does not match expected.
이를 해결하려면 포트 또는 워크플로 커스터마이징을 기본값으로 되돌리고 다시 시도하세요.

​
자주 묻는 질문

2026년 3월 11일(Agent 4 출시) 이전에 만들어진 프로젝트는 단일 앱 레이아웃을 사용했습니다. 새로운 공유 작업 공간 레이아웃이 웹 앱, 모바일 앱, 관리자 대시보드가 함께 동일한 데이터베이스와 백엔드를 공유할 수 있게 해줍니다. 업데이트는 해당 레이아웃으로 전환하기 위한 일회성 단계입니다.
Not now를 클릭하세요. Agent가 기존 단일 아티팩트 레이아웃에서 계속 빌드합니다. 필요가 바뀌면 나중에 제안을 다시 검토할 수 있습니다.
아니요. 프로젝트가 새 구조로 전환되면 추가 업데이트가 필요하지 않습니다. 이후 아티팩트는 별도의 업데이트 단계 없이 직접 추가됩니다.
새 아티팩트를 위한 별도의 프로젝트를 만들거나, 처음부터 여러 아티팩트를 지원하는 새 프로젝트를 시작하세요.

​
참고 자료