# 설계단계에서의 AI
## Content
# 설계단계에서의 AI
Forguncy의 디자인 시 AI 기능은 개발자가 효율적으로 애플리케이션을 구축하도록 지원하는 것을 목표로 하며, Copilot과 유사한 인터랙션 방식을 채택하여 다음 원칙을 따릅니다.
* **직접적이고 효율적:** 간단한 작업에는 빠른 처리 경로를 제공하여 대화형 인터랙션에 과도하게 의존하지 않습니다.
* **재편집 가능:** AI가 생성한 모든 콘텐츠는 개발자의 검토를 거쳐야 하며, 시각적 편집 도구를 제공합니다.
* **병렬 생성:** 백그라운드에서 AI 작업을 비동기로 실행하며, 여러 작업을 동시에 진행할 수 있어 메인 화면 작업의 원활함에 영향을 주지 않습니다.
***
## AI 모델 추가하기
포건시의 AI 기능(애플리케이션 프로토타입 생성, 데이터 테이블/뷰 자동 생성, SQL 자동 생성 등)을 사용하려면, 먼저 **AI 모델**을 하나 이상 등록해야 합니다. 여기서는 "AI API"가 무엇인지부터 실제 등록 화면의 각 항목까지 순서대로 설명합니다.
### 왜 "AI 모델"을 직접 등록해야 하나요?
포건시 자체에는 AI가 내장되어 있지 않습니다. 대신 포건시는 **여러분이 지정한 외부 AI 서비스(OpenAI, Azure OpenAI, 국내 클라우드 AI 서비스 등)에 접속해서** 질문을 보내고 답을 받아오는 방식으로 동작합니다.
쉽게 비유하면:
* 포건시 = 전화기
* AI 모델 설정 = 어떤 상대(AI 서비스)에게 전화를 걸지 정하는 연락처와 통화 방법
* API 키 = 그 상대와 통화하기 위한 본인 인증 번호 (요금은 이 키를 발급받은 계정으로 청구됩니다)
따라서 AI 기능을 쓰려면, "어떤 AI 서비스를 쓸 것인지"와 "그 서비스에 접속할 수 있는 인증 정보(API 키)"를 먼저 준비해서 포건시에 입력해야 합니다.
> 💡 **"API"란?** API(Application Programming Interface)는 서로 다른 두 프로그램이 데이터를 주고받기 위한 규칙입니다. 여기서는 "포건시가 OpenAI 등의 AI 서비스에 자동으로 요청을 보내고 결과를 받아오는 통로"라고 이해하시면 충분합니다. 개발 지식이 없어도 아래 안내에 따라 값만 입력하면 됩니다.
### 시작하기 전 준비할 것
1. **사용할 AI 서비스 결정** 예: OpenAI, Claude, Jemini 등
2. **해당 서비스의 API 키(API Key) 발급** 각 AI 서비스의 홈페이지에서 계정을 만들고 "API Key" 발급 메뉴에서 발급받습니다. 대부분의 AI 서비스는 API 사용량에 따라 별도 요금이 청구되므로(예: ChatGPT 웹사이트 구독과 API 요금은 별개), 이용 전 요금 정책을 확인하세요.
3. **사용할 모델 이름 확인** 예: `gpt-5`, `gpt-4o` 등 서비스에서 제공하는 정확한 모델 이름
### 등록 방법
1. 포건시 디자이너 좌측 메뉴에서 **[옵션]** → [일반 설정]으로 이동합니다.
2. **"디자이너 기능을 위한 AI 모델"** 영역에서 \*\*[AI 모델 추가...]\*\*를 클릭합니다.
3. 설정 창이 열리면 아래 항목을 입력합니다. 이미지 표시
| 항목 | 설명 | 예시 |
| --- | --- | --- |
| **설정 이름** | 이 AI 설정을 구분하기 위한 별칭(커스텀 식별자)입니다. 여러 개를 등록했을 때 알아보기 쉽게 짓습니다. | `OpenAI GPT5` |
| **공급자 유형** | 사용할 AI 서비스의 종류입니다. 별도 안내가 없다면 "OpenAI 호환"을 선택하면 됩니다. | `OpenAI 호환` |
| **API Host (플랫폼 URL)** | AI 서비스의 접속 주소입니다. 사용 중인 서비스 문서의 "API Base URL/Endpoint" 값을 입력합니다. OpenAI를 그대로 쓴다면 기본값을 유지합니다. | `https://api.openai.com/v1` |
| **API Key** | 준비 단계에서 발급받은 인증 키입니다. 비밀번호처럼 취급해야 하며, 등록 후에는 일부만 표시(마스킹)됩니다. | `sk-******P4A` |
| **API Model Name (모델명)** | 사용할 AI 모델의 정확한 이름입니다. 오타가 있으면 연결되지 않으니 서비스 문서에서 복사해서 붙여넣는 것을 권장합니다. | `gpt-5` |
| **고급 설정** (선택) | 최대 출력 토큰 수(Max Tokens), 샘플링 온도(Temperature), 핵 샘플링(Top\_P) 등 세부 옵션입니다. 처음에는 기본값을 두어도 무방합니다. | - |
4. [테스트]를 눌러 정상 연결을 확인합니다. 실패하면 API Host, API Key, 모델명의 오탈자를 다시 확인하세요.
5. [확인]을 눌러 저장합니다.
등록된 AI 모델은 이후 프로토타입 생성, 데이터 테이블/뷰 생성, SQL 생성 등 각 기능에서 선택해 사용할 수 있으며, 설정은 언제든지 다른 모델로 전환할 수 있습니다. 설정은 JSON으로 가져오기/내보내기가 가능해 여러 프로젝트나 PC 간 이전에 활용할 수 있습니다.
### 자주 묻는 질문(FAQ)
**Q. AI 기능을 쓰려면 반드시 유료 API 키가 필요한가요?**
A. 네, 대부분 API 사용량 기준으로 과금됩니다. 무료 크레딧을 제공하는 서비스도 있으니 이용 전 요금 정책을 확인하세요.
**Q. ChatGPT를 결제해서 쓰고 있는데, 그 계정 정보를 그대로 쓰면 되나요?**
A. 아니요. ChatGPT 웹사이트 구독(Plus 등)과 API 키는 별개입니다. API 키는 별도로 발급받아야 합니다.
**Q. 여러 개의 AI 모델을 등록할 수 있나요?**
A. 네, 여러 개를 등록해 두고 기능별로 원하는 모델을 선택해 전환할 수 있습니다.
***
### 기능 설명
#### 애플리케이션 프로토타입 개발
* **입력 방식:** 자연어로 업무 요구사항을 설명하거나 요구사항 문서를 업로드합니다.
* **생성 내용:** 데이터 테이블, 페이지 프로토타입, 모듈 구분, 내비게이션 메뉴 등
* **인터랙션 흐름:**
1. 단계적으로 생성하며, 언제든지 중단할 수 있습니다.
2. 생성 결과를 검토하고 수정할 수 있습니다.
3. 확인 후 프로젝트에 가져옵니다.
***
#### 지능형 데이터 모델링
* **입력 방식:** 자연어로 데이터 테이블 요구사항(필드, 관계 등)을 설명합니다.
* **생성 내용:** 시각화된 테이블 구조 및 샘플 데이터
* **인터랙션 흐름:**
1. 생성 후 필드 이름, 유형 등을 직접 편집할 수 있습니다.
2. 확인 후 프로젝트에 가져옵니다.
***
#### 보조 뷰 구축
* **입력 방식:** 자연어로 뷰 로직을 설명합니다(예: "이번 달 부진 재고 상품").
* **생성 내용:** 뷰 SQL 문 및 실시간 미리보기 결과
* **인터랙션 흐름:**
1. SQL 문을 수정하여 로직을 조정합니다.
2. 확인 후 프로젝트에 가져옵니다.
***
#### SQL 지능 생성
* **입력 방식:** 자연어로 조회 요구사항을 설명합니다(예: "매출액 상위 10위 고객 조회").
* **생성 내용:** 바로 실행 가능한 SQL 문
* **인터랙션 흐름:**
1. 생성 후 편집 및 최적화가 가능합니다.
2. 확인 후 현재 작업에 적용합니다.
***
### 주의사항
1. **모델 의존성:** 생성 결과는 설정된 LLM의 능력과 데이터 컨텍스트에 따라 제한되므로, 핵심 로직은 사람이 직접 검토하는 것을 권장합니다.
2. **데이터 보안:** 자체 API 설정으로 사용하는 모델은 기업의 데이터 컴플라이언스 요구사항을 충족해야 하며, 민감한 정보 유출을 방지해야 합니다. 특히 API 키는 비밀번호와 동일하게 취급하여 외부에 공유하거나 화면 캡처 등으로 노출되지 않도록 주의하세요.
3. **성능 고려:** 복잡한 생성 작업은 네트워크 지연이나 모델 응답 시간의 영향을 받을 수 있으므로, 단계별 대화로 생성하는 것을 권장합니다.
4. **피드백 개선:** 기술 포럼 등을 통해 생성 품질에 대한 개선 의견을 제출해 주시면, 프롬프트와 인터랙션 설계를 지속적으로 최적화하겠습니다.