你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
教程：第 1 部分 - 使用提示流 SDK 创建用于生成自定义聊天应用程序的资源
在本教程中，你将使用提示流 SDK（和其他库）为零售公司 Contoso Trek 生成、配置、评估和部署聊天应用。 零售公司专门销售户外露营装备和服装。 聊天应用应该回答有关产品和服务的问题。 例如，聊天应用可以回答诸如“哪种帐篷最防水？”或“最适合寒冷天气的睡袋是什么？”之类的问题。
本教程是由三个部分构成的教程的第一部分。 本部分演示 Azure 订阅的管理员如何创建和配置教程系列第二部分和第三部分所需的资源。 第二部分和第三部分演示开发人员如何使用资源。 在许多组织中，同一个人可能会承担这两个角色。 在第 1 部分中，你将学习如何：
- 创建 Azure AI Studio 中心
- 创建项目
- 创建 Azure AI 搜索索引
- 为 Azure AI Studio 和 Azure AI 搜索资源配置访问权限
如果已完成其他教程或快速入门，则可能已经创建了本教程所需的一些资源。 如果有，可以跳过此处的步骤。
本教程是由三个部分构成的教程的第一部分。
先决条件
- 具有活动订阅的 Azure 帐户。 如果你没有帐户，请免费创建一个。
重要
你必须具有在 Azure 订阅中添加角色分配所需的权限。 仅允许由特定 Azure 资源的所有者授予权限（通过角色分配）。 你可能需要让你的 Azure 订阅所有者（可能是你的 IT 管理员）完成本教程。
Azure AI Studio 和 Azure 门户
在本教程中，你将使用 Azure 资源生成聊天应用。 你将使用 Azure AI Studio 和 Azure 门户来创建和配置这些资源。
- 管理员使用 Azure 门户配置对资源的访问。
- 开发人员使用 Azure AI Studio 将生成、评估和部署聊天应用所需的资源组合在一起。 还可以在 AI Studio 中与模型和部署进行交互。
创建 Azure AI Studio 中心
注意
Azure AI Studio 中的中心是一个一站式商店，可在其中管理 AI 项目所需的一切内容（例如安全性和资源），使你可更快地开发和测试。 若要详细了解中心可如何帮助你，请参阅中心和项目概述一文。
若要在 Azure AI Studio 中创建中心，请执行以下步骤：
转到 Azure AI Studio 的“主页”页面，然后使用你的 Azure 帐户登录。
在左侧窗格上选择“所有资源”。 如果看不到此选项，请在顶部栏中选择“所有资源和项目”。 然后选择“+ 新建中心”。
在“创建新中心”对话框中，输入中心的名称（例如 contoso-hub）。 如果你没有资源组，系统将创建一个链接到所提供订阅的新资源组。 保留默认的“连接 Azure AI 服务”选项。
选择下一步。 如果你未重用现有资源组，系统将创建一个新资源组 (rg-contoso)。 此外，还会为中心创建一个 Azure AI 服务 (ai-contoso-hub)。
注意
如果你在资源组和“连接 Azure AI 服务”条目之前未看到“（新）”，则正在使用现有资源。 出于本教程的目的，通过“创建新资源组”和“创建新 AI 服务”创建一个单独的实体。 这允许你通过在教程结束后删除实体来防止任何意外费用。
查看信息，然后选择“创建”。
可在向导中查看中心创建操作的进度。
创建项目
要在 Azure AI Studio 中创建项目，请执行以下步骤：
- 转到 Azure AI Studio 的主页。
- 选择“+ New project”。
- 输入项目的名称。
- 选择上一步中创建的中心。
创建项目后，可以访问左侧导航面板中的操场、工具和其他资源。
创建 Azure AI 搜索索引
此应用程序的目标是在自定义数据中为模型答复提供基础。 搜索索引用于根据用户的问题检索相关文档。
需要使用 Azure AI 搜索服务和连接才能创建搜索索引。
注意
创建 Azure AI 搜索服务和后续搜索索引会产生相关费用。 可以在创建页面上查看有关 Azure AI 搜索服务定价和定价层的详细信息，以便在创建资源前确认成本。
创建 Azure AI 搜索服务
如果已经拥有 Azure AI 搜索服务，则可跳至下一节。
否则，可以使用 Azure 门户创建 Azure AI 搜索服务。
- 在 Azure 门户中创建 Azure AI 搜索服务。
- 选择资源组和实例详细信息。 可在此页上查看有关定价和定价层的详细信息。
- 继续执行向导，选择“查看 + 分配“可创建资源。
- 确认 Azure AI 搜索服务的详细信息，包括估计成本。
- 选择“创建”以创建 Azure AI 搜索服务。
将 Azure AI 搜索连接到项目
如果项目中已有 Azure AI 搜索连接，则可跳至配置 Azure AI 搜索服务的访问权限。
在 Azure AI Studio 中，检查是否已连接 Azure AI 搜索资源。
- 在 AI Studio 中，转到你的项目，然后从左侧窗格中选择“设置”。
- 在“已连接资源”部分中，查看是否有 Azure AI 搜索类型的连接。
- 如果具有 Azure AI 搜索连接，可以跳到配置资源的访问权限。
- 否则，选择“新建连接”，然后选择“Azure AI 搜索”。
- 在选项中找到 Azure AI 搜索服务，然后选择“添加连接”。
- 继续执行向导以创建连接。 有关添加连接的详细信息，请参阅此操作指南。
配置资源的访问权限
本部分介绍如何配置在上一节中创建的资源所需的各种访问控制。
建议使用 Microsoft Entra ID ，而不是使用 API 密钥。 要使用这种身份验证，需要为服务设置正确的访问控制并分配正确的角色。
配置 Azure AI 服务的访问权限
从项目中开始查找 AI 服务资源：
- 在 AI Studio 中，转到你的项目，然后从左侧窗格中选择“设置”。
- 选择“连接的资源”。
- 在连接的资源列表中选择“AI 服务”或“Azure OpenAI”名称，以打开资源详细信息页。 然后在“连接详细信息”页中再次选择资源名称，这会在 Azure 门户中打开资源。
在 Azure 门户中指定访问控制：
- 在 Azure 门户的左侧页面中，选择“访问控制(IAM)”>“+ 添加”>“添加角色分配”。
- 搜索“认知服务 OpenAI 用户”角色，然后选择它。 然后选择下一步。
- 选择“用户、组或服务主体”。 然后选择“选择成员”。
- 在打开的“选择成员”窗格中，搜索要为其添加角色分配的用户的名称。 选择用户，然后选择“选择”。
- 继续执行向导，然后选择“查看 + 分配”以添加角色分配。
配置 Azure AI 搜索的访问权限
现在返回到 AI Studio 设置>连接的资源。 这次在连接的资源列表中选择“Azure AI 搜索”名称，以打开资源详细信息页。 然后在“连接详细信息”页中再次选择资源名称，这会在 Azure 门户中打开资源。
要为 Azure AI 搜索服务启用基于角色的访问控制，请按照以下步骤操作：
在 Azure 门户的 Azure AI 搜索服务中，从左侧窗格中选择“设置”>“密钥”。
选择“两者”，以确保为 Azure AI 搜索服务同时启用 API 密钥和基于角色的访问控制。
警告
可以在本地使用基于角色的访问控制，因为你将在本教程系列稍后部分运行 az login。 但在教程第 3 部分中部署应用时，会使用 Azure AI 搜索服务的 API 密钥对部署进行身份验证。 部署的 Microsoft Entra ID 身份验证支持即将推出。 现在，需要同时启用密钥和终结点。
接下来，授予用户标识（或将完成第二部分和第三部分的开发人员的标识） Azure AI 搜索服务的“搜索索引数据参与者”和“搜索服务参与者”角色。 通过这些角色，可以调用 Azure AI 搜索服务关联的用户标识。
还是在 Azure AI 搜索服务的 Azure 门户中，将“搜索索引数据参与者”角色分配给 Azure AI 搜索服务。 （上述步骤与以前为 Azure OpenAI 服务执行的步骤相同。）
- 在 Azure 门户的左侧页面中，选择“访问控制(IAM)”>“+ 添加”>“添加角色分配”。
- 搜索搜索索引数据参与者角色，然后选择该角色。 然后，选择“下一步”。
- 选择“用户、组或服务主体”。 然后选择“选择成员”。
- 在打开的“选择成员”窗格中，搜索要为其添加角色分配的用户的名称。 选择用户，然后选择“选择”。
- 继续执行向导，然后选择“查看 + 分配”以添加角色分配。
重复这些步骤，将“搜索服务参与者”角色也添加到 Azure AI 搜索服务。
现在，你已准备好将项目移交给开发人员以生成聊天应用。 开发人员将使用提示流 SDK 为零售公司 Contoso Trek 生成、配置、评估和部署聊天应用。
清理资源
为了避免产生不必要的 Azure 成本，如果不再需要在本快速入门中创建的资源，应该将其删除。 若要管理资源，可以使用 Azure 门户。
但如果你要在本教程系列的下一部分中生成聊天应用，先不要删除它们。