通过

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

VS Code 中的 Azure AI Studio 项目入门（预览版）

  • 项目

重要

本文中标记了“（预览版）”的项目目前为公共预览版。 此预览版未提供服务级别协议，不建议将其用于生产工作负载。 某些功能可能不受支持或者受限。 有关详细信息，请参阅 Microsoft Azure 预览版补充使用条款。

Azure AI Studio 支持在 VS Code - 桌面和 Web 中开发。 在每个方案中，你的 VS Code 实例会远程连接到在虚拟机上运行的预生成的自定义容器，也称为计算实例。

从 Azure AI Studio 启动 VS Code

  1. 转到 Azure AI Studio。

  2. 在 Azure AI Studio 中打开项目。

  3. 在左侧菜单中，选择“代码”。

  4. 对于“计算”，请选择现有计算实例或创建新的计算实例。

    • 选择要使用的计算实例。 如果已停止，请选择“启动计算”并等待它切换到“正在运行”。 当计算可供使用时，你将看到“就绪”状态。
    • 如果没有计算实例，请输入名称并选择“创建计算”。 等待计算实例准备就绪。

  5. 对于“VS Code 容器”，在按钮启用后，选择“设置容器”。 这会为你配置计算上的容器。 容器设置可能需要几分钟才能完成。 首次设置容器后，可以直接启动后续时间。 系统提示时，可能需要对计算进行身份验证。 安装完成后，你将看到“就绪”。

    警告

    即使对计算实例启用空闲关闭，对于使用此自定义 VS Code 容器设置的任何计算，也不会发生空闲关闭。 这是为了确保你在容器中工作时，计算不会意外关闭。

  6. 在 VS Code 中打开项目：

    • 如果要在本地 VS Code 实例中工作，请选择“在 VS Code （桌面版）中启动”。 VS Code 的新本地实例在本地计算机上打开。
    • 如果要改为在浏览器中工作，请选择下拉箭头，然后选择“在 VS Code (Web) 中启动”。 将打开一个连接到 vscode.dev 的新浏览器选项卡。

    屏幕截图显示“VS Code 中的工作”页已准备好启动。

自定义容器文件夹结构

预生成的开发环境基于具有 Azure AI SDK、提示流 SDK 和其他工具的 docker 容器。 环境配置为在容器内部远程运行 VS Code。 容器的定义方式与此 Dockerfile 类似，并基于 Microsoft 的 Python 3.10 开发容器映像。

文件资源管理器将打开到从 AI Studio 中启动的特定项目目录。

容器使用 Azure AI 文件夹层次结构（afh 目录）进行配置，该层次结构旨在为你在当前的开发上下文中指明方向，帮助你更高效地使用代码、数据和共享文件。 此 afh 目录包含 Azure AI Studio 项目，每个项目都有一个专用项目目录，其中包括 code、data 和 shared 文件夹。

下表总结了文件夹结构：

Folder 说明
code 用于处理 git 存储库或本地代码文件。

code 文件夹是直接位于计算实例上的存储位置，对于大型存储库来说性能很高。 这是克隆 git 存储库或引入或创建代码文件的理想位置。
data 用于存储本地数据文件。 建议使用 data 文件夹以一致的方式存储和引用本地数据。
shared 用于处理项目的共享文件和资产，例如提示流。

例如，shared\Users\{user-name}\promptflow 是项目提示流的位置。

重要

建议在此项目目录中工作。 包含在项目目录中的文件、文件夹和存储库会保留在主机（计算实例）上。 即使计算实例停止或重启，存储在代码和数据文件夹中的文件也会保留，但如果计算被删除，则会丢失。 但是，共享文件保存在中心的存储帐户中，因此，如果删除计算实例，则不会丢失。

使用提示流

可以创建、引用和使用提示流。

可以在 shared\Users\{user-name}\promptflow 中找到已在 Azure AI Studio 中创建的提示流。 还可以在 code 或 shared 文件夹中创建新流。

提示流会自动使用项目有权访问的 Azure AI Studio 连接。

还可以使用 VS Code 中的提示流扩展，该扩展已在此环境中预安装。 在此扩展中，可以将连接提供程序设置为项目。 请参阅使用来自 Azure AI 的连接。

有关详细信息，请参阅提示流功能。

使用 AI 应用模板

AI 应用模板从项目的“代码”选项卡右侧链接。 这些示例逐步讲解了如何使用 Azure AI SDK：

  • 设置开发环境并连接到现有资源
  • 引入自定义应用程序代码
  • 运行评估
  • 部署你的代码

若要预配一组全新的资源（包括新的中心和项目），并部署这些示例应用程序，可以在本地开发环境中使用 Azure 开发人员 CLI (AZD)。

注解

如果计划跨多个代码和数据目录或多个存储库工作，则可以在 VS Code 中使用拆分根文件资源管理器功能。 若要试用该功能，请执行以下步骤：

  1. 输入 Ctrl+Shift+p 以打开命令面板。 搜索并选择“工作区：将文件夹添加到工作区”。
  2. 选择要加载的存储库文件夹。 你应该会在文件资源管理器中看到一个新的部分，显示你打开的文件夹。 如果它是存储库，现在可以在 VS Code 中使用源代码管理。
  3. 如果要将此配置保存到未来的开发会话，请再次输入 Ctrl+Shift+p 并选择“工作区：将工作区另存为”。 此操作会将配置文件保存到当前文件夹。

有关首选编程语言中的应用模板和 SDK 示例，请参阅开发使用 Azure AI 服务的应用。

相关内容