通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用 Cosmos DB 中的 Microsoft Copilot for Azure（预览版）生成 NoSQL 查询

  • 项目

适用范围： NoSQL

Cosmos DB 中的 Microsoft Copilot for Azure（预览版）可以通过基于自然英语提示生成查询，帮助创作 Azure Cosmos DB for NoSQL 查询。 可以在数据资源管理器中的 API for NoSQL 查询编辑器中使用 Copilot。 在 API for NoSQL 中使用 Copilot，可以执行以下操作：

  • 你就像打字或说话一样来生成 NoSQL 查询，从而询问有关数据的问题。
  • 了解如何通过生成的查询的详细说明更快地编写查询。

注意

你可能会看到数据库 CopilotSampleDb 显示在数据资源管理器中。 这是由 Microsoft 管理的完全独立的数据库，你可以访问它（不收费）作为测试平台，以熟悉 Cosmos DB 中的 Microsoft Copilot for Azure。 此数据库由 Microsoft 创建的 100% 合成数据组成，并且与 Azure Cosmos DB 中可能拥有的任何数据没有任何交互或关系。

警告

Copilot 是一项预览功能，由大型语言模型 (LLM) 提供支持。 Copilot 生成的输出可能包含不准确、偏见或其他意外内容。 之所以发生这种情况，原因是为 Copilot 提供支持的模型的训练材料是来自 Internet 和其他来源。 与任何生成式 AI 模型一样，应在使用前人为查看 Copilot 生成的输出。

先决条件

重要

在使用 NoSQL 查询 Copilot 之前，请先查看这些预览术语。

访问该功能

作为预览功能，你必须将 Cosmos DB 预览版中的 Microsoft Copilot for Azure 添加到 Azure 订阅。 注册后，可以找到集成到数据资源管理器的查询编辑器的 Microsoft Copilot for Azure。

  1. 导航到任何 Azure Cosmos DB NoSQL 资源。

  2. 从导航窗格中选择“数据资源管理器”。

    包含 Copilot 卡的数据资源管理器欢迎屏幕的屏幕截图。

  3. 接下来，通过以下两种方式之一打开查询编辑器体验版：

    • 在数据资源管理器的欢迎屏幕上，选择“使用 Copilot 更快速地查询”卡片。 此选项将定向到面向 CopilotSampleDb 数据库和 SampleContainer 容器的查询编辑器，其中包含用于 Copilot 的示例数据。 此数据库由 Microsoft 管理，它不会交互或连接到你的其他数据库。 CopoilotSampleDb 向所有 Azure Cosmos DB NoSQL 客户免费提供。

    • 选择一个现有的 API for NoSQL 数据库和容器。 然后，从菜单栏中选择“新建 SQL 查询”。

生成查询

使用 Copilot，可以基于自然语言文本来对数据库中的任何容器生成 NoSQL 查询。

  1. 确保已启用 Copilot 界面。 可以通过选择数据资源管理器菜单中的“Copilot”按钮来启用该界面。

  2. 用户在输入区域中输入有关数据的提示或问题后就会触发提示。 然后会在查询编辑器中触发 NoSQL 查询和说明的生成。

    查询编辑器中 Copilot 接口的屏幕截图。

    警告

    与任何生成式 AI 模型一样，应在使用前人为查看 Copilot 生成的输出。

  3. 通过在数据资源管理器的菜单中选择“执行查询”来运行查询。

提供反馈

我们利用对生成查询的反馈来帮助改进和训练 Copilot。 这些反馈对于提高 Copilot 给出的建议质量至关重要。

  1. 若要发送有关查询的反馈，请使用查询编辑器中的反馈机制。

  2. 可选择正面反馈或负面反馈选项。

    • 正面反馈会触发工具将生成的查询作为一个数据点（此时 Copilot 取得成功）发送给 Microsoft。

    • 负面反馈会触发一个对话框，请求用户提供更多信息。 该工具将此信息和生成的查询发送到 Microsoft，以帮助改进 Copilot。

      Microsoft Copilot 反馈表单的屏幕截图。

编写有效的提示

下面是编写有效提示的几个小技巧。

  • 在为 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"

下一步

查看 Copilot 常见问题