CoCo Desktop의 에이전트형 노트북(Agentic Notebook)

CoCo Desktop 에이전트는 채팅에서 직접 Jupyter 노트북(.ipynb 파일)과 작업할 수 있어요. 에이전트에게 평문 영어로 요청하면 귀하처럼 코드를 작성하고, 셀을 실행하고, 결과를 읽고, 반복해요. 채팅 패널을 떠날 필요가 없어요.

출처: Agentic Notebook in CoCo Desktop

본문

에이전트가 다단계 데이터 탐색이나 모델 개발을 수행하게 하려면 Agentic Notebook 워크플로를 사용해요. 예를 들어: Snowflake 테이블을 DataFrame으로 로드하고, 스키마를 프로파일링하고, 차트를 그린 뒤, 커널이 반환하는 것에 기반해 코드를 다듬기.

에이전트가 작성한 셀은 Keep / Undo 컨트롤과 함께 인라인으로 나타나므로 수락하기 전에 각 편집을 검토할 수 있어요.

주의 노트북 지원은 기본 제공되며 설치하거나 활성화할 것이 없어요. 에이전트는 열려 있는 노트북과 그에 연결된 커널로 작업해요.

사전 요구 사항

CoCo Desktop 설치 및 로그인.
머신에 사용 가능한 Jupyter 커널(예: 번들 Python 환경, conda 환경, 또는 원격 Jupyter 서버).
워크스페이스에 열린 .ipynb 파일, 또는 에이전트가 만들 권한.

에이전트가 노트북으로 작업하는 방법

노트북에서 무언가를 하라고 요청하면 에이전트는 사람과 같은 단계를 밟아요. 커널이 준비되었는지 확인하고, 셀을 작성하거나 편집하고, 실행하고, 다음에 무엇을 할지 결정하기 전에 출력을 읽어요. 모든 변경은 검토할 수 있도록 인라인으로 표시돼요.

높은 수준에서 에이전트는 다음을 할 수 있어요.

셀 작성 및 편집 — 에이전트는 새 코드 또는 Markdown 셀을 추가하고, 기존 셀을 편집하고, 더 이상 필요하지 않은 셀을 제거해요.
커널에서 코드 실행 — 에이전트는 선택한 커널에 대해 단일 셀, 셀 범위 또는 전체 노트북을 실행해요. 커널이 연결되지 않았다면 에이전트가 커널 선택기를 열어 선택하게 해요.
결과 읽기 — 실행 후 에이전트는 셀 출력(출력된 값, DataFrame, 차트, 오류)을 읽고 다음 단계를 계획하는 데 사용해요.
데이터 검사 — 에이전트는 커널의 변수를 나열하고, DataFrame의 스키마나 샘플 행을 들여다보고, 셀을 남기지 않고 빠른 표현식을 평가할 수 있어요.
커널 관리 — 에이전트는 막힌 셀을 중단하거나, 상태를 지워야 할 때 커널을 다시 시작할 수 있으며, 적절할 때 먼저 프롬프트를 표시해요.

내내 귀하가 통제권을 유지해요. 에이전트가 제안하는 모든 셀에는 Keep과 Undo 버튼이 있어 변화가 고착되기 전에 수락, 거부, 다듬기를 할 수 있어요.

커널이 연결되지 않았다면 에이전트는 Select Kernel 선택기를 열어 선택하게 해요.

예시 워크플로

코드 생성 및 실행

에이전트에게 분석을 작성하라고 요청해요("100행의 샘플 DataFrame을 생성해줘" 또는 "SALES에서 월별 매출을 그려줘"). 에이전트가 셀을 작성하면 Keep을 클릭하고, 에이전트가 실행하고 출력과 함께 보고해요.

DataFrame 탐색

"이 데이터셋이 어떻게 생겼지?"라고 물으면 에이전트는 커널에 이미 있는 DataFrame을 검사하고, 스키마와 샘플 행을 검색하고, 후속 분석 코드를 작성하기 전에 발견 사항을 요약해요.

팁

저장하기 전에 셀을 검토하기. 인라인 Keep / Undo 컨트롤을 사용해 에이전트가 작성한 각 셀을 수락하거나 거부해요. 먼저 셀을 편집한 뒤 keep할 수 있어요.
패키지가 있는 커널 선택하기. 에이전트의 코드가 누락된 import로 실패하면 노트북 도구 모음의 Select Kernel로 커널을 전환해요.
상태가 혼란스러우면 다시 시작하기. 여러 번 반복 후 결과가 말이 안 된다면 에이전트에게 커널을 다시 시작하고 위에서 다시 실행하라고 요청해요.
데이터에 대해 구체적으로 말하기. 에이전트가 추측하지 않도록 프롬프트에 테이블 이름, 열 이름 또는 DataFrame 변수 이름을 언급해요.

문제 해결

셀 실행 시 "No kernel attached"

코드가 실행되기 전에 노트북에 커널이 필요해요. 노트북 도구 모음의 Select Kernel을 클릭하고(또는 에이전트가 선택기를 열게 하고) Python 환경, 로컬 Jupyter 커널 또는 기존 Jupyter 서버를 선택해요.

셀이 멈춘 것처럼 보임

오래 실행되는 코드는 커널을 바쁘게 유지할 수 있어요. 에이전트에게 셀을 중단하라고 요청하거나, 노트북 도구 모음의 Restart 작업을 사용해 상태를 지우고 다시 시작해요.

DataFrame 검사가 오류를 반환함

DataFrame 검사 기능은 pandas, polars, PySpark, Snowpark DataFrame을 지원해요. 다른 라이브러리로 작업 중이라면 에이전트에게 그것을 일반 변수로 검사하라고 요청해요.

에이전트의 편집이 적용되지 않음

이것은 보통 에이전트가 마지막으로 읽은 이후 셀 내용이 변경되었을 때 발생해요. 에이전트에게 셀을 다시 읽고 다시 시도하라고 요청해요.

CoCo Desktop의 에이전트형 노트북(Agentic Notebook)