AI/BI Genie 공간 설정 및 관리

이 문서에서는 비즈니스 사용자가 데이터에 대한 자연어 질문을 할 수 있는 채팅 인터페이스인 Genie 공간을 설정하고 관리하는 방법을 설명합니다.

기술 요구 사항 및 제한

지니 공간을 사용할 때 적용되는 요구 사항 및 제한 사항은 다음과 같습니다.

• Unity 카탈로그: 지니 공간의 데이터를 Unity 카탈로그에 등록해야 합니다.
• 컴퓨팅: pro 또는 서버리스 SQL 웨어하우스를 사용해야 합니다.
• 처리량: 각 작업 영역은 모든 Genie 공간에서 분당 최대 20개의 질문을 처리할 수 있습니다.
• 용량: 각 지니 공간은 최대 10,000개의 대화를 지원할 수 있으며 각 대화에는 최대 10,000개의 메시지가 포함될 수 있습니다.

필요한 권한

지니 공간을 만들고, 편집하고, 사용하려면 다음 권한이 필요합니다.

• 컴퓨팅 권한: Genie 공간 작성자, 편집기 및 사용자는 공간에 지정된 기본 SQL 웨어하우스에 대한 CAN USE 액세스 권한이 필요합니다. 작성자는 공간을 만들 때 기본 SQL 웨어하우스를 선택합니다. CAN RUN 권한이 있는 모든 SQL 웨어하우스를 선택할 수 있습니다.
• 데이터 액세스 권한: 공간과 상호 작용하는 모든 사용자는 공간에서 사용되는 데이터에 대해 최소 SELECT 권한이 필요합니다.
• Genie 공간 권한: 사용자는 Genie 공간과 그 안에 사용되는 데이터와 상호 작용하기 위해 Genie 공간에 대한 CAN RUN 권한이 필요합니다. 지니 공간에 대한 권한 및 기능의 완전한 매핑은 Genie 공간 ACL 참조하세요.

Genie의 액세스를 관리하세요

Genie는 계정 수준에서 사용하도록 설정해야 하는 Azure AI 서비스 기반 AI 보조 기능을 사용합니다. 계정에 대한 이러한 기능을 관리하는 방법을 알아보려면 을(를) 활성화하고 Databricks Assistant을(를) 시도해 보세요.

새 지니 공간 만들기

지니 공간을 사용하면 데이터 분석가가 다음 단계를 수행하여 비즈니스 사용자를 위한 도메인별 Genie 공간 환경을 만들 수 있습니다.

1. 사이드바에서 지니을 클릭합니다.

2. 화면 오른쪽 상단에서 새로 만들기을 클릭합니다.

   다음 목록에 설명된 대로

3. 새 대화 상자에서 초기 설정을 선택합니다. 옵션은 다음과 같이 설명됩니다.

• 제목: 제목이 다른 작업 영역 개체와 함께 작업 영역 브라우저에 나타납니다. 최종 사용자가 Genie 공간을 검색하는 데 도움이 되는 제목을 선택합니다.
• 설명: 사용자가 지니 공간을 열면 설명이 표시됩니다. 이 텍스트 영역을 사용하여 공백의 용도를 설명합니다. 설명 필드는 텍스트의 스타일을 지정하고 유용한 컨텍스트 및 참조에 대한 링크를 제공할 수 있도록 Markdown 서식 지정을 지원합니다. markdown 구문에 대한 자세한 내용은 이 가이드참조하세요.
• 기본 웨어하우스: 이 컴퓨팅 리소스는 지니 공간에서 생성된 SQL 문을 구동합니다. 최종 사용자는 공간과 상호 작용하기 위해 이 웨어하우스에 액세스해야 합니다. 지니 공간은 pro 또는 서버리스 SQL 웨어하우스를 사용할 수 있습니다. 최적의 성능을 위해 Databricks는 서버리스 SQL 웨어하우스를 사용하는 것이 좋습니다.
• 테이블: 지니 공간은 하나 이상의 테이블을 기반으로 할 수 있습니다. 최대 25개의 테이블을 포함할 수 있습니다. 테이블 추가 단추는 포함하려는 Unity 카탈로그 테이블을 선택할 수 있는 새 대화 상자를 엽니다.
• 샘플 질문: 샘플 질문은 선택 사항입니다. 채팅에 표시되어 사용자가 질문할 수 있는 질문 유형에 대한 예를 제공합니다. 생성 중이거나 나중에 공간의 설정에서 추가할 수 있습니다.

지침 제공

지침은 지정된 도메인에서 고유한 전문 용어, 논리 및 개념을 처리할 수 있도록 Genie의 응답을 안내하는 데 도움이 됩니다. 포괄적인 지침은 원활하고 직관적인 지니 공간 환경에 매우 중요합니다. 지침을 입력하려면 지니 스페이스 사이드바에서 지침 클릭하여 지침 창을 엽니다. 이 창을 사용하여 일반 지침, 예제 SQL 쿼리및 SQL 함수추가할 수 있습니다.

지니 공간에 대해 총 100개의 지침을 추가할 수 있습니다. 다음 항목들은 개수에 포함됩니다.

• 일반 명령의 전체 텍스트 블록은 하나로 계산됩니다.
• 각 예제 SQL 쿼리는 하나로 계산됩니다.
• 각 SQL 함수는 하나로 계산됩니다.

일반 지침

Genie가 따라야 할 비즈니스 또는 응답 기본 설정을 전달하는 일반 텍스트 지침을 제공합니다. 지침의 서식을 단일 포괄적인 메모로 지정하거나 더 나은 조직을 위해 항목별로 분류할 수 있습니다.

다음은 일반적인 지침에 포함할 수 있는 정보의 예를 보여 줍니다.

• 회사별 비즈니스 정보:
  • "2월에 회계 연도 시작"
• 값, 별칭 또는 일반적인 필터는 다음과 같이 나열됩니다.
  • "필터를 적용할 때 항상 소문자로 변환하고 like 연산자를 사용합니다."
  • "필터 값의 상태에 약어를 사용합니다."
• 질문에 답변하고반환 값에 대한 지침을 제공하는 함수를 지정합니다.
  • "분기의 경우 adventureworks.oneb.get_quarter(date) UDF를 사용합니다." get_quarter() 출력은 분기이며 1, 2, 3 또는 4입니다. 필요에 따라 데이터를 필터링하는 데 사용합니다.

예제 SQL 쿼리

예제 SQL 쿼리는 Genie 학습을 돕기 위해 준비하는 SQL 쿼리입니다. Genie는 질문에 응답할 때 응답을 생성하는 데 도움이 되도록 관련 쿼리를 지능적으로 선택합니다. 예제 쿼리를 추가하면 Genie에서 데이터를 사용하여 질문에 대답하는 방법을 보여 줍니다. 예제 질문을 추가하여 예제 쿼리가 대답할 것으로 예상되는 질문의 종류에 대해 Genie에게 가르칠 수도 있습니다. Genie가 일치하는 질문을 받으면 예제 쿼리를 직접 사용하여 답변을 제공할 수 있습니다. 비슷한 질문을 받는 경우 예제 쿼리의 단서를 사용하여 응답에 제공된 SQL을 구조화할 수 있습니다. 다음 예제와 같이 조직 및 데이터에 고유한 논리를 강조 표시하는 샘플을 제공하는 데 집중합니다.

  -- Return our current total open pipeline by region.
  -- Opportunities are only considered pipelines if they are tagged as such.
  SELECT
    a.region__c AS `Region`,
    sum(o.amount) AS `Open Pipeline`
  FROM
    sales.crm.opportunity o
    JOIN sales.crm.accounts a ON o.accountid = a.id
  WHERE
    o.forecastcategory = 'Pipeline' AND
    o.stagename NOT ILIKE '%closed%'
  GROUP BY ALL;

SQL 쿼리에 매개 변수 추가

매개 변수를 사용하면 런타임에 대체될 특정 값에 대한 자리 표시자를 사용하여 예제 쿼리를 작성할 수 있습니다. 매개 변수를 사용하면 Genie는 사용자 질문의 특정 입력을 받아 예제 쿼리의 구조를 다시 사용하여 확인된 답변을 신뢰할 수 있는 자산으로 제공할 수 있습니다. 예를 들어 o.forecastcategory 값으로 필터링하는 매개 변수를 포함하도록 이전 SQL 쿼리를 조정하여 쿼리가 다른 예측 범주에 태그가 지정된 기회에 대한 질문을 처리할 수 있도록 할 수 있습니다. 매개 변수가 있는 쿼리를 사용하여 신뢰할 수 있는 자산으로 레이블이 지정된 응답을 생성하는 방법에 대한 자세한 내용은 AI/BI Genie 공간신뢰할 수 있는 자산 사용을 참조하세요.

다음 코드 조각은 o.forecastcategory 값에 대한 매개 변수를 추가하여 수정된 이전 예제를 보여줍니다. 매개 변수는 명명된 매개 변수 표식과 동일한 구문을 사용합니다. 명명된 매개 변수 표식참조하세요.

-- Return our current pipeline at a stage by region.
-- Opportunities are only considered pipelines if they are tagged as such.
  SELECT
    a.region__c AS `Region`,
    sum(o.amount) AS `Open Pipeline`
  FROM
    sales.crm.opportunity o
    JOIN sales.crm.accounts a ON o.accountid = a.id
  WHERE
    o.forecastcategory = :forecast_category AND
    o.stagename NOT ILIKE '%closed%'
  GROUP BY ALL;

쿼리에 매개 변수를 추가하려면 다음을 수행합니다.

1. 쿼리에 매개 변수를 배치할 위치에 커서를 놓습니다.

2. "매개 변수 추가를 클릭하여 새 매개 변수를 삽입합니다."

   그러면 기본 이름이 parameter새 매개 변수가 만들어집니다. 기본 이름을 변경하려면 쿼리 편집기에서 바꿉다. 콜론과 매개 변수 이름(:parameter_name)을 편집기에 입력하여 매개 변수를 추가할 수도 있습니다.

쿼리 매개 변수 편집

매개 변수를 편집하려면 다음을 수행합니다.

1. 매개 변수 이름 옆에 있는 클릭합니다. 매개 변수 세부 정보 대화 상자가 나타나고 다음 구성 옵션이 포함됩니다.

   • 키워드: 쿼리의 매개 변수를 나타내는 키워드입니다. 키워드는 쿼리의 텍스트를 직접 업데이트해야만 변경할 수 있습니다.

   • 표시 이름: Genie가 채팅 환경에서 사용하는 사람이 읽을 수 있는 이름입니다. Genie가 매개 변수가 있는 쿼리를 사용하여 응답을 생성하는 경우 응답에 표시 이름 및 연결된 값이 포함됩니다.

   • 형식: 지원되는 형식에는 문자열, 날짜, 날짜 및 시간및 숫자포함됩니다.

     • 기본 형식은 String.
     • 숫자 데이터 형식을 사용하면 10진수정수지정할 수 있습니다. 기본 숫자 형식은 10진수.

     메모

     실제 입력 값이 선택한 매개 변수 형식과 일치하지 않으면 Genie는 입력 값을 잘못된 형식으로 처리하므로 결과가 정확하지 않을 수 있습니다.

2. UI의 다른 부분을 클릭하여 대화 상자를 닫습니다.

SQL 함수

SQL 함수는 Unity 카탈로그에 저장되고 Genie가 특정 질문에 대답하는 데 사용하는 사용자 지정 함수입니다. Genie는 이러한 함수를 호출하고 사용자 지정 매개 변수를 삽입할 수 있지만 기본 SQL 콘텐츠에 액세스할 수는 없습니다. 즉, SQL 함수는 Genie가 액세스하거나 편집할 수 없는 복잡한 인수 또는 계산을 포함하는 일반적인 특정 질문에 답변하는 데 적합합니다. Unity 카탈로그에서 함수를 등록하는 방법에 대한 지침은 Unity 카탈로그 SQL 테이블 함수 만들기 및 UDF(사용자 정의 함수) 참조하세요.

당신의 지니 공간을 테스트하세요

대부분의 사용자 상호 작용은 채팅 창에서 수행됩니다. 공간이 원하는 대로 작동하는지 알아보는 가장 좋은 방법은 비즈니스 사용자가 질문할 것으로 예상되는 현실적인 질문으로 테스트하는 것입니다.

설정에 입력한 샘플 질문은 채팅 창에 표시됩니다. 이러한 샘플 질문은 사용자가 Genie 공간에 질문할 수 있는 질문을 이해하는 데 도움이 될 수 있습니다. 사용자가 질문을 입력하는 텍스트 필드는 화면 아래쪽에 있습니다.

응답이 텍스트 필드 위에 나타납니다. 사용자가 질문을 입력하면 왼쪽 창의 채팅 기록 스레드에 저장됩니다.

새 채팅을 시작하려면 다음을 수행합니다.

1. 채팅 아이콘을 클릭하여 채팅 창을 엽니다.
2. 질문하기... 텍스트 입력 필드에 질문을 입력합니다. 새 대화 스레드를 시작하려면 + 새 채팅클릭합니다.

응답 검토

응답은 일반적으로 질문에 대한 자연어 답변 및 관련 결과 집합을 보여 주는 테이블로 전달됩니다. Genie는 시각화가 응답 명확성을 향상시킬 수 있음을 감지하면 시각화도 반환합니다. 정확한 응답 구조는 질문에 따라 달라집니다. 모든 응답에는 질문에 대답하기 위해 생성된 SQL 쿼리가 포함됩니다. 생성된 코드 표시를 클릭하여 생성된 쿼리를 확인하세요.

응답의 오른쪽 아래에는 선택적 작업이 포함됩니다. 사용자는 응답 CSV를 클립보드에 복사하고, CSV 파일로 다운로드하며, Genie 공간의 명령에 추가하고, 답변을 추천하거나 비추천할 수 있습니다. 시각화를 편집하려면 시각화의 오른쪽 위 모서리에 있는 편집 아이콘을 클릭합니다. 시각화를 편집하는 방법에 대한 추가 지침은 시각화생성을 참조하세요.

응답에는 테이블 형식 데이터를 포함하는 경우 빠른 작업 타일 집합이 따릅니다. 이를 사용하여 시각화를 생성할 수 있습니다.

쿼리 결과를 얻은 후 단어로 설명하여 시각화를 생성할 수도 있습니다. 시각화 생성을 참조하세요.

결과 서식 지정

응답 내에서 테이블의 열 서식을 지정하려면 열 머리글에서 케밥 메뉴를 클릭한 다음 서식을 클릭하여 사용 가능한 옵션을 확인합니다. 서식 옵션은 열의 데이터 형식에 따라 달라집니다.

결과 집합 다운로드

공간 사용자는 최대 약 1GB의 결과 데이터를 CSV로 다운로드할 수 있습니다. 최종 파일 다운로드 크기는 1GB 제한이 최종 파일 다운로드보다 이전 단계에 적용되므로 1GB보다 약간 많거나 작을 수 있습니다. 결과를 다운로드하려면 응답에서 다운로드 아이콘을 클릭합니다.

시각화 생성

사용자는 채팅 창을 사용하거나, 또는 응답 다음에 나오는 빠른 작업 섹션에 제공된 제안된 시각화 중 하나를 사용하여 명시적으로 시각화를 요청할 수 있습니다. 경우에 따라 Genie는 응답의 일부로 시각화를 제공합니다. 자동으로 생성된 시각화를 숨기려면 축소 아이콘을 클릭합니다. 다시 표시하려면 시각화 표시을 클릭합니다.

채팅 창에서 시각화를 편집할 수 있습니다.

지원되는 차트 유형은 다음과 같습니다.

• 지역
• 술집
• 줄
• 파이
• 뿌리다

시각화를 편집하려면 다음을 수행합니다.

• 시각화의 오른쪽 위 모서리에서 편집 아이콘을 클릭합니다. 편집 창이 페이지 오른쪽에 열립니다.
• 시각화 드롭다운 메뉴를 사용하여 다른 차트 종류를 선택합니다.
• 대부분의 차트 유형에서는 X축 및 Y축 드롭다운 메뉴를 사용하여 각 축에 표시되는 값을 선택합니다. 원형 차트의 경우 각도 드롭다운 메뉴를 사용하여 표시할 열을 선택합니다.
• (선택 사항) 색 구성표를 사용자 지정하려면 + 범주에서 클릭합니다.
• (선택 사항) 시각화를 마우스로 가리킬 때 도구 설명에 표시할 데이터를 선택하려면 + 섹션에서 클릭합니다.

응답 피드백 제공

각 AI/BI Genie 응답에는 엄지를 올리거나 내리는 피드백 버튼이 있습니다. Databricks는 사용자가 이 메커니즘을 사용하여 공간에 대한 피드백을 제공하도록 권장합니다.

쿼리 결과가 포함된 응답의 경우 사용자는 클릭하여 지니 공간 편집기에서 검토하도록 요청할 수 있습니다. 사용자가 생성된 응답의 품질 또는 정확도에 대한 질문이 있는 경우 검토를 위해 표시하고 필요에 따라 해당 의견 또는 질문을 추가할 수 있습니다.

비즈니스 사용자는 히스토리 페이지에서 검토를 위해 표시한 질문에 대한 업데이트를 볼 수 있습니다. 적어도 CAN MANAGE 권한이 있는 사용자는 Genie 공간에서 특정 교환을 검토하고 요청에 대해 의견을 남기며 응답을 확인하거나 수정할 수 있습니다. 모니터링 페이지에서 피드백에 액세스하고 요청을 검토할 수 있습니다. 그런 다음, 해당 피드백을 사용하여 응답을 조정하고 작업 영역을 점진적으로 개선할 수 있습니다. 검토 기록 및 피드백참조하십시오.

기록 및 피드백 검토

지니 공간은 데이터 팀과 비즈니스 사용자가 일회성 배포가 아니라 지식을 축적할 수 있는 지속적인 공동 작업 도구입니다. 비즈니스 사용자에게 답변이 필요한 새로운 질문을 이해하는 것은 지식 구축에 필수적입니다. 기록 페이지에서 개별 질문과 응답, 사용자가 제공한 좋아요 또는 싫어요 피드백, 그리고 검토를 위해 표시된 질문을 볼 수 있습니다. 기록 페이지를 열려면 지니 스페이스 사이드바에서 기록 클릭합니다.

기록 페이지에는 공간에서 질문된 모든 질문과 답변이 표시됩니다. 시간, 등급, 사용자 또는 상태를 따라 질문을 필터링할 수 있습니다. 공간을 모니터링하여 Genie 공간 편집기에서는 비즈니스 사용자가 제기한 쿼리와 Genie 공간의 응답 방식을 사전에 이해할 수 있습니다.

Genie가 어려움을 겪고 있는 질문을 식별하여 특정 지침으로 지니 공간을 업데이트하여 응답을 개선할 수 있습니다. 질문을 클릭하여 질문 및 응답 텍스트를 엽니다. 이 보기에서 전체 채팅 스레드에 액세스할 수도 있습니다.

생성된 SQL 편집

모든 응답에서 생성된 SQL을 검토하고 편집할 수 있습니다. Genie 공간 작성자는 일반적으로 Genie가 잘못된 답변을 생성할 때 이를 인식할 수 있는 도메인 및 데이터를 알고 있습니다. 생성된 SQL 쿼리에 대한 적은 양의 수동 튜닝으로 오류를 수정할 수 있는 경우가 많습니다. 응답에 대해 생성된 SQL 쿼리를 보려면, 생성된 코드 표시를 클릭하여 쿼리를 확인하십시오.

Genie 공간에서 "편집할 수 있음" 이상의 권한이 있는 경우, 생성된 SQL 문을 편집하여 수정할 수 있습니다. 수정한 후 쿼리를 실행합니다. 그런 다음, 나중에 대답하는 방법을 지니에게 가르치기 위한 지침으로 저장할 수 있습니다. 편집한 쿼리를 저장하려면 "명령으로 저장"을 클릭합니다.

지니 공간 공유

Genie 공간 사용자는 Genie 공간에 연결된 웨어하우스에 대해 CAN USE 권한이 있어야 하며 공간에 표시되어 있는 Unity 카탈로그 개체에 대한 접근 권한이 있어야 합니다. 어떤 데이터를 사용해야 하나요?.

새 Genie 공간은 기본적으로 사용자 폴더에 저장됩니다. 다른 작업 영역 개체와 마찬가지로 묶은 폴더에서 사용 권한을 상속합니다. 작업 영역 폴더 구조를 사용하여 다른 사용자와 공유할 수 있습니다. 작업 영역 개체를 폴더로 정리하는 것을참조하십시오.

지정된 권한 수준에서 공유할 특정 사용자 또는 그룹을 지정할 수도 있습니다. CAN MANAGE, CAN EDIT, CAN RUN 및 CAN VIEW.

특정 사용자 또는 그룹과 공유하려면 다음을 수행합니다.

1. 공유클릭합니다.
2. 공간을 공유할 사용자 또는 그룹을 입력합니다. 그런 다음 추가를 클릭하고 적절한 사용 권한 수준을 설정합니다. 개별 사용자와 소규모 그룹의 구성원은 공간이 공유되었음을 확인하는 이메일 알림을 받습니다.
3. 공유 대화 상자 아래쪽의 복사 링크 단추를 사용하여 지니 공간에 대한 공유 가능한 링크를 가져옵니다. 권한 있는 사용자는 링크를 클릭하여 새 탭에서 지니 공간을 열고 질문을 할 수 있습니다.

지니 공간을 복제하다

Genie 공간을 복제하면 모든 설정 컨텍스트 및 지침을 포함하여 복사본이 만들어집니다. 이는 잘 개발된 공간이 있고 추가 테스트를 위한 새 공간을 만들거나 원래 공간에서 컨텍스트를 다시 사용하려는 경우에 유용합니다. 공간이 복제되면 새로 복제된 공간은 원본과 독립적으로 동작하므로 원본에 영향을 주지 않고 편집하고 조정할 수 있습니다.

다음 요소는 복제된 Genie 공간에 복사됩니다.

• 테이블 및 설정
• 일반 지침
• 예제 SQL 쿼리
• SQL 함수

기존 채팅 스레드 및 기록 데이터는 새 공간에 복사되지 않습니다.

지니 공간을 복제하려면 다음을 수행합니다.

1. 복제하고자 하는 지니 공간을 열어보세요.
2. 공간의 오른쪽 위 모서리에 있는 <케밥 메뉴> 케밥 메뉴를 클릭합니다.
3. 복제를 클릭합니다.
4. (선택 사항) 복제 대화 상자에서 복제된 Genie 공간에 대한 새 이름 및 작업 영역 폴더 위치를 지정합니다.
5. 복제을 클릭하여 새 공간을 만드십시오.

공간 준비 모범 사례

모범 사례에 대한 지침과 문제 해결에 대한 도움말은 효과적인 Genie 공간 큐레이팅을 참조하십시오.

사용량 모니터링

감사 로그를 사용하여 Genie 공간의 사용량을 모니터링할 수 있습니다. AI/BI Genie 이벤트참조하세요.

Genie 대화 API 사용

Genie Conversation API 질문을 하거나, 생성된 SQL 및 쿼리 결과를 검색하거나, Genie 공간과 관련된 세부 정보를 가져올 수 있는 기존 Genie 공간에 대한 엔드포인트를 노출합니다. 대화 API의 처리량 속도는 최상의 작업이며 시스템 용량에 따라 달라집니다. 일반 또는 트래픽이 낮은 조건에서 요청은 작업 영역당 분당 5개의 쿼리로 제한됩니다. 사용량이 가장 많은 기간에는 사용 가능한 용량에 따라 요청이 처리되기 때문에 실제 처리량이 낮아질 수 있습니다.

Mosaic AI Agent Framework를 사용하여 다중 에이전트 시스템을 만드는 방법을 알아보려면 다중 에이전트 시스템에서 Genie 사용을 참조하세요.