Databricks 도우미 사용

Databricks Assistant는 Databricks Notebook, SQL 편집기, 작업, AI/BI 대시보드 및 파일 편집기를 사용할 수 있는 컨텍스트 인식 AI 도우미입니다. Databricks Assistant는 대화형 인터페이스를 사용하는 데 도움을 요청할 때 데이터 및 코드를 지원합니다.

계정의 경우: Databricks Assistant 기능 사용 안 함 또는 사용

Azure AI Services Databricks Assistant 기능은 기본적으로 사용하도록 설정됩니다. 그러나 계정 관리자는 계정 내의 모든 작업 영역에 대해 Azure AI Services Assistant 기능을 사용하지 않도록 설정할 수 있습니다. 계정 관리자는 전체 계정에 대해 Databricks Assistant를 사용하도록 적용할 수도 있습니다.

팁

계정에 대한 Azure AI Services Databricks Assistant 기능을 사용하거나 사용하지 않도록 설정하는 행위는 감사 로그에서 계정 이벤트로 캡처됩니다. 계정 이벤트를 참조하세요.

1. 계정 관리자 권한으로 계정 콘솔에 로그인합니다.

   Important

   Microsoft Entra ID 테넌트에 아직 계정 콘솔에 로그인한 사용자가 없는 경우 사용자 또는 테넌트에 있는 다른 사용자가 첫 번째 계정 관리자로 로그인해야 합니다. 이렇게 하려면 먼저 Azure Databricks 계정 콘솔에 로그인하는 경우에만 Microsoft Entra ID 전역 관리자여야 합니다. 처음 로그인하면 Azure Databricks 계정 관리자가 되며 더 이상 Azure Databricks 계정에 액세스하기 위해 Microsoft Entra ID 전역 관리자 역할이 필요하지 않습니다. 첫 번째 계정 관리자는 Microsoft Entra ID 테넌트에 있는 사용자를 추가 계정 관리자(더 많은 계정 관리자를 할당할 수 있는 사용자)로 할당할 수 있습니다. 추가 계정 관리자는 Microsoft Entra ID에서 특정 역할이 필요하지 않습니다. 사용자, 서비스 주체 및 그룹 관리를 참조하세요.

2. 설정을 클릭합니다.

3. 기능 사용 탭을 클릭합니다.

4. 파트너 기반 AI 기능 사용 옵션의 경우 끄기 또는 켜기를 선택합니다.

5. 적용 설정을 사용하여 작업 영역 재정의를 방지합니다.

작업 영역의 경우: Assistant 기능 사용 안 함 또는 사용

계정 관리자가 Assistant를 사용하도록 설정하는 경우 기본적으로 작업 영역에서 사용하도록 설정됩니다. 계정 관리자가 설정을 적용하도록 선택하지 않는 한 작업 영역 관리자는 해당 작업 영역에 대해 설정을 사용하지 않도록 설정할 수 있습니다.

작업 영역에서 Databricks Assistant를 사용하지 않도록 설정하려면 다음을 수행합니다.

1. Databricks 작업 영역 >설정의 위쪽 표시줄에서 사용자 이름을 클릭합니다.
2. 작업 영역 관리자의 왼쪽 창에서 고급 탭을 클릭합니다.
3. Assistant를 사용하지 않도록 설정하려면 파트너 기반 AI 보조 기능에 대한 토글 끄기를 클릭합니다. #

길잡이 창 둘러보기

이 섹션에서는 길잡이 창의 기본 환경에 대해 설명합니다.

길잡이 창을 열려면 왼쪽 사이드바를 클릭합니다 .

길잡이 창 아래쪽의 텍스트 상자에 질문을 입력하고 Enter 키를 누르거나 텍스트 상자 오른쪽을 클릭합니다. 도우미가 대답을 표시합니다. 다음 스크린샷은 길잡이 창에서 도우미가 코드를 생성한 후 수행할 수 있는 작업을 보여 줍니다.

동일한 쿼리를 다시 실행하여 다른 답변을 생성할 수 있습니다. 이렇게 하려면 커서를 답변 위로 마우스로 가리킨 다음 클릭합니다 .

창을 닫려면 아이콘을 다시 클릭하거나 셀의 오른쪽 위 모서리를 클릭합니다 . 클릭하여 창을 전체 너비로 확장할 수 있습니다. 클릭하여 창을 기본 너비로 반환합니다.

도우미 창은 창이나 전자 필기장을 닫아도 대화를 추적합니다. 이전 대화를 지우려면 길잡이 창의 오른쪽 상단을 클릭합니다 .

Notebook 셀에서 Databricks Assistant 사용

Notebook에서 Databricks Assistant는 길잡이 창 또는 코드 셀의 인라인에서 사용할 수 있습니다.

코드 셀에서 직접 Databricks Assistant를 사용하려면 MacOS에서 Cmd + i를 누르거나 Windows에서 Ctrl + i를 누릅니다. 셀에 텍스트 상자가 나타납니다. 영어로 질문이나 메모를 입력한 다음 Enter 키를 눌러(셀을 실행하는 것처럼 Shift+Enter가 아님) Assistant가 응답을 생성하도록 할 수 있습니다.

프롬프트에 슬래시 명령 사용

슬래시 명령은 일반적인 프롬프트를 만들기 위한 바로 가기입니다.

메시지 텍스트	길잡이가 하는 일
/	일반적인 명령을 표시합니다.
/doc	diff 보기에서 코드 주석 달기
/explain	셀의 코드에 대한 설명을 제공합니다.
/fix	diff 보기의 코드 오류에 대한 수정 제안

사용 /fix 하거나 /docdiff 창에서 제안된 변경 내용을 수락하려면 수락을 선택하거나 원래 코드를 유지하려면 거부를 선택합니다. 제안된 코드를 수락하면 코드가 자동으로 실행되지 않습니다. 코드를 실행하기 전에 검토할 수 있습니다. 생성된 코드가 원하는 코드가 아닌 경우 메모에 더 많은 세부 정보 또는 정보를 추가하여 다시 시도합니다. Databricks 도우미 사용에 대한 팁을 참조하세요.

코드 조각에 대한 자세한 설명을 가져옵니다. 프롬프트를 /explain 사용하고 "간결하게" 또는 "줄 단위로 코드 설명"과 같은 용어를 포함시켜 원하는 세부 수준을 요청합니다. Databricks Assistant에 코드에 주석을 추가하도록 요청할 수도 있습니다.

코드 자동 완성의 경우 Notebook 셀보다 길잡이 창을 사용하는 것이 성능이 더 좋을 수 있습니다.

생성된 코드를 수락하거나 거부하면 도우미가 자동으로 닫힙니다.

오류 자동 진단 및 수정

도우미는 Notebook에서 오류 메시지를 감지할 때마다 자동으로 실행할 /fix 수 있습니다.

전자 필기장 오류 창에서 자동 수정 오류 선택기를 전환하여 자동 /fix 수정을 사용하거나 사용하지 않도록 설정합니다.

스레드 및 프롬프트 기록

대화 스레드는 Databricks Assistant를 사용할 수 있는 다양한 컨텍스트에서 유지됩니다. 길잡이 창에서 새 대화 스레드를 만들고, 질문 및 프롬프트 기록을 보고, Databricks Assistant 환경을 관리할 수 있습니다.

Databricks Assistant는 프롬프트의 컨텍스트에 따라 스레드의 제목을 지정하므로 길잡이 대화의 기록을 탐색할 수 있습니다. 다음 예제는 Notebook에 대한 질문에서 가져옵니다.

코드에 대한 도움말 보기

Important

이 기능은 공개 미리 보기 상태입니다.

Databricks Assistant는 SQL 및 Python의 코드에 도움이 됩니다.

• Databricks Notebook, SQL 편집기 및 파일 편집기에서 AI 기반 자동 완성
• 자연어 프롬프트를 사용하여 데이터 필터링
• 진단 오류가 있는 코드 디버깅

참고 항목

인라인 코드 제안은 FedRAMP 규정 준수를 사용하는 Azure Government 지역 또는 작업 영역에서 사용할 수 없습니다.

자연어 프롬프트를 사용하여 데이터 필터링

Databricks Assistant를 사용하여 자연어 프롬프트를 사용하여 데이터 출력을 필터링합니다.

자연어를 사용하여 출력을 필터링하려면 출력 테이블에서 필터 아이콘을 클릭하고 프롬프트를 입력합니다. 예를 들어 다음 애니메이션 예제와 같이 "70세 이상의 남성만 표시하라"는 메시지를 표시할 수 있습니다.

인라인 코드 제안 가져오기: Python 및 SQL 예제

입력하면 제안이 자동으로 표시됩니다. Tab 키를 눌러 제안을 수락합니다. 제안을 수동으로 트리거하려면 Option + Shift + Space(macOS) 또는 Control + Shift + Space(Windows)를 누릅니다.

AI 기반 자동 완성은 주석에서 코드를 생성할 수도 있습니다.

디버그 코드: Python 및 SQL 예제

Databricks Assistant를 사용하여 코드를 수정하려면 다음 중 하나라도 수행합니다.

• 길잡이 창에서 질문을 합니다.
• 오류가 발생할 때 셀 결과에 나타나는 오류 진단 단추를 클릭합니다.
• 디버그를 클릭하여 코드를 한 줄씩 대화형으로 단계별로 실행하고, 중단점을 설정하고, 변수를 검사하고, 프로그램의 실행을 분석합니다.

아래 탭은 Python 및 SQL 코드의 예를 보여 줍니다.

Python

SQL

작업 오류 진단(공개 미리 보기)

Important

이 기능은 공개 미리 보기 상태입니다.

Databricks Assistant는 작업의 오류를 진단하는 데 도움이 됩니다.

Assistant를 사용하여 작업을 진단하려면 다음을 수행합니다.

1. 작업 UI에서 실패한 작업을 엽니다.
2. 오류 진단을 선택합니다.

Azure Databricks 설명서에서 답변 가져오기

Notebook 편집기에서 Databricks Assistant는 Databricks 설명서를 기반으로 질문에 대답할 수 있습니다. 프롬프트 상자에 질문이나 프롬프트를 입력합니다.

Databricks 도우미를 사용하기 위한 팁

이 섹션에는 Databricks Assistant를 사용할 때의 몇 가지 일반적인 팁과 모범 사례가 포함되어 있습니다.

Databricks Assistant는 컨텍스트를 사용하여 더 나은 답변을 제공합니다.

Databricks Assistant는 테이블 및 열 스키마 및 메타데이터에 액세스할 수 있습니다. 이렇게 하면 자연어를 사용하고 보다 정확한 쿼리를 생성할 수 있습니다. 예를 들어 테이블에 State라는 열이 있는 경우 Databricks Assistant에 미시간주에 거주하는 사용자 목록을 생성하도록 요청할 수 있습니다.

Databricks Assistant는 다음 컨텍스트를 사용합니다.

• 현재 Notebook 셀 또는 Databricks SQL 편집기 탭의 코드 또는 쿼리입니다.
• 테이블 및 열 이름 및 설명입니다.
• 이전 프롬프트 질문
• 즐겨찾기 및 활성 테이블
• 진단 오류 기능의 경우 오류 출력의 스택 추적입니다.

DataFrame에서 열을 선택할 때 시작 쿼리를 제공하여 보다 정확한 결과를 얻을 수 있습니다. 예를 들어 다음과 같은 SELECT * FROM <table_name>문을 제공합니다. 이렇게 하면 Databricks Assistant가 열 이름을 가져올 수 있으며 추측할 필요가 없습니다.

Databricks Assistant는 대화 기록을 사용하여 더 정확하고 정확한 답변을 제공하기 때문에 전체 프롬프트를 다시 작성하지 않고도 Databricks Assistant에 이전 응답의 출력을 변경하도록 요청할 수 있습니다. 길잡이의 채팅 기록을 사용하여 길잡이 창에서 데이터 프레임을 반복적으로 정리, 탐색, 필터링 및 조각화할 수 있습니다.

구체적으로 설명

Databricks Assistant에서 제공하는 구조와 세부 정보는 동일한 프롬프트에 대해서도 때때로 다릅니다. 원하는 형식, 세부 수준 등으로 원하는 정보를 반환하는 데 도움이 되도록 최대한 많은 지침을 Assistant에 제공해 보세요. 예시:

• "이 코드를 몇 문장으로 설명" 또는 "이 코드를 줄별로 설명"합니다.
• "MatPlotLib을 사용하여 시각화 만들기" 또는 "Seaborn을 사용하여 시각화 만들기"

행 수준 데이터 값의 예제 제공

Databricks Assistant는 행 수준 데이터를 사용하지 않으므로 가장 정확한 답변을 얻으려면 프롬프트에 더 자세한 정보를 제공해야 할 수 있습니다. 카탈로그 탐색기에서 테이블 또는 열 주석을 사용하여 샘플 데이터 줄을 추가합니다. 예를 들어 높이 열이 형식 feet-inches이라고 가정합니다. Assistant가 데이터를 해석하는 데 도움이 되도록 "높이 열은 문자열 형식이며 하이픈으로 구분됩니다. 예: '6-2'." 테이블 및 열 주석에 대한 자세한 내용은 데이터 및 AI 자산에 주석 추가를 참조 하세요.

열 데이터 형식 변환을 사용하여 작업을 실행해야 하는 경우 세부 정보를 제공해야 할 수 있습니다. 예를 들어 "pandas DataFrame을 PySpark DataFrame으로 변환하고 열 변동의 데이터 형식을 부울에서 정수로 변경하는 데 필요한 코드를 포함하여 이 코드를 pandas에서 PySpark로 변환합니다."

Shift+Enter를 사용하여 채팅 텍스트 상자에 새 줄 추가

Shift+Enter를 사용하여 길잡이 채팅 텍스트 상자에 새 줄을 추가합니다. 이렇게 하면 Databricks Assistant로 메시지의 서식을 쉽게 지정하고 구성할 수 있습니다.

Databricks 길잡이 채팅 창에서 코드 편집 및 실행

도우미 창에서 코드를 실행하여 유효성을 검사하거나 스크래치 패드로 사용합니다. 코드를 실행하려면 길잡이 창에서 코드 상자의 왼쪽 위 모서리를 클릭합니다 .

아래 탭에서는 Python 및 SQL 코드에 대한 예제를 보여 줍니다.

Python

SQL

도우미 창에서 코드를 실행하면 출력이 표시되고 Notebook에서 변수를 사용할 수 있게 됩니다.

코드를 Notebook으로 이동하기 전에 Databricks Assistant가 도우미 채팅 상자에서 직접 생성하는 코드를 편집할 수도 있습니다.

추가 정보

다음 문서에는 Databricks Assistant 사용에 대한 추가 정보가 포함되어 있습니다.

• Databricks Assistant란?
• DatabricksIQ 신뢰 및 안전