Share via


使用 Cosmos DB 中的 Microsoft Copilot for Azure 產生 NoSQL 查詢 (預覽版)

適用於:NoSQL

Cosmos DB 中 Microsoft Copilot for Azure (預覽版) 可以根據您的自然英文語言提示產生查詢,協助製作適用於 NoSQL 的 Azure Cosmos DB 查詢。 Copilot 可用於資料總管內 NoSQL 查詢編輯器的 API。 在 NoSQL 的 API 中使用 Copilot,您可以:

  • 詢問有關資料的問題,就像在文字或對話中一樣,以產生 NoSQL 查詢。
  • 透過所產生查詢的詳細說明,了解如何快速撰寫查詢。

注意

您可能會看到資料庫 CopilotSampleDb 出現在資料總管中。 這是由 Microsoft 管理且完全獨立的資料庫,提供您存取作為測試資料庫 (免費),以熟悉 Cosmos DB 中的 Microsoft Copilot for Azure。 此資料庫 100% 是由 Microsoft 所建立的綜合資料所組成,且與您在 Azure Cosmos DB 中可能擁有的資料沒有任何互動或關聯性。

警告

Copilot 是一項預覽功能,由大型語言模型 (LLM) 提供。 Copilot 所產生的輸出可能包含錯誤、偏差或其他非預期內容。 這是因為提供 Copilot 的模型是根據來自網際網路和其他來源的資訊進行訓練。 如同任何升成式 AI 模型,人類應該先檢閱 Copilot 所產生的輸出,再進行使用。

必要條件

重要

使用 Copilot for NoSQL 查詢之前,請先檢閱這些預覽條款

存取功能

作為預覽功能,您需要在 Cosmos DB 的 Microsoft Copilot for Azure 預覽版中新增 Azure 訂用帳戶。 註冊之後,您可以找到與資料總管查詢編輯器整合的 Microsoft Copilot for Azure。

  1. 瀏覽至任何 Azure Cosmos DB NoSQL 資源。

  2. 從瀏覽窗格中選取資料總管

    Screenshot of the Data Explorer welcome screen with Copilot card.

  3. 接下來,從下列兩種方式之一開啟查詢編輯器體驗:

    • 在資料總管的歡迎畫面上,選取使用 Copilot 快速查詢卡片。 此選項會帶您前往以 CopilotSampleDb 資料庫和 SampleContainer 容器為目標的查詢編輯器,其中包含可供您搭配 Copilot 使用的範例資料。 此資料庫是由 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.

    警告

    如同任何升成式 AI 模型,人類應該先檢閱 Copilot 所產生的輸出,再進行使用。

  3. 選取資料總管功能表中的執行查詢,以執行查詢。

提供意見反應

我們會使用所產生查詢的意見反應來協助改善及訓練 Copilot。 此意見反應對於改善 Copilot 的質量至關重要。

  1. 若要傳送查詢的意見反應,請使用查詢編輯器內的意見反應機制。

  2. 選取正面負面意見反應選項。

    • 正面意見反應會觸發工具,將產生的查詢傳送給 Microsoft 作為 Copilot 成功的資料點。

    • 負面意見反應會觸發對話方塊,以要求更多資訊。 工具會將此資訊和產生的查詢傳送給 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"

後續步驟