채팅이 앱이 되는 원리
「설비별 가동률을 카드로 보여 줘」 한 줄이 어떻게 배포된 화면이 되는지를 설명합니다. 안을 알면 왜 첫 응답이 몇십 초 걸리는지, 왜 프리뷰가 잠깐 멈추는지, 고장 났을 때 어디를 봐야 하는지가 정해집니다.
당신 ──① 말한다──▶ 에이전트 ──② 고친다──▶ 프로젝트(진짜 리액트 코드)
│ │
│ ③ 세션 컨테이너가 띄운다
│ └──▶ 프리뷰 (고치는 즉시 반영)
└──④ 스스로 검사한다 (타입 검사 + 화면 보기)
⑤ 배포 ──▶ 버전 보관 ──▶ /container/… (동료가 본다)
프로젝트 하나 = 리액트 프로젝트 하나
스튜디오가 만드는 것은 화면 설정값이 아니라 진짜 소스 코드입니다. 프로젝트를 만들면 서버 안에 리액트 프로젝트가 한 벌 복사되고, 이후 대화는 전부 그 파일들을 고치는 일입니다.
이것이 노코드 도구와 갈리는 지점입니다.
| 화면 설정형 도구 | 스튜디오 | |
|---|---|---|
| 만들어지는 것 | 설정값 | 리액트 소스 |
| 도구가 못 하는 것을 요구하면 | 막힌다 | 코드를 쓰면 되므로 대개 된다 |
| 대화 이력 | 별개 | 턴마다 자동으로 커밋된다 — 되돌릴 수 있다 |
에이전트가 한 턴을 끝낼 때마다 자동으로 커밋합니다. 그래서 마음에 안 드는 변경을 직전 상태로 되돌릴 수 있고, 무엇이 언제 바뀌었는지가 남습니다. 검토하고 받아들이고 싶다면 검토 모드로 두십시오 — 빌더로 앱 개발하기
① 말한다 — 두 가지 모드가 있다
같은 채팅창이지만 하는 일이 다릅니다.
| 모드 | 하는 일 | 앱을 고치나 |
|---|---|---|
| 질의 | 플랫폼 데이터를 읽어 표·차트로 답한다 | 아니오 (읽기 전용) |
| 빌더 | 프로젝트 코드를 고쳐 화면을 만든다 | 예 |
「어제 3라인 알람 몇 건이야?」는 질의이고, 「그걸 화면으로 만들어 줘」부터가 빌더입니다. → 채팅으로 데이터 질의 · 홈에서 앱 만들기
② 고친다 — 에이전트가 쓸 수 있는 것은 정해져 있다
에이전트는 아무거나 하지 않습니다. 정해진 도구만 씁니다.
| 도구 | 하는 일 | 걸어 둔 울타리 |
|---|---|---|
| 파일 읽기·쓰기·목록 | 프로젝트 소스를 고친다 | 그 프로젝트 폴더 밖으로 못 나간다 |
| 명령 실행 | 패키지 설치·빌드 | 세션 컨테이너 안에서만 돈다 (서버 셸이 아니다) |
| 플랫폼 조회 | 설비·태그·알람을 읽는다 | 읽기 전용 목록에 있는 것만 |
🔴 에이전트에게 서버 셸이 없습니다. 명령은 그 프로젝트의 컨테이너 안에서 돌고, 파일 도구는 그 프로젝트 폴더를 벗어나지 못합니다. 앱이 잘못 만들어져도 다른 프로젝트나 서버가 다치지 않는 구조입니다.
③ 프리뷰 — 프로젝트마다 컨테이너가 하나씩 뜬다
프로젝트를 열면 그 프로젝트 전용 컨테이너가 하나 뜨고, 그 안에서 개발 서버가 돕니다. 프리뷰 화면은 그 개발 서버를 그대로 보여 주는 것이라 에이전트가 파일을 고치는 즉시 반영됩니다.
| 기본값 | 왜 그런가 | |
|---|---|---|
| 컨테이너 메모리 | 2 GB | 1 GB 는 3D 위젯이 든 앱의 빌드가 메모리 부족으로 죽습니다(실측) |
| 유휴 정지 | 30분 | 쓰지 않는 프로젝트가 계속 메모리를 잡고 있지 않게 합니다 |
30분간 쓰지 않으면 컨테이너를 내리지만, 프로젝트 파일과 대화 이력은 그대로 있습니다. 다시 열면 컨테이너가 다시 뜹니다 — 그래서 오랜만에 여는 프로젝트는 첫 화면이 느립니다.
동시에 몇 개까지 띄울지가 곧 서버 메모리 요구량입니다 → 설치 요구사항
④ 스스로 검사한다 — 그래서 첫 응답이 오래 걸린다
에이전트는 파일을 고치고 바로 끝내지 않습니다.
- 타입 검사를 돌립니다. 실패하면 그 오류를 자기가 읽고 다시 고칩니다.
- 그다음 화면을 실제로 띄워 봅니다. 렌더된 모습을 보고 어긋난 곳을 잡습니다.
한 요청에서 이 왕복이 최대 24번까지 일어납니다. 「왜 이렇게 오래 걸리지」의 답이 이것이고, 동시에 한 번에 돌아가는 화면이 나오는 이유이기도 합니다.
화면이 크면 바로 만들게 하지 말고 구성안을 먼저 받는 편이 빠릅니다 — 어떤 위젯을 어떤 데이터로 놓을지 목록으로 먼저 보고, 고칠 것을 고친 다음 만들게 하면 왕복이 줄어듭니다.
⑤ 배포 — 프리뷰와 배포는 다른 것이다
프리뷰는 개발 서버이고, 배포는 빌드된 결과물입니다. 동료가 보는 것은 배포본입니다.
| 프리뷰 | 배포본 | |
|---|---|---|
| 누가 보나 | 만드는 사람 | 링크를 받은 사람 |
| 언제 바뀌나 | 에이전트가 고치는 즉시 | 배포를 눌렀을 때만 |
| 주소 | /preview/… | /container/… |
배포하면 버전이 쌓입니다(기본 10개 보관). 새 배포가 잘못됐으면 이전 버전으로 되돌릴 수 있습니다.
🔴 비공개 앱은 소유자·관리자·공유받은 사람만 열 수 있습니다. 링크를 안다고 열리지 않습니다 — 공유 대상을 지정해야 합니다. → 앱 카탈로그와 공유
고장 났을 때 어디를 보나
| 증상 | 먼저 볼 곳 |
|---|---|
| 채팅이 답을 못 한다 | AI 프로바이더 설정 — 환경설정 |
| 프리뷰가 안 뜬다 | 세션 컨테이너 — 프로젝트를 닫았다 다시 여십시오 |
| 데이터가 비어 있다 | 플랫폼 연결·API 키 — 환경설정 |
| 배포본만 옛날 화면이다 | 배포를 안 눌렀습니다. 프리뷰는 배포와 다릅니다 |
더 자세한 것은 문제 해결.