이 페이지에서는 Google AI Studio를 사용하여 Nano Banana, Live API 같은 Gemini의 최신 기능을 테스트하는 앱을 빠르게 빌드 또는 '바이브 코딩'하고 배포하는 방법을 설명합니다. 이제 Google AI Studio에서 풀 스택 런타임을 지원하므로 자연어 프롬프트 작성을 통해 서버 측 로직, 보안 비밀 관리, npm 패키지 지원을 갖춘 강력한 애플리케이션을 빌드할 수 있습니다.
시작하기
Google AI Studio의 빌드 모드에서 바이브 코딩을 시작하세요. 몇 가지 방법으로 빌드를 시작할 수 있습니다.
- 프롬프트로 시작: 빌드 모드에서 입력란을 사용하여 빌드하려는 항목에 관한 설명을 입력합니다. AI 칩을 선택하여 이미지 생성 또는 Google 지도 데이터와 같은 특정 기능을 프롬프트에 추가합니다. 음성 텍스트 변환 버튼을 사용하여 원하는 내용을 말할 수도 있습니다.
- "운이 좋다면" 버튼: 창의적인 아이디어가 필요하면 "운이 좋다면" 버튼을 사용하세요. Gemini가 시작할 수 있는 프로젝트 아이디어가 포함된 프롬프트를 생성합니다.
- 갤러리에서 프로젝트 리믹스: 앱 갤러리에서 프로젝트를 열고 앱 복사를 선택합니다.
프롬프트를 실행하면 필요한 코드와 파일이 생성되고 앱의 실시간 미리보기가 오른쪽에 표시됩니다.
생성되는 항목
프롬프트를 실행하면 AI Studio에서 완전한 애플리케이션을 만듭니다. 기본적으로 다음을 포함할 수 있는 풀 스택 환경을 만듭니다.
- 클라이언트 측: 웹 프런트엔드 (React가 기본값임)
- 서버 측: 보안 API 호출, 데이터베이스 연결, npm 패키지 사용을 허용하는 Node.js 런타임
오른쪽 미리보기 창에서 코드 탭을 선택하여 생성되는 코드를 볼 수 있습니다. Antigravity 에이전트 는 스택 전반에서 여러 파일을 지능적으로 관리하여 변경사항이 올바르게 전파되도록 합니다.
Antigravity 에이전트
Antigravity 에이전트는 Google Antigravity 내의 기본 AI 기능이며 이제 에이전트 하네스의 핵심 구성요소가 Google AI Studio의 빌드 모드 환경을 지원합니다. 전체 프로젝트의 컨텍스트를 유지하고, 여러 파일을 관리하고, 복잡한 안내를 이해하여 강력한 풀 스택 애플리케이션을 빌드함으로써 단순한 코드 생성을 넘어섭니다.
주요 기능은 다음과 같습니다.
- 컨텍스트 인식: 이전 프롬프트 및 파일 상태의 컨텍스트를 유지합니다.
- 다중 파일 관리: 여러 파일의 종속 항목을 처리합니다.
- 확인된 실행: 코드 업데이트를 확인하여 환각을 줄입니다.
풀 스택 기능
Google AI Studio는 최신 웹 생태계의 강력한 기능을 활용하여 클라이언트 측 프로토타입 이상의 기능을 빌드할 수 있도록 지원합니다.
- 서버 측 런타임 및 npm: npm 패키지의 방대한 라이브러리를 사용합니다. 에이전트는 앱에 필요한 패키지 (예: 데이터 시각화 또는 API 클라이언트를 위한 특정 라이브러리)를 자동으로 식별하고 설치합니다. 원하는 경우 특정 패키지를 요청할 수도 있습니다.
- 비밀 관리: 설정 메뉴에서 API 키와 비밀을 안전하게 저장합니다. 서버 측 코드에서 액세스할 수 있으므로 클라이언트 측 노출로부터 안전하게 보호됩니다.
- 멀티플레이어: AI Studio 내에서 직접 실시간 공동작업 환경을 빌드합니다. 서버 측 런타임은 사용자가 함께 상호작용하는 데 필요한 상태와 연결을 관리합니다.
- Firebase 통합: Firestore 데이터베이스 (영구 데이터 저장소) 및 Firebase 인증 (로그인 흐름, 특히 'Google로 로그인')을 비롯한 Firebase를 자동으로 프로비저닝하고 설정합니다. 에이전트는 전체 설정 프로세스를 처리하고 이러한 서비스의 앱에서 코드를 작성하기도 합니다.
계속 빌드하세요
Google AI Studio에서 애플리케이션의 초기 코드를 생성하면 계속해서 코드를 개선할 수 있습니다.
Google AI Studio에서 빌드
- Gemini로 반복: 빌드 모드 의 채팅 패널을 사용하여 Gemini 에 수정, 새 기능 추가, 스타일 변경을 요청합니다.
- 코드 직접 수정: 미리보기 패널에서 코드 탭을 열어 실시간으로 수정합니다.
외부에서 개발
더욱 고급 워크플로의 경우 코드를 내보내고 원하는 환경에서 작업할 수 있습니다.
- 다운로드 및 로컬 개발: 생성된 코드를 ZIP 파일로 내보내고 코드 편집기로 가져옵니다.
- GitHub로 푸시: 코드를 GitHub 저장소로 푸시하여 기존 개발 및 배포 프로세스와 통합합니다.
주요 특징
Google AI Studio에는 빌드 프로세스를 직관적이고 시각적으로 만들어 주는 여러 기능이 포함되어 있습니다.
- 풀 스택 앱 만들기 및 반복: 프롬프트만으로 풀 스택 앱을 만들고 채팅 또는 주석 모드를 통해 반복합니다. 주석 모드를 사용하면 앱의 UI 부분을 강조표시하고 원하는 변경사항을 설명할 수 있습니다.
- 앱 공유 및 배포: 다른 사용자와 창작물을 공유하여 공동작업하거나 작업을 선보일 수 있습니다. 그런 다음 앱이 준비되면 Cloud Run에 배포합니다.
- 앱 갤러리: 앱 갤러리는 프로젝트 아이디어의 시각적 라이브러리를 제공합니다. Gemini로 가능한 작업을 탐색하고, 애플리케이션을 즉시 미리 보고, 리믹스하여 나만의 애플리케이션을 만들 수 있습니다.
앱 배포 또는 보관처리
애플리케이션이 준비되면 배포할 수 있습니다.
- Google Cloud Run: 애플리케이션을 확장 가능한 서비스로 배포합니다. Google Cloud Run 가격은 사용량에 따라 적용될 수 있습니다.
- GitHub: 프로젝트를 GitHub 저장소로 내보냅니다.
제한사항
이 섹션에는 Google AI Studio의 빌드 모드에 적용되는 현재 제한사항이 나와 있습니다.
API 키 보안
- 클라이언트 측: 클라이언트 측 코드에서 실제 API 키를 직접 사용하지 마세요.
- 서버 측: 비밀 관리 기능을 사용하여 민감한 키를 서버 측 런타임에서 안전하게 처리합니다.
Google AI Studio 외부 배포
- 앱을 공개 URL의 Cloud Run에 배포할 수 있지만 이 설정은 모든 사용자의 Gemini API 호출에 API 키를 사용합니다.
- JavaScript 앱은 클라이언트 측에서 실행되므로 데이터 유출 또는 오용을 방지하려면 API 키에 최소한의 액세스 권한만 부여해야 합니다. 예를 들어 동일한 프로젝트의 다른 파일 검색 스토어는 이 메커니즘을 통해 사용자에게 액세스할 수 있습니다.
- 보안 외부 배포: AI Studio 외부에서 앱을 안전하게 실행하려면 (예: zip 파일을 다운로드한 후) 최종 사용자에게 키가 노출되지 않도록 API 키를 사용하는 로직을 서버 측 구성요소로 이동해야 합니다. Cloud Run을 사용하여 배포하는 경우에는 필요하지 않습니다.
- 키 노출 경고: 클라이언트 측 환경에서 자리표시자를 실제 API 키로 바꾸는 것은 키가 모든 사용자에게 표시되므로 권장되지 않습니다.
앱 공유 시 오류
앱을 공유하고 최종 사용자가 공유 URL을 사용할 때 403 액세스 제한됨 오류가 발생하면 다음 중 하나가 원인일 수 있습니다.
- 브라우저 확장 프로그램: Privacy Badger와 같은 개인 정보 보호 확장 프로그램이 앱을 차단할 수 있습니다. 오류를 방지하려면 확장 프로그램을 사용 중지하세요.
- 빌드 문제: 현재 코드에 문제가 있을 수 있습니다. 에이전트에 '현재 코드의 빌드 문제를 해결'하도록 프롬프트를 표시한 다음 URL을 다시 공유합니다.
FAQ
AI Studio의 빌드란 무엇인가요?
AI Studio 빌드는 Gemini를 사용하여 간단한 프롬프트에서 프로덕션 준비가 완료된 AI 기반 애플리케이션으로 전환할 수 있도록 설계된 플랫폼입니다. 프롬프트로 빌드하려는 항목을 설명하면 Gemini가 앱을 생성합니다. 갤러리를 탐색하여 Gemini API로 가능한 작업을 확인하고 앱을 리믹스하여 나만의 앱을 만들 수도 있습니다.
빌드가 클라이언트 측 코드에서 Gemini API를 호출하는 이유는 무엇인가요?
일반적으로 API 키를 노출하지 않도록 서버 측에서 Gemini API를 호출하는 것이 좋습니다. 하지만 AI Studio에는 코드에 노출하지 않고 API 키를 연결하는 클라이언트 측 호출을 위한 Gemini API 프록시가 있습니다. 현재는 이 프록시를 활용하기 위해 클라이언트 측에서 호출을 생성합니다. 이렇게 하면 코드가 간소화되고 API 키를 제공하지 않고도 다른 사용자와 앱을 공유할 수 있습니다.
앱을 공유할 때 API 키가 노출되나요?
앱에서 실제 API 키를 사용하지 마세요. 대신 자리표시자 값을 사용하세요.
process.env.GEMINI_API_KEY는 사용할 수 있는 자리표시자 값으로 설정됩니다.
다른 사용자가 앱을 사용하면 AI Studio에서 Gemini
API에 대한 호출을 프록시 처리하여 자리표시자 값을 사용자의 (내 API 키가 아님) API 키로 바꿉니다.
앱을 볼 수 있는 모든 사용자에게 코드가 표시되므로 앱에서 실제 API 키를 사용하지 마세요.
내 앱을 볼 수 있는 사용자
기본적으로 앱은 비공개입니다. 다른 사용자와 앱을 공유하여 앱을 사용할 수 있도록 허용할 수 있습니다. 앱을 공유하는 사용자는 앱의 코드를 보고 자신의 용도로 포크할 수 있습니다. 수정 권한으로 앱을 공유하면 다른 사용자가 앱의 코드를 수정할 수 있습니다.
AI Studio 외부에서 앱을 실행할 수 있나요?
AI Studio에서 Cloud Run에 앱을 배포하면 앱에 공개 URL이 제공됩니다. API 키를 비공개로 유지하는 프록시 서버와 함께 배포되지만 배포된 앱은 모든 사용자의 Gemini API 호출에 API 키를 사용합니다. 앱을 zip 파일로 다운로드할 수도 있습니다. 자리표시자 값을 실제 API 키로 바꿔도 계속 작동합니다. 하지만 모든 사용자가 API 키를 볼 수 있으므로 앱을 이렇게 배포 해서는 안 됩니다. AI Studio 외부에서 앱을 안전하게 실행하려면 일부 로직을 서버 측으로 이동해야 하므로 API 키가 더 이상 노출되지 않습니다.
자체 도구로 로컬에서 앱을 개발한 다음 여기에서 공유할 수 있나요?
이 기능은 아직 제공되지 않습니다. Google은 향후 앱의 더 많은 사용 사례를 지원할 수 있게 되어 기쁩니다. 특정 의견이 있다면 의견을 보내주세요.
앱에서 데이터베이스 또는 기타 저장소를 어떻게 사용할 수 있나요?
AI Studio 앱은 Cloud Run 컨테이너에서 실행되는 표준 앱입니다. 동적 IP 범위에서 액세스를 방지하는 방화벽이 없는 한 네트워크를 통해 연결할 수 있는 모든 저장소 솔루션을 사용할 수 있습니다.
Google은 향후 AI Studio 내에서 직접 구성할 수 있는 저장소에 대한 직접 지원을 추가하기 위해 노력하고 있습니다.
마이크, 웹캠, 기타 Navigator API에 어떻게 액세스할 수 있나요?
시청자가 앱의 웹캠 또는 기타
기기 사용을 인식하도록 하려면 앱이 이러한 Navigator API에 액세스하기 전에 추가 확인이 필요합니다.
앱 제작자는 이러한 권한 요청을 앱의 metadata.json 파일에 추가할 수 있습니다. 예를 들면 다음과 같습니다.
{
"name": "My app",
"requestFramePermissions": [
"microphone",
"camera",
"display-capture",
"geolocation",
"bluetooth",
"clipboard-read",
"serial",
"usb"
]
}
requestFramePermissions에 지원되는 값은
표준 정책 제어 기능의 하위 집합입니다.
앱에서 GitHub를 어떻게 사용할 수 있나요?
AI Studio의 GitHub 통합을 사용하면 작업용 저장소를 만들고 최신 변경사항을 커밋할 수 있습니다. 현재 원격 변경사항 가져오기는 지원되지 않습니다.
다른 사용자에게 내 앱에 대한 수정 액세스 권한을 부여할 수 있나요?
아직 지원되지 않지만 곧 지원될 예정입니다.
내 앱이 정책 위반으로 신고된 이유는 무엇인가요?
Google에는 앱이 Google 정책을 준수하는지 자동으로 검토하는 시스템이 있습니다. 앱이 Google 정책을 위반하는 것으로 확인되면 AI Studio에서 앱이 삭제됩니다. 정책 위반에는 다음이 포함되나 이에 국한되지 않습니다.
- 멀웨어, 피싱 또는 명의 도용이 포함된 앱
- 아동 성적 학대 이미지 정책을 위반하는 콘텐츠를 표시하거나 배포하는 앱
- 괴롭힘 정책을 위반하는 콘텐츠를 표시하거나 배포하는 앱
- 증오심 표현 정책을 위반하는 콘텐츠를 표시하거나 배포하는 앱
- 인신매매 정책을 위반하는 콘텐츠를 표시하거나 배포하는 앱
- 음란물 정책을 위반하는 콘텐츠를 표시하거나 배포하는 앱
- 폭력 및 유혈이 낭자한 콘텐츠 정책을 위반하는 콘텐츠를 표시하거나 배포하는 앱
- 유해하거나 위험한 정책을 위반하는 콘텐츠를 표시하거나 배포하는 앱
앱이 정책 위반으로 신고되었지만 오류라고 생각되면 이의신청을 제출할 수 있습니다. Google 정책을 반복적으로 위반하면 AI Studio에 대한 액세스가 해지될 수 있습니다.
앱 개발자로서의 책임은 무엇인가요?
다시 한번 말씀드리지만 애플리케이션의 소유자로서 애플리케이션의 동작과 처리하는 모든 데이터에 대한 책임은 본인에게 있습니다. 여기에는 다음이 포함됩니다.
- 법규 준수 및 서드 파티 권리: 앱이 모든 관련 법규를 준수하고 지식 재산권 및 개인 정보 보호 권리를 비롯한 타인의 권리를 침해하지 않도록 합니다.
- 콘텐츠 모니터링: 앱에서 사용하는 다른 서비스에 추가 약관이 적용될 수 있습니다. 예를 들어 Firestore에 적용되는 Google Cloud 서비스 약관에서는 서드 파티 콘텐츠를 호스팅하는 고객이 금지된 콘텐츠 (예: 불법 콘텐츠)를 정의하는 정책을 게시하고 해당 불법 콘텐츠의 존재를 모니터링하도록 요구합니다.
- 안전한 구현: 애플리케이션이 오용되지 않도록 필요한 보호 조치 및 조정 도구를 구현합니다.
서비스 약관의 사용 제한사항 을 숙지하세요.
AI Studio의 앱 갤러리에 있는 앱에 적용되는 약관은 무엇인가요?
달리 명시되지 않는 한 Gemini API 추가 서비스 약관 은 AI Studio의 앱 갤러리에 소개된 앱의 사용에 적용됩니다.