Atoms 클라우드란 무엇인가요?

Atoms 클라우드 는 앱이 실제 사용자 및 정보와 함께 작동하는 데 필요한 백그라운드 서비스를 제공합니다. 이를 통해 앱은 데이터와 파일을 저장하고, 사용자를 관리하고, 비공개 자격 증명을 안전하게 저장하며, AI 기능을 사용할 수 있습니다. 정적 사이트와 달리, Atoms 클라우드에 연결된 앱은 정보를 기억하고 사용자의 동작에 반응할 수 있습니다.

에이전트는 앱의 프런트엔드와 백엔드를 모두 구축합니다. 앱에 데이터베이스, 사용자 인증 또는 파일 저장소가 필요하면 Atoms는 빌드 중에 자동으로 Atoms 클라우드를 연결합니다. 기존의 지원되는 프로젝트에 수동으로 연결할 수도 있습니다.

연결되면 Atoms가 기본 인프라를 대신 관리합니다. Atoms 클라우드 워크스페이스를 사용하여 프로젝트의 클라우드 서비스를 보고 관리하고, 개발 중에 앱을 테스트하고, 준비가 되면 게시할 수 있습니다.

이 페이지에서는 Atoms 클라우드와 현재 해당 워크스페이스에서 사용할 수 있는 기능을 개괄적으로 설명합니다. 설정 단계와 자세한 지침은 전용 가이드를 따르세요.

Atoms 클라우드 사이드바를 사용하여 AI, 데이터베이스, Users, 키, App 스토리지를 여세요.

Atoms 클라우드에서 관리할 수 있는 항목

모듈	포함 내용	자세한 가이드
AI	앱 기능에 사용할 AI 모델을 선택하고 사용량을 검토합니다.	앱에서 AI 사용하기
데이터베이스	앱에서 사용하는 구조화된 데이터를 보고 관리합니다.	데이터베이스
Users	앱에 등록된 사용자를 보고 검색합니다.	Authentication
키	앱이 외부 서비스에 접근하는 데 사용하는 자격 증명을 저장하고 관리합니다.	키 및 secrets
App 스토리지	앱에서 사용하는 파일을 저장하고 관리합니다.	App storage

에이전트는 앱을 빌드하면서 이러한 서비스를 설정하고 연결할 수 있습니다. 게시하기 전에 결과를 반드시 테스트하세요.

연결하기 전에

Atoms 클라우드는 지원되는 프로젝트에서만 사용할 수 있으며 데스크톱에서만 관리할 수 있습니다. 이미 Supabase에 연결된 프로젝트는 Atoms 클라우드에도 동시에 연결할 수 없으며, 그 반대도 마찬가지입니다. 워크스페이스 권한에 따라 접근할 수 있는 모듈이 결정됩니다.

Connect가 차단된 경우

기능을 아직 사용할 수 없음: 해당 프로젝트에서는 아직 Atoms 클라우드가 열려 있지 않습니다. 프로젝트에서 Atoms 클라우드를 사용할 수 있을 때까지 기다리거나 Support에 문의하여 대상 여부를 확인하세요.

플랜 한도 또는 Upgrade 메시지: 화면의 업그레이드 안내를 따른 다음 프로젝트로 돌아와 Connect를 다시 시도하세요.

사용량 한도: 이 프로젝트는 이 기능에 대한 허용량에 도달했습니다. 플랜 및 사용량 정보를 검토하고, 사용 가능한 업그레이드 또는 갱신 옵션을 따른 뒤, 한도가 해제된 후에만 다시 시도하세요.

스토리지 한도: 이 프로젝트는 이미지 또는 파일 스토리지 한도에 도달했습니다. 저장된 불필요한 파일을 삭제하거나, 제품에서 해당 옵션을 제공하는 경우 사용 가능한 스토리지를 늘린 다음 다시 시도하세요.

다른 메시지가 활성 상태임: 연결을 시작하기 전에 현재 에이전트 메시지 또는 요청을 완료한 다음 다시 시도하세요.

Supabase가 이미 연결됨: 계속 사용하려면 Supabase를 유지하세요. Atoms 클라우드로 전환하려면 먼저 Supabase 연결을 해제한 다음 Connect를 다시 시도하세요.

Atoms 클라우드 열기 또는 연결하기

빌드 중에 Atoms 클라우드가 연결되지 않았거나 기존의 지원되는 프로젝트에 추가하려는 경우, 수동으로 연결할 수 있습니다.

1. 데스크톱 기기에서 프로젝트를 엽니다.
2. App 뷰어 가 있는 동일한 워크스페이스 툴바에서 Atoms 클라우드를 선택합니다.
3. Atoms 클라우드가 연결되어 있지 않다면 Connect를 선택합니다. 업그레이드가 표시되면 화면의 안내에 따라 필요한 플랜 또는 리소스 변경을 진행하세요. 다른 메시지가 연결을 차단하는 경우 중단하고 연결하기 전에의 복구 안내를 따르세요.
4. 에이전트가 Atoms 클라우드를 활성화하고 사용자를 App 뷰어로 다시 돌려보냅니다. 모듈을 보려면 Atoms 클라우드를 다시 여세요.

프로젝트 Chat에서 에이전트에게 직접 Atoms 클라우드를 연결해 달라고 요청할 수도 있습니다.

프로젝트 툴바에서 Atoms 클라우드를 여세요.

프로젝트에서 Atoms 클라우드를 활성화하려면 Connect를 선택하세요.

클라우드 사용량 및 게시

Cloud and AI 사용량은 프로젝트 빌드에 사용하는 크레딧과 별도로 측정됩니다. 현재 잔액, 사용량 및 계정 제어는 Cloud & AI Wallet에서 확인하세요.

앱이 준비되면 프로젝트 게시하기 — Help Center draft를 사용하여 라이브 URL에서 사용할 수 있도록 하세요.

FAQ

내 Supabase Edge Function이 작동하지 않는 이유는 무엇인가요?

이 문제 해결 경로는 Supabase Edge Functions용입니다. Edge Functions는 위에 나열된 Atoms 클라우드 워크스페이스 모듈 중 하나가 아니므로, 연결된 Supabase 프로젝트를 열어 함수를 배포, 호출하고 함수 로그를 검토하세요.

1. 함수를 한 번 트리거하고 시간, 요청, 응답 상태 및 정확한 오류를 기록하세요.
2. 함수 배포에 실패했는지, 아니면 성공적으로 배포되었지만 호출 시 실패했는지 확인하세요.
3. 해당 타임스탬프의 함수 로그를 검토하세요. 요청 경로와 메서드, 입력, 인증, 종속성 및 필요한 환경 변수 이름을 확인하세요. 비밀 값은 절대 공유하지 마세요.
4. 대상에 맞는 수정 하나를 적용하고 한 번 배포한 뒤 동일한 테스트를 반복하세요.
5. 예상 응답을 확인하고 관련 흐름이 여전히 작동하는지 검증하세요.

함수가 계속 실패하면 Chat Link, 함수 이름, 타임스탬프와 시간대, 재현 단계, 응답 상태 및 민감 정보가 제거된 로그와 함께 Support에 문의하세요.

"Cloud / AI Wallet balance insufficient"는 무슨 뜻인가요?

이 메시지는 요청한 작업을 수행하기에 Cloud & AI 서비스용 사용 가능 잔액이 너무 낮다는 뜻입니다. 이 월렛은 에이전트 사용량에 대해 Plans & Credits 아래에 표시되는 크레딧과는 별개입니다.

1. Settings → Cloud & AI를 열고 사용 가능한 잔액과 최근 사용량을 검토하세요.
2. 자금을 추가하기로 선택한 경우, 충전을 완료하기 전에 금액과 결제 세부 정보를 확인하세요.
3. 차단된 작업으로 돌아가 잔액 업데이트가 확인된 후 다시 시도하세요.

프로모션 금액과 대상 여부는 변경될 수 있으므로, 이 FAQ의 고정 금액보다는 본인 계정에 표시된 제안을 기준으로 하세요. 잔액이 낮으면 대상 클라우드 서비스 또는 게시된 애플리케이션이 중단될 수 있습니다. 완료된 충전이 반영되지 않았다면 다시 결제하지 말고, 거래 참조 정보와 일부를 가린 스크린샷을 첨부해 Support에 문의하세요.