지니 코드 사용

Genie Code를 사용하면 개발자가 Azure Databricks Notebook, SQL 편집기, 작업, AI/BI 대시보드 및 파일 편집기에서 코드를 생성, 최적화, 설명 및 수정할 수 있습니다.

Genie Code가 코드에 어떻게 도움이 되는지 알아보려면 Genie Code에서 코딩 도움말 가져오기를 참조하세요.

지니 코드 창 둘러보기

지니 코드 창을 열려면 스파클 지니 코드 아이콘 을 클릭합니다. 페이지의 오른쪽 위 모서리에 있습니다.

Genie Code 사이드 창에 여러 채팅이 탭으로 열려 있습니다.

창 아래쪽의 텍스트 상자에 프롬프트를 입력한 다음 Enter 키를 누르거나 보내기 아이콘을 클릭합니다. 다음을 할 수 있습니다:

  • 플러스 아이콘을 클릭하세요. 플러스 아이콘을 통해 파일을 첨부하거나 맥락을 참조하거나 연결 추가를 할 수 있습니다.
  • Genie Code를 참고할 자료를 선택하려면 입력 @ 하세요.
  • / 선택하고 실행하려면 입력 합니다.
  • Genie Code가 응답 품질과 비용을 어떻게 균형 있게 맞출지 선택하세요. ' 노력 수준 선택'을 참조하세요.

Genie Code에서 코드를 지원하라는 메시지가 표시되면 제안되는 변경 내용을 실행, 수락 또는 거부하는 방법을 안내합니다.

노력 수준을 선택하세요

프롬프트 박스의 선택기는 현재 노력 수준을 보여주고 대화 시 변경할 수 있습니다:

  • 자동 (기본값, 권장): 이 단계는 모든 작업에 최고 품질을 제공합니다.
  • 낮음: 이 수준은 단순한 작업에 대한 비용을 낮춥니다.

지니 코드는 대화 중에 선택한 것을 저장해 둡니다. 레벨이 없으면 셀렉터가 나타나지 않습니다.

파일 첨부

현재 채팅의 컨텍스트로 파일을 첨부하려면 프롬프트 박스의 Plus 아이콘을 클릭하거나 프롬프트 박스에 파일을 드래그 앤 드롭하세요.

Genie Code는 다음과 같은 파일 형식을 지원합니다: .png, .jpg.jpeg.gif.xlsx.webp.json.pdf.xls.csv.jsonl.

기본적으로 Genie Code는 현재 채팅에서 첨부된 파일만 사용하며, 작업 공간 파일 시스템에 저장하지 않습니다. 파일을 보관하려면 Genie Code에게 작업 공간에 저장해 달라고 요청하세요.

여러 채팅을 탭으로 활용하세요

Genie Code 창에서는 열린 채팅 내용을 창 상단에 탭으로 표시합니다. 한 번에 여러 작업을 실행할 수 있으며, 하던 위치를 잃지 않고 채팅 간에 이동할 수 있습니다.

  • 채팅 전환: 채팅을 활성화하려면 탭을 클릭하세요. 탭을 전환해도 백그라운드에서 채팅이 계속 실행되어, 한 채팅에서 긴 작업을 시작하고 다른 채팅에서 계속 작업할 수 있습니다.
  • 새 채팅 열기: 새 채팅 아이콘을 클릭하세요.새 탭에서 채팅을 시작하려면 새 채팅을 시작하세요.
  • 과거 채팅을 다시 열어보세요: 기록 아이콘을 클릭하세요.채팅 기록 을 보고 탭에서 채팅을 선택해 열어보세요.
  • 채팅 관리: 케밥 메뉴 아이콘을 사용하세요. 활성 탭의 케밥 메뉴를 사용해 채팅을 관리하거나, 닫기 아이콘을 클릭해 탭을 닫으세요.

지니 코드 창 컨트롤

Genie 코드 창 헤더에는 다음과 같은 컨트롤이 있습니다.

Control Description
새 채팅 아이콘. 새 채팅 새 탭에서 새 채팅을 시작하세요.
역사의 아이콘. 채팅 기록 과거 채팅을 보고 탭에서 다시 열어보세요.
Kebab 메뉴 아이콘입니다. 더 보기 기어 아이콘 을 통해 설정 및 기타 옵션에 액세스합니다. 지니 코드 설정을 참조하세요.
닫기 아이콘. 닫기 지니 코드 창을 축소합니다.

지니 코드 설정

지니 코드 설정을 열려면 Kebab 메뉴 아이콘을 클릭합니다.창 머리글의 추가 메뉴를 클릭한 다음 기어 아이콘을 클릭합니다.설정. 설정 창에는 다음이 포함됩니다.

설정 Description
Actions Genie Code가 도구를 사용하기 전에 승인을 요청하는 방법을 설정합니다. 도구 작업 승인을 참조하세요.
MCP 서버 MCP 서버 및 기본 제공 커넥터를 사용하여 외부 도구 및 데이터 원본에 연결합니다.
패널 보기 설정/해제 도킹된 창 보기 또는 측면 창 보기에서 지니 코드를 사용할지 여부를 선택합니다.
사용자 지침 Genie Code가 사용자에게 응답하는 방법을 안내하는 사용자 지침을 추가합니다.
작업 영역 지침 작업 영역의 모든 사용자에게 적용되는 작업 영역 지침을 추가합니다.
기술 Genie Code가 작업에 적용할 수 있는 재사용 가능한 에이전트 기술을 추가합니다.
작업 영역 기술 작업 영역의 모든 사용자가 사용할 수 있는 기술을 추가합니다.
서버리스 사용 정책 Genie Code가 채팅 출력에서 생성하는 코드를 실행하기 위한 서버리스 사용 정책을 설정합니다.

지니 온톨로지

Important

이 기능은 공개 미리보기 단계에 있습니다. 이 미리 보기에 참가하려면 Azure Databricks 계정 팀에 문의하세요.

메모

현재 고객은 온톨로지 스니펫을 큐레이션하는 데 비용을 부담하지 않습니다. 하지만 Azure Databricks 언제든지 해당 기능에 대한 가격을 업데이트하거나 databricks.com 요금 페이지를 업데이트하여 변경할 수 있습니다.

Genie Ontology는 Genie Code에 조직의 비즈니스 인식 지도를 제공하는 통합 컨텍스트 레이어입니다. 이 문서는 두 가지 맥락 범주를 결합합니다:

  • Unity 카탈로그 의미론: 메트릭 뷰와 도메인 같은 기능을 통해 관리하고 인증하는 모델링 컨텍스트입니다.
  • 추론된 맥락: Genie가 기존 자산과 사용량에서 자동으로 추출하고 유지하는 스니펫 맵으로, 메트릭 뷰, 대시보드, SQL 쿼리, Genie 에이전트 등이 포함됩니다.

예를 들어, 추론된 스니펫은 다음과 같을 수 있습니다:

  • 미터법 정의: 예를 들어, "'활성 사용자'는 모든 플랫폼에서 중복 제거된 구별되는 사용자입니다."
  • 권위 있는 출처: 예를 들어, "수익 관련 질문은 큐레이션된 Finance Genie Agent를 통해 답변해야 합니다."
  • 비즈니스 규칙: 예를 들어, "'적격 리드'는 데모가 예약된 후에만 인정된다."

Unity Catalog는 권한에 따라 스니펫에 대한 접근을 제어하므로, Genie Code는 사용자가 볼 권한이 있는 자산에서 추출된 스니펫만 사용합니다.

에이전트 모드

Genie Code는 에이전트 모드에서 실행되며, 다단계 워크플로를 자동화하고, 솔루션을 계획하고, 관련 자산을 검색하고, 코드를 실행하고, 셀 출력을 사용하여 결과를 개선하고, 오류를 자동으로 수정합니다. 자율적인 작업 실행 없이 직접 대화형 응답을 원하는 경우 프롬프트에서 예를 들어 "나에게 설명하기만 하면 코드를 실행하지 마십시오"라고 말합니다.

작업을 완료하기 위해 Genie Code는 테이블 및 열 이름, 설명, 작업 중인 코드, 테이블의 데이터 샘플 및 셀 출력을 포함하여 프롬프트 및 관련 컨텍스트를 모델에 보냅니다. 모델로 전송된 모든 데이터는 Unity 카탈로그 권한을 준수합니다. 자세한 내용은 모델로 전송된 데이터를 참조하세요.

Requirements

Genie Code의 에이전트 기능을 사용하려면 작업 영역에 다음이 필요합니다.

파트너 기반 AI 기능을 사용하지 않도록 설정하면 Databricks 호스팅 모델을 사용하여 에이전트 기능이 없는 Genie Code는 여전히 사용할 수 있습니다.

전체 페이지 지니 코드

Genie Code는 전체 페이지 커맨드 센터 경험을 제공하며, 활성 채팅이 눈에 띄게 표시되고, 필요할 때 노트북이나 파일 같은 자산이 탭으로 표시됩니다. 전체 페이지 지니 코드를 참조하세요.

도구 작업 승인

Genie Code에서 코드 실행, 전자 필기장 편집 또는 테이블 쿼리와 같은 도구를 사용해야 하는 경우 계속하기 전에 승인을 요청합니다. 각 요청을 개별적으로 승인하거나, 현재 채팅의 나머지 부분이나 앞으로 진행될 모든 채팅에 적용되는 승인 모드를 설정할 수 있습니다.

단일 요청 승인

Genie Code가 도구 사용 권한을 요청하면 작업 승인 허용 또는 건너뛰 기를 클릭하여 거부합니다.

현재 채팅에서 Genie Code가 향후 승인 요청을 처리하는 방식을 변경하려면 같은 프롬프트에서 다음 중 하나를 선택하세요:

Option 작동 방식
매번 질문하기 Genie Code는 도구를 사용할 때마다 승인을 요청합니다.
현재 채팅 허용 Genie Code는 요청한 도구를 요청 없이 현재 채팅 내내 사용할 수 있습니다.
항상 허용 Genie Code는 요청받은 도구를 요청 없이 모든 채팅에서 사용할 수 있습니다.
자동 승인 (권장) Genie Code는 현재 채팅의 나머지 부분에 대한 도구 동작을 자동으로 승인합니다. AI 분류기는 각 행동을 요청과 비교해 확인하고, 범위를 벗어난 행동은 차단합니다.

기본 승인 모드 설정

Genie Code를 처음 사용할 때, 모든 채팅의 기본 모드는 자동 승인입니다. 승인 모드를 변경하려면 Genie Code 설정에서 새로운 기본값을 설정하세요. 기어 아이콘 을 클릭합니다. 지니 코드 창 머리글에서 설정을 엽니다.

다음 중 하나를 선택합니다.

  • 먼저 질문: 실행 시 각 도구를 승인합니다. 도구별 재정의는 여전히 적용됩니다.

  • 자동 승인: AI 분류기는 의도에 반하는 각 제안된 행동을 검토하고 승인하거나 차단하여 수동 승인을 최소화하고 의도를 넘어서는 행동은 차단합니다.

    Important

    자동 승인은 보안 경계가 아닌 생산성 기능입니다. 분류자는 잘못될 수 있는 최선의 추론입니다. 안전하지 않은 작업을 승인하거나 안전한 작업을 차단할 수 있습니다. 보안, 규정 준수 또는 액세스 제어 요구 사항을 적용하는 데 의존하지 마세요. 잘못된 승인의 결과가 발생하는 프로덕션 데이터, 중요한 작업 영역 또는 공유 리소스로 작업할 때 자동 승인을 해제합니다. Genie Code의 결과를 검토할 책임이 있습니다.

자동 승인이 켜져 있으면, Genie Code는 귀하가 소유하거나 참조한 자원에 대한 요청을 수행하는 데 필요한 조치를 승인합니다. 예를 들어, 읽기 전용 쿼리를 실행하고, 자신의 파일과 노트북을 편집하며, 소유한 테이블에 쓰고, 이미 참조한 작업이나 파이프라인을 실행합니다. 또한, 사용자가 명시적으로 요청한 행동이 변경되거나 데이터를 삭제해도 완료합니다. 예를 들어, 이름 붙인 테이블을 삭제하거나 작업 중인 테이블에서 행을 삭제하는 식입니다. 자동 승인은 의도를 따르기 때문에, 단지 파괴적인 행동이라고 해서 행동을 보류하지 않습니다.

Genie Code는 요청을 넘어서는 행동을 차단합니다: 식별하지 않은 데이터에 대한 파괴적인 변경(예: 언급하지 않은 테이블 삭제), 요청보다 더 파괴적인 작업(예: 에 DROP추가CASCADE), 또는 범위를 확대하거나 공유 자원에 영향을 미치는 행동(예: 운영 배치, 권한 및 비밀 변경 등) 데이터를 제3자에게 전송하는 호출, 그리고 강제 푸시와 같은 위험한 소스 관리 작업).

작업이 차단되면 Genie Code는 이유를 수신하고 더 좁은 범위로 다시 시도하여 조정합니다.

채팅 공유

Genie Code 채팅은 다른 사용자, 그룹, 서비스 책임자와 공유할 수 있습니다.

대화를 나누고 싶습니다:

  1. 지니 코드 창에서 히스토리 아이콘을 클릭하세요.채팅 기록 을 열려면 채팅 기록을 열어보세요.

  2. 공유하고 싶은 채팅 위에 마우스를 올리고 케밥 메뉴 아이콘을 클릭하세요. 케밥 메뉴.

  3. 공유 아이콘 을 클릭합니다.공유합니다.

  4. 공유 대화 상자에서 공유할 사용자, 그룹 또는 서비스 주체를 추가합니다. 수신자는 채팅에서 '볼 수 있다' 권한을 받습니다. Genie Code 채팅 ACL을 참조하세요.

  5. (선택 사항) 새로 추가된 사용자에게 이메일 알림을 보내려면 새 사용자에게 이메일 보내기를 선택합니다.

  6. (선택 사항) 채팅 링크를 직접 공유하려면 링크 아이콘을 클릭하세요.공유 대화 하단의 링크를 복사하세요.

  7. 추가를 클릭하여 대화를 공유합니다.

코드 도움말 보기

노트북에서 직접 Genie Code로부터 코드에 대한 도움을 받으세요. Genie Code는 다음을 제공합니다.

Databricks는 때때로 실수를 할 수 있으므로 실행하기 전에 항상 Genie Code에서 생성된 코드를 검토하는 것이 좋습니다.

Genie Code가 코드에 도움이 되는 방법에 대한 자세한 내용은 Genie Code에서 코딩 도움말 가져오기를 참조하세요.

Azure Databricks 환경에 최적화된 코드

Genie Code에서 생성된 코드는 Databricks 컴퓨팅 환경에서 실행하기 위한 것입니다. Databricks에서 지원하는 프로그래밍 언어, 프레임워크 및 방언으로 코드를 만들도록 최적화되어 있습니다. 범용 프로그래밍 도우미가 될 수 없습니다.

Genie Code는 Databricks 설명서 웹 사이트 또는 기술 자료와 같은 Databricks 리소스의 정보를 사용하여 사용자 쿼리에 더 잘 응답하는 경우가 많습니다. 사용자 질문이 Databricks 설명서, Unity 카탈로그 및 작업 영역의 사용자 코드에 대한 지식으로 답변할 수 있는 질문과 관련된 경우 가장 잘 수행됩니다.

설명서에서 제공된 답변 가져오기

Genie Code는 Databricks 설명서를 검색하여 질문에 답변합니다. 설명서를 참조하면 응답에 검색된 설명서 단계가 표시됩니다. Genie Code에 원본을 인용하도록 요청할 수 있으며 관련 설명서 페이지에 대한 링크를 제공합니다.

설명서에서 제공한 대답을 보여 주는 Genie Code 응답입니다.

Genie Code 답변에 대한 피드백 제공

Genie Code 답변이 유용한지 Databricks에 알려주세요.

  1. 지니 코드 답변 바로 아래에 마우스를 가져다 주세요.
  2. 유용한 좋아요 아이콘을 클릭하거나, 유용하지 않은 싫어요 아이콘을 클릭합니다.

추가 리소스