주제를 사용하면 Fabric 데이터 에이전트가 SQL을 생성할 수 있도록 돕는 대규모 주제 기반 지침을 제공할 수 있습니다. 모든 주제 콘텐츠를 질문마다 보내는 대신, 데이터 에이전트는 콘텐츠를 검색하여 질문과 관련된 부분만 NL2SQL 도구에 제공합니다.
주제별로 정리할 수 있는 방대한 지침이 있을 때 주제를 사용하세요. 예를 들어, 판매, 재고, 고객 유지 섹션을 만들고, 각 주제에 적용되는 비즈니스 정의와 쿼리 지침을 제공할 수 있습니다.
메모
주제들은 미리보기 상태이며 미리보기 런타임에서 SQL 데이터 소스에만 사용할 수 있습니다.
주제 및 데이터 소스 지침
주제와 데이터 소스 지침은 쿼리 생성 도구에 다양한 맥락을 제공합니다:
| Configuration | 데이터 에이전트가 이를 어떻게 사용하는지에 대해 | 사용 시기 |
|---|---|---|
| 주제 | 데이터 에이전트는 주제 내용을 검색하여 관련 섹션을 NL2SQL로 전송합니다. | 주제별로 나눌 수 있고 질문이 주제와 관련될 때만 필요한 긴 지침에 사용하세요. |
| 데이터 원본 지침 | 데이터 에이전트는 데이터 소스를 사용할 때마다 쿼리 생성 도구로 명령을 보냅니다. | 데이터 소스에 보내지는 모든 질문에 반드시 적용되어야 하는 규칙과 맥락을 위해 사용됩니다. |
예를 들어, 모든 쿼리가 반드시 사용해야 한다면 데이터 소스 지침에 조직 전체의 회계연도 정의를 포함시키는 것입니다. 고객 유지 관련 질문에만 필요한 안내라면, 고객 유지 계산에 대한 상세한 지침을 고객 유지 주제에 포함하세요.
주제와 데이터 소스 지침을 함께 사용할 수 있습니다. 질문이 두 가지 모두를 요구할 때, NL2SQL은 데이터 소스 지침과 관련 주제 내용을 받습니다.
주제별 지침 추가하세요
지원되는 SQL 데이터 소스마다 최대 100만 자자까지 주제 콘텐츠를 추가할 수 있습니다.
Fabric 데이터 에이전트를 열고 SQL 데이터 소스를 선택하세요.
데이터 소스 구성에서는 데이터 소스 주제를 열어둡니다.
주제별 지침을 입력하세요. 마크다운 제목을 사용해 콘텐츠를 별개의 주제로 정리하세요.
데이터 에이전트 설정을 저장하세요.
개별 주제에 맞는 시험 문제와 여러 주제가 필요한 문제도 포함하세요.
주제 콘텐츠 구성
데이터 에이전트가 질문에 맞는 올바른 섹션을 찾을 수 있도록 설명적인 Markdown 제목을 사용하세요. 해당 주제에 대한 모든 지침은 해당 제목 아래에 보관하세요.
## Customer retention
Use the CustomerSubscription table for retention questions.
### Retained customers
A customer is retained when IsActive is 1 and RenewalDate is after the reporting date.
### Churn rate
Calculate churn rate as the number of subscriptions canceled during the period divided by the number of active subscriptions at the start of the period.
## Inventory
Use the InventorySnapshot table for current inventory questions.
### Low-stock products
A product is low in stock when QuantityOnHand is less than ReorderPoint.
사용자가 이탈에 대해 문의하면, 데이터 에이전트는 관련 없는 재고 지침을 NL2SQL로 보내지 않고도 고객 유지 지침을 가져올 수 있습니다.
실행 단계로 검색한 주제들을 검토하세요
질문을 테스트한 후에는 오픈 데이터 소스 주제 실행 단계를 검토하여 데이터 에이전트가 선택한 주제 내용을 확인하세요. 입력은 방향 경로와 주제가 선택된 이유를 보여줍니다. 출력은 NL2SQL에 제공되는 명령어를 보여줍니다.
모범 사례
- 질문에서 사용하는 용어와 일치하는 제목을 사용하세요.
- 각 주제를 독립적으로 유지하세요. 관련 비즈니스 정의, 표, 열, 관계, 필터, 계산 규칙을 같은 주제 제목 아래에 포함하세요.
- 넓은 주제 내에서 관련 시나리오를 구분하기 위해 소제목을 사용하세요.
- 데이터 소스 지침에 모든 SQL 질문에 반드시 적용되어야 하는 규칙을 여러 주제에서 반복하지 말고 넣으세요.
- 주제와 데이터 소스 지침 간에 지침을 중복하거나 모순하는 것을 피하세요.
- 직접 질문, 대체 표현, 여러 주제의 내용을 요구하는 문제를 시험해 보세요.