AI 기능
ChatGPT · Claude · Gemini 중 하나를 골라 내 API 키를 넣으면, 캔버스 오른쪽의 AI 어시스턴트 패널에서 말로 ERD를 만들고 고칠 수 있습니다. AI가 바꾼 내용은 모두 Ctrl+Z로 되돌릴 수 있습니다. 다른 곳에서 만든 설계를 JSON으로 붙여 넣어 엔티티를 만드는 기능은 AI 서비스에 연결하지 않고 동작합니다.
이럴 때 씁니다
- "쇼핑몰 주문 시스템 테이블을 설계해 줘"처럼 말로 설명하고 초안 ERD를 빠르게 받고 싶을 때.
- 모든 테이블에 등록일 · 수정일 컬럼을 넣는 것처럼 여러 테이블에 같은 작업을 한 번에 하고 싶을 때.
- 지금 설계가 올바른지 검토받거나, 설계 구조를 쉬운 말로 설명받고 싶을 때.
- 다른 AI 챗에서 만든 테이블 설계를 RelatiQ 캔버스로 옮기고 싶을 때(JSON 붙여넣기).
메뉴 위치
- AI 설정: 툴바 오른쪽 끝 환경설정(톱니바퀴) → AI 기능 설정 탭.
- AI 어시스턴트 패널: 툴바 오른쪽의 초록색 ✦ 버튼(AI 어시스턴트). AI 기능을 켜고 저장해야 버튼이 나타납니다. 다시 누르거나 패널의 ✕를 누르면 닫힙니다.
- JSON 붙여넣기: 캔버스 빈 곳을 마우스 오른쪽 버튼으로 클릭 → JSON 붙여넣기.
- JSON 복사: 엔티티를 마우스 오른쪽 버튼으로 클릭 → JSON 복사.
준비 — AI 기능 켜기
AI 기능은 처음에는 꺼져 있습니다. 사용할 AI 서비스에서 API 키를 발급받은 뒤 아래 순서로 켭니다.
- 환경설정을 엽니다
툴바 오른쪽 끝 환경설정을 누르고 AI 기능 설정 탭을 고릅니다.
- AI 기능을 켭니다
AI 기능을 사용여부에서 AI 기능을 사용합니다.를 체크합니다.
- AI 서비스를 고릅니다
사용할 AI 선택에서 ChatGPT · Claude · Gemini 중 하나를 고릅니다. 고른 서비스의 API 키 칸만 나타납니다.
- API 키를 넣습니다
ChatGPT API KEY · Claude API KEY · Gemini API KEY 중 보이는 칸에 키를 붙여 넣습니다. 키가 없으면 API KEY 발급받는 곳 옆의 링크를 눌러 그 서비스의 키 발급 페이지에서 받습니다.
- 모델을 고릅니다
AI 모델 선택에서 모델을 고릅니다. 모델은 각 AI 서비스가 수시로 추가하고 없애므로, 쓸 수 있는 최신 목록은 AI 어시스턴트 패널의 ⟳ 버튼으로 받아 옵니다.
- 저장합니다
환경설정 저장을 누르면 "저장되었습니다."가 나오고 툴바에 ✦ 버튼이 나타납니다.
- AI 서비스 사용 요금은 각 AI 서비스의 요금제에 따라 내 API 계정에 청구됩니다.
- API 키는 이 PC의 설정 파일에 암호화해 저장하며, 고른 AI 서비스에 요청할 때만 씁니다.
AI 어시스턴트 패널
✦ 버튼을 누르면 캔버스 오른쪽에 대화 패널이 열립니다. 패널과 캔버스 사이의 경계를 끌어 패널 폭을 바꿀 수 있습니다. 요청을 말로 적으면 AI가 엔티티 만들기, 컬럼 추가, 관계 잇기, DDL 만들기 같은 RelatiQ의 기능을 골라 실행하고, 결과가 캔버스에 바로 나타납니다.
| 위치 | 이름 | 하는 일 |
|---|---|---|
| 맨 위 | AI 어시스턴트 · ✕ | 패널 제목. ✕를 누르면 패널을 닫습니다. |
| 윗줄 | AI 서비스 · 모델 · ⟳ | 이번에 쓸 AI 서비스와 모델을 바꿉니다. 바꿔도 대화는 이어집니다. 모델 칸에는 목록에 없는 모델 이름을 직접 입력할 수도 있습니다. ⟳를 누르면 고른 서비스에서 지금 쓸 수 있는 모델 목록을 받아 옵니다. |
| 아랫줄 | 적용 방식 · 테이블 생성 시 확인 | AI의 변경을 캔버스에 어떻게 반영할지 정합니다(아래 표). |
| 가운데 | 대화 영역 | 내 요청, AI의 답, AI가 실행한 작업(성공 ✔ · 실패 ✘)이 차례로 쌓입니다. 말풍선을 마우스 오른쪽 버튼으로 클릭하고 복사를 고르면 그 말풍선의 글이 복사됩니다. |
| 입력 칸 위 | 이렇게 시켜보세요 | 대화가 비어 있을 때 추천 문장이 보입니다. 누르면 입력 칸에 들어갑니다. |
| 맨 아래 | 입력 칸 · 보내기 · 중단 · 새 대화 | Enter로 보내고 Shift+Enter로 줄을 바꿉니다. 중단은 진행 중인 요청을 멈춥니다. 새 대화는 대화를 처음부터 다시 시작합니다(캔버스의 ERD는 그대로). |
| 맨 아래 줄 | 상태 | 지금 프로젝트의 데이터베이스 종류("DB: …")나 "AI 가 생각 중"을 보여 줍니다. |
적용 방식
| 이름 | 하는 일 |
|---|---|
| 자동 적용(기본) | AI가 고른 변경을 바로 캔버스에 반영합니다. |
| 확인 후 적용 | 캔버스를 바꾸는 작업마다 먼저 확인 창을 띄웁니다. |
| 읽기 전용 | AI는 ERD를 읽기만 합니다. 검토 · 설명만 받고 캔버스는 바꾸지 않을 때 씁니다. |
| 테이블 생성 시 확인(기본 켜짐) | 테이블 만들기 · 테이블 삭제 · 여러 테이블 한꺼번에 적용 전에 확인 창을 띄웁니다. AI가 요청을 잘못 알아듣고 엉뚱한 테이블을 만드는 일을 막아 줍니다. |
캔버스의 모든 객체를 지우는 작업과, 캔버스를 비우고 새로 그리는 작업은 적용 방식과 관계없이 항상 확인 창을 띄웁니다.
확인 창(AI 변경 확인)에는 "AI 가 다음 작업을 실행하려고 합니다."와 함께 만들 테이블 이름 · 컬럼 수, 적용할 테이블 · 관계 수 같은 요약이 나옵니다. 예를 누르면 실행하고, 아니요를 누르면 실행하지 않습니다. 거부하면 AI가 다른 방법을 제안하거나 다시 묻습니다.
대화 기록
- 앞선 대화를 기억하므로 "거기에 created_at 도 추가해"처럼 이어서 말할 수 있습니다.
- 저장한 프로젝트라면 대화가 프로젝트 파일 옆에
프로젝트 파일 이름.RelatiQ.chat.json파일로 함께 보관됩니다. 다음에 그 프로젝트를 열고 패널을 열면 "이전 대화를 불러왔습니다."가 나오며 이어집니다. - 아직 저장하지 않은 프로젝트에서는 대화가 이번 실행 동안만 유지됩니다("프로젝트를 저장하면 이 대화도 함께 보관됩니다.").
- 새 대화를 누르면 저장된 대화 기록을 지울지 묻습니다. 지워도 캔버스의 ERD는 그대로입니다.
따라 하기
말로 ERD 만들기
- 프로젝트를 엽니다
새 프로젝트를 만들거나 기존 프로젝트를 엽니다. 데이터 타입은 프로젝트의 데이터베이스 종류에 맞춰집니다. 데이터베이스 종류가 정해지지 않았으면 AI가 어떤 데이터베이스인지 먼저 묻습니다.
- 패널을 엽니다
툴바의 ✦ 버튼을 누릅니다.
- 요청을 적습니다
예: "수퍼마켓 POS 시스템 데이터 설계를 해줘". 추천 문장을 눌러도 됩니다. Enter로 보냅니다.
- 확인 창에서 고릅니다
테이블 생성 시 확인이 켜져 있으면 만들 테이블 · 관계 수를 보여 줍니다. 맞으면 예를 누릅니다.
- 결과를 보고 이어서 고칩니다
엔티티와 관계선이 캔버스에 나타나고, AI가 한 일을 대화로 요약합니다. "회원 테이블에 휴대폰 번호 컬럼을 추가해"처럼 이어서 요청합니다.
- 되돌리거나 저장합니다
마음에 들지 않으면 Ctrl+Z로 되돌립니다. 결과를 남기려면 Ctrl+S로 직접 저장합니다.
이렇게 말해 보세요
- "회원(MEMBER)과 주문(ORDER) 엔티티를 만들고 1:N 으로 연결해"
- "모든 테이블에 등록일/수정일 컬럼을 추가해줘"
- "현재 DB 구조가 올바른지 검증해줘"
- "지금 설계 구조를 알기 쉽게 설명해줘"
- "관계선을 베지어 곡선으로 바꿔줘"
- "게시판 서비스용 테이블 구조를 만들어줘"
JSON 붙여넣기(AI 서비스 연결 없음)
다른 AI 챗이나 문서에서 만든 테이블 설계를 정해진 형식의 JSON으로 붙여 넣으면 엔티티와 관계선이 만들어집니다. AI 서비스에 연결하지 않으므로 API 키가 없어도 됩니다.
- JSON을 복사합니다
붙여 넣을 JSON 글을 복사합니다.
- 창을 엽니다
캔버스 빈 곳을 마우스 오른쪽 버튼으로 클릭하고 JSON 붙여넣기를 고릅니다. 클립보드에 이 형식의 JSON이 있으면 입력 칸에 자동으로 들어갑니다.
- 확인을 누릅니다
확인을 누르면 엔티티와 관계선이 만들어지고 "엔티티가 생성되었습니다."가 나옵니다. 형식이 틀리면 "JSON 파싱 오류"가 나옵니다. 붙여 넣은 결과가 마음에 들지 않으면 Ctrl+Z로 되돌립니다.
JSON의 형식은 다음과 같습니다.
| 항목 | 들어가는 내용 |
|---|---|
Entities | 엔티티 목록. 엔티티마다 name(테이블 이름), attributes(컬럼 목록), locationX · locationY(캔버스 위치) |
attributes의 컬럼 | name(컬럼 이름), type(데이터 타입, 예: varchar(50)), isPK(기본키이면 true), isFK(FK 컬럼이면 true) |
RefLines | 관계 목록. 관계마다 name(관계 이름), parent(부모 엔티티 이름), child(자식 엔티티 이름), lineType(1:n 또는 1:1) |
isFK가true인 컬럼은 따로 만들지 않습니다. 관계선을 만들 때 부모의 PK가 자식에 FK 컬럼으로 들어가기 때문입니다.parent·child에는 같은 JSON 안의 엔티티 이름을 그대로 씁니다.lineType이1:n이면 비식별 관계선,1:1이면 식별 관계선으로 그립니다.n:1로 적힌 관계는parent와child를 바꿔 읽어 비식별 관계선으로 그립니다(→ 관계선(FK) 편집).
형식 견본 얻기: 캔버스의 엔티티를 마우스 오른쪽 버튼으로 클릭하고 JSON 복사를 고르면 그 엔티티가 같은 형식으로 복사됩니다("JSON이 클립보드에 복사되었습니다."). 이 견본을 다른 AI 챗에 보여 주고 "이 형식으로 만들어 줘"라고 요청하면 붙여 넣기 좋은 결과를 받을 수 있습니다.
알아 두기
AI가 바꾼 내용(말로 만든 ERD 포함)은 캔버스에 바로 반영되고, 직접 고친 것과 똑같이 Ctrl+Z · Ctrl+Y로 되돌리고 다시 실행할 수 있습니다. 프로젝트도 고친 것으로 표시되어(제목줄 점 ●), 저장하지 않고 닫으려 하면 저장할지 묻습니다.
AI의 답이나 만들어 준 SQL을 다른 곳에 쓰려면 말풍선을 마우스 오른쪽 버튼으로 클릭하고 복사를 고릅니다.
화면 언어를 바꾸면 열어 둔 AI 어시스턴트 패널의 글자도 바로 새 언어로 바뀝니다.
패널에서 바꾼 AI 서비스 · 모델은 이번 실행 동안 쓰입니다. 늘 쓸 서비스와 모델은 환경설정의 AI 기능 설정에서 정하고 환경설정 저장을 누르세요.
처음에는 확인 후 적용으로 AI가 무엇을 하려는지 하나씩 확인하며 써 보세요. 설계 검토만 받으려면 읽기 전용이 안전합니다.
AI 기능을 쓰는 동안에는 입력한 요청과, AI가 작업하려고 읽은 ERD 내용(테이블 · 컬럼 이름, 데이터 타입 등)이 고른 AI 서비스로 전송됩니다. 패널을 처음 열 때, 패널에서 AI 서비스를 바꿀 때, ⟳를 누를 때는 쓸 수 있는 모델 목록을 확인하려고 그 서비스에 연결합니다. AI 기능을 쓰지 않으면 이런 전송은 없습니다.
환경설정의 API 키 칸은 글자가 가려지지 않습니다. 화면을 공유하거나 캡처할 때 키가 보이지 않게 하세요.
대화 기록 파일(.chat.json)은 암호화하지 않은 글 파일입니다. 비밀번호 같은 민감한 내용은 대화에 넣지 마세요.
AI는 요청을 잘못 이해할 수 있습니다. 환경설정 AI 기능 설정 탭의 안내처럼 의도하지 않은 결과가 나올 수 있으니, 결과를 확인한 뒤 저장하세요. AI는 저장까지 대신하지 않으므로 저장은 직접 합니다.
- AI 기능은 무료판에서도 모두 쓸 수 있습니다.
- 외부 AI 툴(Claude Desktop · Cursor 등)에서 RelatiQ를 조작하려면 MCP 연동을 참고하세요. 앱 안의 AI 어시스턴트와 같은 기능을 씁니다.
자주 묻는 것
툴바에 ✦ 버튼이 없어요.
환경설정 AI 기능 설정 탭에서 AI 기능을 사용합니다.를 체크하고 환경설정 저장을 누르세요.
"AI 설정이 준비되지 않았습니다. 환경설정에서 AI 사용을 켜고 API Key 를 입력하세요."가 나옵니다.
지금 고른 AI 서비스의 API 키가 비어 있습니다. 환경설정에서 그 서비스의 키를 넣고 저장하세요. 패널에서 AI 서비스를 바꿨다면 바꾼 서비스의 키도 필요합니다.
"API 인증 오류"가 나옵니다.
API 키가 틀렸거나 만료된 경우입니다. 그 AI 서비스의 키 관리 페이지에서 키를 확인하고 새로 넣으세요.
"API 할당량 오류"가 나옵니다.
API 계정의 크레딧이 떨어졌거나 결제 정보가 없는 경우가 많습니다. 그 AI 서비스의 결제 · 사용량 페이지를 확인하세요.
원하는 모델이 목록에 없어요.
패널의 ⟳를 누르면 고른 서비스에서 쓸 수 있는 모델 목록을 새로 받아 옵니다. 목록에 없어도 모델 칸에 이름을 직접 입력할 수 있습니다.
내 설계 내용이 RelatiQ 회사로 전송되나요?
아니요. AI 요청은 내 API 키로 고른 AI 서비스에 바로 전송됩니다. JSON 붙여넣기는 어디에도 전송하지 않습니다.