1克隆代码仓库
把官方示例仓库拉到本地，后续 azd 命令都在这个目录里执行。
git clone https://github.com/Azure-Samples/chat-with-your-data-solution-accelerator.git
cd chat-with-your-data-solution-accelerator2登录 Azure 账号
用 azd 登录目标订阅，确保有权限创建资源组和 Azure OpenAI 等资源。
azd auth login3确认 OpenAI 配额
按官方 docs/QuotaCheck.md 检查订阅内 Azure OpenAI 容量是否够用，不够会被部署阻断。
4执行一键部署
运行 azd up，按提示选择订阅和区域，脚本会预置全部 Azure 资源并部署应用，耗时较长。
azd up5打开应用地址
部署完成后终端会打印 Web 应用 URL，浏览器打开即为聊天界面。
6上传数据并提问
进入 admin 管理页上传文档或索引网页，等待摄取完成后回到聊天页验证引用。
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
Azure 订阅 / 区域 | 是 | azd up 交互式选择部署目标订阅与区域 | East US 2 |
Azure OpenAI 配额 | 是 | 需在订阅内预留足够 GPT 模型容量 | 按 docs/QuotaCheck.md 检查 |
azd up 结束后终端打印 Web 应用 URL，打开该地址能进入聊天页面，并可在 admin 页上传文档。
Q：部署时提示 Azure OpenAI 配额不足怎么办？
A：按官方 docs/QuotaCheck.md 检查订阅配额，申请提额或更换有容量的区域后重新执行 azd up。
Q：部署后应用突然不可用？
A：可能是租户安全策略（如禁止公网访问）周期性生效，可参考 docs/AVMPostDeploymentGuide.md 部署 WAF 合规版本。
Q：如何让助手能回答我的文档内容？
A：部署后先进入 admin 管理页上传文档或索引网页，等摄取任务完成再到聊天页提问。
Q：部署完成需要做哪些确认？
A：向助手提问后，确认回答中带有可跳回源文档的行内引用（inline citations）。
LangChain、LlamaIndex、Haystack
chat-with-your-data-solution-accelerator 是搜索知识领域的开源项目，由 Azure-Samples 开发，2023 年首次发布。
在全站 13,014 个收录项目中，它的 GitHub 星标数（1,180）位列前 30%，在搜索知识分类中处于中上游。
项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。MIT许可证，可自行部署至Azure，无软件费用，但使用Azure服务需支付相应云资源费用。
它主要面向的使用场景是：企业知识库问答系统快速原型开发。同类可对比的替代方案包括 LangChain、LlamaIndex、Haystack。
firecrawl
开源
网页抓取像喝水一样简单，开发者省下整周加班
The web data API to search, scrape, and interact at scale.
contoso-chat
开源
一键跑通 Azure RAG 应用，从代码到评估部署全流程
This sample has the full End2End process of creating RAG application with Prompty an···
graphify
开源
整个代码库画成一张图，找问题一眼定位
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable k···
ragflow
开源
让大模型用上你的私有知识，搭建可靠的企业级RAG应用
RAGFlow is a leading open-source Retrieval-Augmented Generation (RAG) engine that fu···