[]
홈페이지 온라인 스터디 문의하기 다운로드
(Showing Draft Content)

설계단계에서의 AI

설계단계에서의 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 키)"를 먼저 준비해서 포건시에 입력해야 합니다.

image

💡 "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) 등 세부 옵션입니다. 처음에는 기본값을 두어도 무방합니다.

-

  1. [테스트]를 눌러 정상 연결을 확인합니다. 실패하면 API Host, API Key, 모델명의 오탈자를 다시 확인하세요.


  2. [확인]을 눌러 저장합니다.

image

등록된 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. 피드백 개선: 기술 포럼 등을 통해 생성 품질에 대한 개선 의견을 제출해 주시면, 프롬프트와 인터랙션 설계를 지속적으로 최적화하겠습니다.