azure-search-openai-demo

环境要求

• Azure 订阅账号（需可创建 Azure OpenAI 与 Azure AI Search 资源）
• 安装 Azure Developer CLI（azd）
• 本地开发需 Python 环境并已成功执行过 azd up
• Windows 本地开发需 PowerShell；Linux/Mac 使用 Bash

安装与启动步骤

1. 1登录 Azure 账号

   使用 azd 登录 Azure 账号；GitHub Codespaces 中若失败，改用设备代码登录。

   azd auth login

   复制

2. 2创建设备码登录

   仅当上一步在 Codespaces 中失败时使用，按提示在浏览器完成设备登录。

   azd auth login --use-device-code

   复制

3. 3创建 azd 环境

   输入一个名称用作资源组名，会在 .azure 目录创建环境文件夹并设为当前环境。

   azd env new

   复制

4. 4按需定制部署

   可选：通过环境变量配置已有资源、启用认证或视觉等可选功能、低成本或免费试用部署。

5. 5一键部署到 Azure

   执行后自动创建 Azure 资源并部署应用到 Azure Container Apps，并按 data 目录构建搜索索引。

   azd up

   复制

6. 6仅重新部署代码

   只修改了 app 目录下的前后端代码时使用，无需重新创建 Azure 资源。

   azd deploy

   复制

7. 7启动本地开发服务器

   必须先成功执行过 azd up。Windows 执行 ps1，Linux/Mac 执行 sh；VS Code 可运行 Start App 任务。

   ./app/start.ps1
   
   ./app/start.sh

   复制

如何确认成功

azd up 成功后控制台会打印应用 URL，浏览器打开即可交互；看到 SUCCESS 后可能还需等 5-10 分钟才完全可用。

常见问题

注意事项

• 该模板面向示例演示，官方建议不要直接用于生产环境，需自行补充安全能力。
• azd up 会创建真实 Azure 资源并立即计费，测试完请及时 azd down 清理。
• 本地开发服务器必须在成功执行 azd up 之后才能启动。
• 部署时选区域依据 OpenAI 模型可用性表，可能随可用性变化而过时。