Cosmos DB에서 Azure용 Microsoft Copilot을 사용하여 NoSQL 쿼리 생성(미리 보기)

적용 대상: NoSQL

Cosmos DB의 Azure용 Microsoft Copilot(미리 보기)은 자연스러운 영어 프롬프트를 기반으로 쿼리를 생성하여 Azure Cosmos DB for NoSQL 쿼리 작성을 지원할 수 있습니다. Copilot은 데이터 탐색기 내의 API for NoSQL 쿼리 편집기에서 사용할 수 있습니다. API for NoSQL의 Copilot을 사용하면 다음을 수행할 수 있습니다.

  • NoSQL 쿼리를 생성하기 위해 텍스트나 대화에서 하듯이 데이터에 대해 질문합니다.
  • 생성된 쿼리에 대한 자세한 설명을 통해 보다 빠르게 쿼리를 작성하는 방법을 배워보세요.

참고 항목

데이터 탐색기에 데이터베이스 CopilotSampleDb가 나타나는 것을 볼 수 있습니다. 이는 Microsoft에서 관리하는 완전히 별도의 데이터베이스이며 Cosmos DB의 Azure용 Microsoft Copilot에 익숙해지기 위한 테스트베드로 액세스가 무료로 제공됩니다. 이 데이터베이스는 Microsoft에서 만든 100% 가상 데이터로 구성되며 Azure Cosmos DB에 있을 수 있는 데이터와 상호 작용이나 관계가 없습니다.

Warning

Copilot은 LLM(대규모 언어 모델)을 기반으로 하는 미리 보기 기능입니다. Copilot에서 생성된 출력에는 부정확성, 바이어스 또는 기타 의도하지 않은 콘텐츠가 포함될 수 있습니다. 이는 Copilot을 지원하는 모델이 인터넷 및 기타 원본의 정보에 대해 학습을 받았기 때문에 발생합니다. 모든 생성 AI 모델과 마찬가지로 인간은 사용하기 전에 Copilot에서 생성된 출력을 검토해야 합니다.

필수 조건

Important

NoSQL용 쿼리 Copilot을 사용하기 전에 이러한 미리 보기 용어를 검토합니다.

기능에 액세스

미리 보기 기능으로 Cosmos DB 미리 보기의 Azure용 Microsoft Copilot을 Azure 구독에 추가해야 합니다. 등록하고 나면 데이터 탐색기의 쿼리 편집기와 통합된 Azure용 Microsoft Copilot을 찾을 수 있습니다.

  1. Azure Cosmos DB NoSQL 리소스로 이동합니다.

  2. 탐색 창에서 데이터 탐색기를 선택합니다.

    Screenshot of the Data Explorer welcome screen with Copilot card.

  3. 다음으로 다음 두 가지 방법 중 하나를 사용하여 쿼리 편집기 환경을 엽니다.

    • 데이터 탐색기의 시작 화면에서 Copilot으로 더 빠른 쿼리 카드를 선택합니다. 이 옵션을 사용하면 Copilot에서 사용할 샘플 데이터가 포함된 CopilotSampleDb 데이터베이스 및 SampleContainer 컨테이너를 대상으로 하는 쿼리 편집기로 이동됩니다. 이 데이터베이스는 Microsoft에서 관리하며 다른 데이터베이스와 상호 작용하거나 연결하지 않습니다. CopoilotSampleDb는 모든 Azure Cosmos DB NoSQL 고객에게 무료입니다.

    • API for NoSQL 데이터베이스 및 컨테이너를 선택합니다. 그런 다음 메뉴 모음에서 새 SQL 쿼리를 선택합니다.

쿼리 생성

Copilot을 사용하여 데이터베이스의 모든 컨테이너에 있는 자연어 텍스트에서 NoSQL 쿼리를 생성할 수 있습니다.

  1. Copilot 인터페이스가 사용하도록 설정되어 있는지 확인합니다. 데이터 탐색기 메뉴에서 Copilot 단추를 선택하여 인터페이스를 사용하도록 설정할 수 있습니다.

  2. 입력 영역에 데이터에 대한 프롬프트나 질문을 입력한 다음 프롬프트를 트리거합니다. 그런 다음 쿼리 편집기에서 NoSQL 쿼리 및 설명 생성을 트리거합니다.

    Screenshot of the Copilot interface in the query editor.

    Warning

    모든 생성 AI 모델과 마찬가지로 인간은 사용하기 전에 Copilot에서 생성된 출력을 검토해야 합니다.

  3. 데이터 탐색기 메뉴에서 쿼리 실행을 선택하여 쿼리를 실행합니다.

피드백 제공

생성된 쿼리에 대한 피드백을 사용하여 Copilot을 개선하고 학습합니다. 이 피드백은 Copilot의 제안 품질을 개선하는 데 중요합니다.

  1. 쿼리에 대한 피드백을 보내려면 쿼리 편집기 내의 피드백 메커니즘을 사용합니다.

  2. 긍정적 또는 부정적 피드백 옵션을 선택합니다.

    • 긍정적인 피드백은 생성된 쿼리를 Copilot이 성공한 위치에 대한 데이터 포인트로 Microsoft에 보내는 도구를 트리거합니다.

    • 부정적인 피드백은 추가 정보를 요청하는 대화 상자를 트리거합니다. 도구는 이 정보와 생성된 쿼리를 Microsoft로 보내 Copilot을 개선하는 데 도움을 줍니다.

      Screenshot of the Microsoft Copilot feedback form.

효과적인 프롬프트 작성

다음은 효과적인 프롬프트 작성을 위한 몇 가지 팁입니다.

  • Copilot에 대한 프롬프트를 만들 때 찾고 있는 특정 정보에 대한 명확하고 간결한 설명부터 시작합니다. 데이터 구조가 확실하지 않은 경우 SELECT TOP 1 - FROM c 쿼리를 실행하여 컨테이너의 첫 번째 항목을 확인합니다.

  • 컨테이너의 항목 구조와 관련된 키워드와 컨텍스트를 사용합니다. 이 컨텍스트는 Copilot이 정확한 쿼리를 생성하는 데 도움이 됩니다. 속성과 필터링 기준을 최대한 명시적으로 지정합니다. Copilot은 컨테이너에 있는 기존 항목의 속성을 고려하여 오타를 수정하거나 컨텍스트를 이해할 수 있어야 합니다.

  • 프롬프트에서 모호하거나 지나치게 복잡한 언어를 사용하지 마세요. 명확성을 유지하면서 질문을 간소화합니다. 이러한 편집을 통해 Copilot은 이를 컨테이너에서 원하는 데이터를 쿼리하는 의미 있는 NoSQL 쿼리로 효과적으로 변환할 수 있습니다.

  • 다음 예 프롬프트는 명확하고 구체적이며 데이터 항목의 속성에 맞게 조정되어 Copilot이 정확한 NoSQL 쿼리를 더 쉽게 생성할 수 있도록 해줍니다.

    • Show me a product
    • Show all products that have the word "ultra" in the name or description
    • Find the products from Japan
    • Count all the products, group by each category
    • Show me all names and prices of products that reviewed by someone with a username that contains "Mary"

다음 단계