> For the complete documentation index, see [llms.txt](https://cccr.gitbook.io/2025-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cccr.gitbook.io/2025-doc/ai.md).

# AI 기능 활용 가이드(신규)

### 1. 기능 사용 신청

* 사용을 원하는 팀(개인) 민관협력 지원 플랫폼 회원가입
* 팀이름/성명/연락처/이메일 회신(<support@cccr.or.kr>)

### 2. 바이브코딩 이란?

* 바이브 코딩은 사용자가 원하는 작업을 자연어로 설명하면 AI가 코드를 생성·수정하고, 실행 결과를 확인하며 대화형으로 개선해 나가는 코딩 방식
* 별도의 프로그래밍 문법을 직접 작성하지 않고도 원하는 작업을 자연어로 요청할 수 있어 데이터 분석의 진입 장벽을 낮출 수 있음
* 민·관협력 지원 플랫폼에서는 이러한 바이브 코딩 방식을 'AI 코딩 프롬프트' 기능으로 제공함
  * Python 코드를 셀(Cell) 단위로 작성·실행할 수 있는 환경을 구성하고, 자연어 요청을 기반으로 AI가 코드를 생성·수정할 수 있도록 지원
    * 셀(Cell) 기반 실행 환경 : 각 셀의 실행 결과를 바로 확인할 수 있음
    * AI 코딩 프롬프트 : 우측 패널에서 자연어로 작업을 요청하면 AI가 코드를 생성·수정하고, 생성된 코드의 반영 또는 변경·취소를 선택할 수 있도록 지원
  * 생성된 코드는 사용자가 실행 결과를 확인한 후 반영하거나 수정하는 방식으로 분석 과정의 편의성 및 효율성 향상
    * 실시간 협업 : 여러 사용자가 동시에 접속하여 작업할 수 있으며, 셀별 작업 상태를 공유하고 채팅을 통해 실시간 협업 가능
    * 데이터 및 버전 관리 : CSV·XLSX·JSON 파일을 등록·관리하고, 코드 버전별 저장 및 조회를 통해 분석 과정과 변경 이력을 관리

<figure><img src="https://3069609901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ffir65Z2DlWF3euMQuFL1%2Fuploads%2FkF1KbwJQI3NxzllB9s8Z%2Fimage.png?alt=media&amp;token=87b7218b-23cd-4994-b881-3248874fab58" alt=""><figcaption><p>&#x3C;그림 1. 플랫폼 상단 메뉴 클릭></p></figcaption></figure>

<table><thead><tr><th width="122" align="center">구분</th><th align="center">내용</th></tr></thead><tbody><tr><td align="center">실행 환경</td><td align="center">· 6 vCPU, RAM 8GB, 디스크 50GB, Python 3</td></tr><tr><td align="center">핵심 기능</td><td align="center">· 셀 작성·실생, AI 코딩 프롬프트, 채팅, 파일관리, 코드 버전 관리</td></tr></tbody></table>

<figure><img src="https://3069609901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ffir65Z2DlWF3euMQuFL1%2Fuploads%2FfCT4tV52ZoifZYrCX8PF%2F%EA%B7%B8%EB%A6%BC2.%20%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8%20%ED%99%94%EB%A9%B4%20%EA%B5%AC%EC%84%B1.png?alt=media&amp;token=a93fbaac-abbc-4d46-8fe5-ed331836c5cf" alt=""><figcaption><p>&#x3C;그림 2. 프로젝트 화면 구성></p></figcaption></figure>

<table><thead><tr><th width="156" align="center">영역</th><th align="center">주요 구성</th><th data-hidden></th></tr></thead><tbody><tr><td align="center">좌측 사이드바</td><td align="center">· 실행환경(CPU·RAM·디스크·언어), 파일(추가·새로고침·생성·다운로드·삭제), 코드 버전 보기, 현재 버전 저장 버튼</td><td></td></tr><tr><td align="center"> 중앙</td><td align="center">· 코드 셀 목록(In [n]) : 선택 체크박스, 실행·복사·삭제 버튼, 코드 편집 영역, 실행 결과와 결과 복사 버튼</td><td></td></tr><tr><td align="center">우측 패널</td><td align="center">· AI 코딩 프롬프트 탭(코딩 기록, 이력 메세지, 질문 입력창<br>· 채팅 탭<br>· 접속자 아바타</td><td></td></tr></tbody></table>

### 3. 바이브 코딩 공통 활용 방법

* 바이브 코딩 기반 범용 데이터 분석 6단계 공통 절차
  * 접속 및 확인
    * 로그인 후 상단 '프로젝트' 메뉴를 통해 바이브코딩 화면 진입, 상단에서 서비스 이용 기간(잔여 일수) 및 좌측에서 실행환경 확인
  * 파일 업로드
    * 좌측 '파일' 메뉴의 '+' 버튼을 통해 분석용 파일(CSV·XLSX·JSON)을 업로드하고 새로고침 아이콘을 클릭하여 파일 목록 갱신
  * 데이터 불러오기
    * 파일 항목의 '생성' 버튼 클릭 시, 데이터 로딩용 파이썬 코드가 포함된 셀 자동 생성
  * 셀 실행 및 결과 확인
    * 해당 셀의 '실행' 버튼 클릭 시 하단 영역에 실행 결과 즉시 표출
    * '결과 복사' 및 '복사' 기능을 통해 산출물과 코드 복사 지원
  * AI 자연어 요청 및 반영
    * 우측 'AI 코딩 프롬프트' 입력창에 요구사항 작성 시 AI가 코드를 자동 생성
    * 사용자 확인 후 '코드 반영' 또는 '변경 취소' 선택 적용
  * 버전 저장 및 협업
    * 좌측 하단 '현재 버전 저장' 클릭 시 작업 코드 버전 저장
    * 개별 셀 점유 상태 표시 및 우측 패널 채팅·이력 메세지를 활용한 실시간 동시 협업 지원
* 좌측 사이드바 기능

<figure><img src="https://3069609901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ffir65Z2DlWF3euMQuFL1%2Fuploads%2FMCQXno1jce4mJVun7if1%2F%EA%B7%B8%EB%A6%BC3.%20%EC%A2%8C%EC%B8%A1%20%EC%82%AC%EC%9D%B4%EB%93%9C%EB%B0%94%20%EA%B5%AC%EC%84%B1.png?alt=media&amp;token=a4d87cc1-a740-4b7a-9c01-89979179a29b" alt=""><figcaption><p>&#x3C;그림 3. 좌측 사이드바 구성></p></figcaption></figure>

<table><thead><tr><th width="143" align="center">항목</th><th align="center">상세 설명</th><th data-hidden></th></tr></thead><tbody><tr><td align="center">실행 환경</td><td align="center">· 실행 환경 정보 표시: CPU 6 vCPU, RAM 8GB, 디스크 50GB, 언어 Python 3 (ipykernel)</td><td></td></tr><tr><td align="center">파일 추가(+)</td><td align="center">· 파일 업로드<br>· 하단 안내 문구 : “CSV, XLSX, JSON만 업로드 가능합니다.”이며 형식 위반 시 “CSV, XLSX, JSON 형식의 파일만 업로드 가능합니다.” 알림 노출<br>· 최대 100MB 초과 시 “파일 용량이 제한 크기를 초과했습니다. 최대 100MB까지 업로드 할 수 있습니다.” 알림 노출</td><td></td></tr><tr><td align="center">새로고침 아이콘</td><td align="center">· 등록된 파일 목록을 최신 상태로 다시 불러옴</td><td></td></tr><tr><td align="center">파일 생성 버튼</td><td align="center">· 선택한 파일을 불러오는 셀을 자동 생성</td><td></td></tr><tr><td align="center"><p>파일 다운로드 </p><p>아이콘</p></td><td align="center">· 선택한 파일을 사용자 PC로 다운로드</td><td></td></tr><tr><td align="center">파일 삭제 아이콘</td><td align="center"> · 선택한 파일을 삭제하고, 삭제 이력을 우측 패널에 “○○ 파일을 ○○○님이 삭제했습니다.” 형태로 기록</td><td></td></tr><tr><td align="center">코드 버전 목록</td><td align="center"> · 저장된 코드 버전(ver.1.3, ver.1.2 등)을 최신순으로 표시하며, 목록이 길어질 경우 스크롤을 통해 조회</td><td></td></tr><tr><td align="center">버전 보기 버튼</td><td align="center">· 저장된 특정 버전을 레이어 팝업으로 열람하고, 정의서 기준 해당 버전의 코드 복사 기능 제공</td><td></td></tr><tr><td align="center">현재 버전 저장</td><td align="center">· 현재 작성된 코드를 새로운 버전으로 저장하며, 저장 시 버전 번호를 자동 증가하여 관리</td><td></td></tr></tbody></table>

* 중앙 셀 영역·우측 패널 기능

<figure><img src="https://3069609901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ffir65Z2DlWF3euMQuFL1%2Fuploads%2FhlPqgr8f307C32kDvgnX%2F%EA%B7%B8%EB%A6%BC4.%20%EC%A4%91%EC%95%99%20%EC%85%80%20%EC%98%81%EC%97%AD%C2%B7%EC%9A%B0%EC%B8%A1%20%ED%8C%A8%EB%84%90%20%EA%B5%AC%EC%84%B1.png?alt=media&amp;token=67917a30-e1fd-4ec5-8b23-83d0105b4be7" alt=""><figcaption><p>&#x3C;그림 4. 중앙 셀 영역·우측 패널 구성></p></figcaption></figure>

<table><thead><tr><th width="158" align="center">항목</th><th align="center">상세 설명</th></tr></thead><tbody><tr><td align="center">셀 선택 체크박스</td><td align="center">· 셀을 선택하며, 선택 시 해당 셀을 점유하여 작업 중 다른 사용자의 수정·삭제를 제한</td></tr><tr><td align="center">실행 버튼</td><td align="center">· 선택한 셀의 코드를 실행하고, 셀 하단에 실행 결과를 표시</td></tr><tr><td align="center">작업 중 표시</td><td align="center">· 다른 사용자가 셀을 점유한 경우 사용자 아바타와 “테스트사용자 작업 중” 등의 작업 상태를 셀 상단에 표시</td></tr><tr><td align="center">실행 버튼 비활성</td><td align="center">· 다른 사용자가 점유한 셀은 실행 버튼을 비활성화하고, 해당 셀 선택 시 “○○○님이 작업을 진행 중입니다.” 알림창 노출</td></tr><tr><td align="center">복사 버튼</td><td align="center">· 셀에 작성된 코드 내용을 복사할 수 있도록 지원</td></tr><tr><td align="center">셀 삭제(X)</td><td align="center">· 셀 삭제 시 확인창을 노출하고, 사용자 확인 후 해당 셀 삭제</td></tr><tr><td align="center">코드 편집 영역</td><td align="center">· 줄 번호 및 구문 강조가 적용된 파이썬 코드 편집 영역 제공하며, ‘파일 생성’으로 생성된 셀은 코드 자동 구성</td></tr><tr><td align="center">실행 결과 영역</td><td align="center">· 코드 실행에 따른 출력 결과(print 등)를 셀 하단에 표시</td></tr><tr><td align="center">결과 복사 버튼</td><td align="center">· 실행 결과를 복사할 수 있도록 지원</td></tr><tr><td align="center">AI 코딩 프롬프트 탭</td><td align="center">· 우측 패널의 기본 탭으로 구성하며, 선택된 탭은 진한 배경으로 구분</td></tr><tr><td align="center">채팅 탭</td><td align="center">· 동시 접속자 간 실시간 대화를 지원하며, 작성 중인 내용이 있는 상태에서 탭 이동 시 작성 내용 삭제 여부를 확인하는 알림창 노출</td></tr><tr><td align="center">접속자 아바타</td><td align="center">· 현재 접속 중인 사용자를 이니셜 형태의 아바타로 표시</td></tr><tr><td align="center">이력 자동 기록</td><td align="center">· 셀 추가·수정·삭제 등 작업 발생 시 사용자 및 작업 이력을 자동 기록</td></tr><tr><td align="center">코딩 기록</td><td align="center">· 날짜별 AI 코딩 프롬프트 및 작업 이력을 조회할 수 있는 화면으로 전환</td></tr><tr><td align="center">이력 메시지 영역</td><td align="center">· 시간과 함께 셀 추가, 파일 업로드·삭제 등의 작업 이력을 표시하고, AI가 생성한 코드 블록의 일부를 함께 제공</td></tr><tr><td align="center">질문 입력창</td><td align="center">· “AI에게 물어보세요.” 안내 문구가 표시되는 자연어 기반 AI 질문 입력 영역 제공</td></tr><tr><td align="center">질문 전송 버튼</td><td align="center">· 입력한 AI 요청을 전송</td></tr></tbody></table>

* 코딩 기록 조회

<figure><img src="https://3069609901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ffir65Z2DlWF3euMQuFL1%2Fuploads%2FF74D4SSQlMzLji9rgQZh%2F%EA%B7%B8%EB%A6%BC5.%20%EC%BD%94%EB%94%A9%20%EA%B8%B0%EB%A1%9D%20%EC%A1%B0%ED%9A%8C%20%EA%B5%AC%EC%84%B1.png?alt=media&amp;token=f706f545-0bef-4ad2-9406-51db83d40dc9" alt=""><figcaption><p>&#x3C;그림 5. 코딩 기록 조회 구성></p></figcaption></figure>

<table><thead><tr><th width="165" align="center">항목</th><th align="center">상세 설명</th></tr></thead><tbody><tr><td align="center">코딩 기록</td><td align="center">· 최근 날짜순으로 AI 코딩 프롬프트 기록된 날짜를 표시하며, 지난 7일(날짜) / 더보기(+7일) 영역으로 구성하고 채팅 탭은 숨김 처리</td></tr><tr><td align="center">코딩 일자</td><td align="center">· 현재 대화 선택 시 기존 AI 코딩 프롬프트 화면으로 이동하고, 이전 날짜 선택 시 해당 날짜의 AI 코딩 프롬프트 내용을 조회하며 AI 작성 영역은 숨김 처리</td></tr><tr><td align="center">더보기</td><td align="center">· 클릭 시 과거 7일의 날짜가 추가로 불러와 목록에 표시</td></tr></tbody></table>

* 채팅 탭

<figure><img src="https://3069609901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ffir65Z2DlWF3euMQuFL1%2Fuploads%2FrxpnBdulKz85NASNs6Gr%2F%EA%B7%B8%EB%A6%BC6.%20%EC%B1%84%ED%8C%85%20%ED%83%AD%20%EA%B5%AC%EC%84%B1.png?alt=media&amp;token=e8019a59-cf70-438c-809f-848f970b9372" alt=""><figcaption><p>&#x3C;그림 6. 채팅 챕 구성></p></figcaption></figure>

<table><thead><tr><th width="162" align="center">항목</th><th align="center">상세 설명</th></tr></thead><tbody><tr><td align="center">채팅 탭</td><td align="center">· 접속자 간 실시간 채팅 화면으로 전환</td></tr><tr><td align="center">채팅 작성 영역</td><td align="center">· 채팅 내용을 입력할 수 있는 입력창과 작성 버튼으로 구성</td></tr></tbody></table>

### 4. 제한 범위

* 데이터 등록 제한

<table><thead><tr><th width="116" align="center">항목</th><th width="140" align="center">지원 형식</th><th width="93" align="center">최대 용량</th><th align="center">제한 위반 시 안내 문구</th></tr></thead><tbody><tr><td align="center"><p>파일 업로드</p><p>(좌측 파일 +)</p></td><td align="center">CSV, XLSX, JSON</td><td align="center">100MB</td><td align="center"><p>· “CSV, XLSX, JSON 형식의 파일만 업로드 가능 합니다.” 알림창 표시</p><p>·  “파일 용량이 제한 크기를 초과했습니다. 최대 100MB까지 업로드 할 수 있습니다.” 알림창 표시</p></td></tr></tbody></table>

* 협업·편집 제한

<table><thead><tr><th width="96" align="center">기능</th><th width="347" align="center">제한 내용</th><th align="center">안내 방식</th></tr></thead><tbody><tr><td align="center">셀 점유</td><td align="center">· 사용자가 ‘선택’하면 해당 셀을 점유하며, 다른 사용자는 수정·삭제할 수 없음</td><td align="center">· 셀에 “○○○ 작업 중” 표시, 클릭 시 “○○○님이 작업을 진행 중 입니다” 알림창 표시</td></tr><tr><td align="center">셀 삭제</td><td align="center">· 삭제 전 확인 필수</td><td align="center">· “이 셀을 삭제 하시겠습니까?” 확인창 표시</td></tr><tr><td align="center">탭 이동</td><td align="center">· 입력 중인 질문이 있을 때 다른 탭(AI 코딩 프롬프트 ↔ 채팅)으로 이동하면 작성 내용이 사라짐</td><td align="center">· “작업 중인 내용이 있습니다. 탭을 이동하면 작성한 내용이 사라집니다. 이동 하시겠습니까?” 확인창 표시</td></tr></tbody></table>

* AI 코드 생성·반영 제한

<table><thead><tr><th width="112" align="center">기능</th><th width="254" align="center">제한 내용</th><th align="center">안내 방식</th></tr></thead><tbody><tr><td align="center">코드 반영</td><td align="center">· AI 생성 코드는 사용자가 확인해야만 현재 코드로 변경됨</td><td align="center">· “AI가 생성한 코드를 반영 하시겠습니까?” 확인창 표기</td></tr><tr><td align="center">변경 취소</td><td align="center">· 확인 시 AI 질문 이전 상태로 복원</td><td align="center">· “AI가 생성한 코드 변경사항을 취소하시겠습니까?” 확인창 표기</td></tr><tr><td align="center">답변 생성 중</td><td align="center">· 생성 중에는 로딩 상태가 표시됨</td><td align="center">· “AI가 코드를 생성하고 있습니다.” 표시</td></tr></tbody></table>

* 버전·이력 조회 제한

<table><thead><tr><th width="190" align="center">기능</th><th align="center">제한 내용</th></tr></thead><tbody><tr><td align="center">코드 버전 보기<br>(레이어 팝업)</td><td align="center">· 저장된 버전은 ‘코드 복사’만 가능하며 수정은 불가</td></tr><tr><td align="center">버전명</td><td align="center">· ver.1.2, ver.1.1… 자동 증가(사용자 임의 지정 불가)</td></tr><tr><td align="center"><p>코딩 기록</p><p>(오늘이 아닌 날짜)</p></td><td align="center">· 조회 전용: 채팅 탭과 AI 질문 입력창·작성 버튼 숨김</td></tr><tr><td align="center">날짜 목록 노출</td><td align="center">· 지난 7일 중심으로 표시하고 ‘더보기’ 시 7일 날짜 목록 추가</td></tr></tbody></table>
