코드 생성·편집
파이프라인 코드 편집기에서 AI로 Python·SQL 코드를 생성하거나 선택한 코드를 수정합니다. 제안된 변경 사항을 검토한 뒤 필요한 내용만 코드에 반영합니다.
AI 코드 생성
새 코드를 처음부터 작성할 때 AI 코드 생성 기능을 씁니다.
코드 생성하기
- 파이프라인의 코드 노드 에디터를 엽니다.
- 툴바의 AI를 누르거나 단축키
⌘I(macOS) /Ctrl+I(Windows)를 누릅니다. - 프롬프트 입력창이 나타나면 원하는 로직을 자연어로 설명합니다.
- 생성 버튼을 누르면 생성된 코드 미리보기가 표시됩니다.
- 코드를 검토한 뒤 삽입을 눌러 에디터에 적용하거나 취소로 닫습니다.
Esc를 눌러 AI 코드 생성 창을 닫을 수도 있습니다.
읽기 전용 에디터에는 삽입 대신 복사 버튼이 표시됩니다. 복사를 누르면 생성된 코드가 클립보드에 복사됩니다.
지원 언어
Python과 polars
D.Hub의 Python 코드 노드는 polars(데이터프레임 처리 라이브러리)로 데이터를 처리합니다. 생성된 코드는 다음 입출력 형식에 맞아야 합니다.
- 생성기는 기본 예시 이름인
input을 사용하는run(input, *, options=None, contexts=None)함수를 제안합니다. 실제 코드에서는 노드 옵션 탭의 입력 키를 매개변수 이름으로 사용합니다.options와contexts는 실행 엔진이 항상 전달합니다. - 생성기는 기본 예시 이름인
output을 사용해{"output": DataFrame}형태를 제안합니다. 딕셔너리 반환은 필수이며 키는 노드 옵션 탭의 출력 키와 같아야 합니다. - 데이터 처리는 polars의 Expression API를 사용합니다.
프롬프트 예시는 다음과 같습니다.
- "입력 데이터에서 'status'가 'active'인 행만 필터링해줘"
- "'amount' 컬럼의 날짜별 합계를 구하고, 결과를 내림차순으로 정렬해줘"
- "두 입력 데이터프레임을 'id' 컬럼 기준으로 조인해줘"
SQL
SQL 코드 노드에서 지원하는 문법과 함수는 SQL 참조에서 확인합니다. 파이프라인 입력 노드의 이름을 쿼리의 테이블 이름으로 사용합니다.
프롬프트 예시는 다음과 같습니다.
- "매출 테이블에서 월별 총매출을 집계해줘"
- "고객 테이블과 주문 테이블을 조인하고, 최근 30일 내 주문이 있는 고객만 조회해줘"
인라인 AI 편집
이미 작성한 코드를 고치거나 다듬을 때 인라인 AI 편집 기능을 사용합니다.
선택한 코드 편집하기
- 에디터에서 수정할 코드 영역을 드래그하여 선택합니다.
- 선택 영역 아래의 AI 편집을 누르거나
⌘I(macOS) /Ctrl+I(Windows)를 눌러 인라인 편집 창을 엽니다. - 편집창 상단에 선택한 코드와 선택 범위(줄 번호)가 표시됩니다. 무엇을 변경할까요? 입력란에 수정 지시를 입력합니다.
- AI가 제안한 코드가 생성된 코드 미리보기로 표시됩니다.
- 미리보기를 확인한 후 삽입으로 적용하거나 취소로 닫습니다.
Esc로도 닫을 수 있습니다.
활용 예시
| 요청 유형 | 프롬프트 예시 |
|---|---|
| 변수 이름 변경 | "변수명을 주문 합계를 나타내도록 바꿔줘" |
| 오류 처리 추가 | "이 부분에 null 값 처리 로직을 추가해줘" |
| 반복문 변경 | "이 루프를 polars Expression으로 변환해줘" |
| 주석 추가 | "각 단계에 설명 주석을 추가해줘" |
| 로직 수정 | "필터 조건을 'active'에서 'completed'로 변경해줘" |
AI가 참조하는 정보
코드를 생성하거나 편집할 때는 작성한 요청, 선택한 언어의 실행 규약, 에디터의 현재 코드와 커서가 있는 줄을 사용합니다. 코드 영역을 선택하면 선택한 코드도 함께 사용합니다.
연결된 데이터셋의 스키마와 파이프라인의 노드 구조는 자동으로 포함되지 않습니다. 필요한 컬럼명·데이터 타입·입출력 형태를 프롬프트에 직접 적고, 생성된 코드는 실행 전에 검토합니다.
프롬프트에는 바꿀 범위와 유지할 동작을 구체적으로 적습니다.
예: "입력 데이터에서 'created_at' 컬럼을 기준으로 최근 7일 데이터만 필터링하고, 'category'별 'amount' 합계를 구해줘"
단축키 요약
| 동작 | 단축키 |
|---|---|
| AI 코드 생성 / 인라인 편집 | ⌘I(macOS) / Ctrl+I(Windows) |
자주 묻는 질문
Q: AI가 생성한 코드가 실행되지 않아요.
- 프롬프트에 입력·출력 형태를 구체적으로 명시합니다.
- 사용한 컬럼명과 데이터 타입이 실제 입력 데이터와 일치하는지 확인합니다.
Q: 인라인 편집이 작동하지 않아요.
- 코드 영역을 먼저 선택한 후
⌘I(macOS) /Ctrl+I(Windows)를 눌러야 인라인 편집 모드가 활성화됩니다. - 아무것도 선택하지 않은 상태에서는 코드 생성 모드로 동작합니다.
Q: SQL 모드에서 테이블 이름을 어떻게 지정하나요?
- 파이프라인 SQL 노드는 노드 옵션 탭의 입력 키를 테이블 이름으로 사용합니다. AI가
input을 제안했더라도 실제 입력 키가 다르면 쿼리의 테이블 이름을 바꿉니다. 여러 입력을 구분하는 방법은 SQL 참조를 확인합니다.
주의 사항
- AI가 생성하거나 수정한 코드는 삽입하거나 실행하기 전에 미리보기에서 검토합니다. 예상과 다른 로직이 포함될 수 있습니다.
- 복잡한 비즈니스 로직은 단계별로 나누어 요청하고 각 결과를 검토합니다.
- 활성 어시스턴트 모델이 없거나 모델에 연결할 수 없으면 코드 생성이 실패합니다. 관리자는 시스템 → 설정 → 어시스턴트 모델에서 모델을 등록하고 활성 모델을 지정합니다. 어시스턴트 모델에서 설정 절차를 확인합니다.