Note
Foundry IQ(Azure AI 搜尋服務)提供直接的索引與查詢 API,並搭配高階知識來源與知識庫 API 用於受控檢索。 使用 Azure 入口網站、REST API 或 Azure SDK 來設定這些功能,或將代理連線到 Microsoft Foundry 入口網站 中的知識庫。
了解 Python 程式碼範例,以示範 Foundry IQ(Azure AI 搜尋服務)解決方案的功能與工作流程。 這些範例會使用 Azure SDK for Python 的 Azure AI 搜尋服務用戶端程式庫,您可以透過下列連結來進行探索。
SDK 範例
Azure SDK 開發小組示範 API 使用方式的程式碼範例。 您可以在 GitHub 上的 Azure/azure-sdk-for-python/tree/main/sdk/search/azure-search-documents/samples 中找到這些範例。
文件範例
Foundry IQ 團隊的程式碼範例展示了功能與工作流程。 教學課程、快速入門和操作說明文章中會參考下列範例。 您可以在 GitHub 上的 Azure-Samples/azure-search-python-samples 中找到這些範例。
| 範例 | 發行項 | Description |
|---|---|---|
| 快速入門:代理式檢索 | 快速入門:代理式檢索 | 將語義排名與 LLM 驅動的查詢規劃和答案生成整合。 |
| 快速入門:關鍵字搜尋 | 快速入門:全文搜尋 | 使用範例資料建立、載入及查詢搜尋索引。 |
| 快速入門:語意排名 | 快速入門:語意排序 | 將語意排名新增至索引結構描述,並執行語意查詢。 |
| Quickstart-Vector-Search | 快速入門:向量搜尋 | 索引和查詢向量資料。 |
| agentic-retrieval-pipeline-example | 教學:建立端到端代理式檢索解決方案 | 與 Quickstart-Agentic-Retrieval 不同,此範例整合了 Foundry Agent Service 用於請求協調。 |
| embedding-model-migration | 移轉嵌入模型 | 備份符合條件的索引內容,重新產生所選向量欄位,並還原到新的索引。 |
| image-serving-example | 在代理擷取中顯示內嵌於文件中的 Surface 影像(預覽) | 使用受管理的擷取程序來擷取影像、在答案合成期間提供這些影像,並從 Azure Blob 儲存體 獨立查詢及下載已建立索引的影像參考。 |
Accelerators
加速器是一種端對端解決方案,其中包含程式碼和文件,您可以根據自己實作特定案例進行調整。
| 範例 | Description |
|---|---|
| RAG-experiment-accelerator | 使用 Foundry IQ 與 RAG 模式進行實驗與評估。 此範例包含載入多個資料來源、使用各種模型,以及建立各種搜尋索引和查詢的程式碼。 |
Demos
示範存放庫會為示範中顯示的範例或案例,提供概念證明原始程式碼。 與加速器不同,示範解決方案並非專為適應而設計。
| 範例 | Description |
|---|---|
| azure-search-vector-samples | 向量搜尋案例的範例完整集合,依案例或技術組織。 |
| Azure-search-openai-demo | 以 Azure OpenAI Python 程式碼,模擬企業資料的 ChatGPT 體驗,示範如何在 Azure OpenAI 中運用 Foundry IQ 搭配大型語言模型。 有關背景信息,請參閱此 博客文章。 |
| aisearch-openai-rag-audio | 「語音到 RAG。」此範例示範了一套簡單的以語音為基礎的生成式 AI 應用架構,可在即時音訊 API 之上,透過來自用戶端裝置的全雙工音訊串流啟用 Foundry IQ RAG。 它還安全地處理對模型和檢索系統的訪問。 後端程序代碼是以 Python 撰寫,而前端程式代碼則以 JavaScript 撰寫。 如需簡介,請觀看這段 影片。 |
其他範例
以下範例同樣由 Foundry IQ 團隊發布,但未在文件中被引用。 相關聯的 README 檔案提供使用指示。
| 範例 | Description |
|---|---|
| azure-search-classic-rag | 單次 RAG 採用經典搜尋引擎作為 Foundry IQ 的基礎資料,並採用 Azure OpenAI 的聊天完成模型。 |
| Quickstart-Document-Permissions-Pull-API | 利用索引器「API 拉取」方法,將存取控制清單從資料來源端傳送到搜尋結果端,並套用權限過濾器以限制對授權內容的存取。 |
| Quickstart-Document-Permissions-Push-API | 透過使用推送 API 來對 JSON 承載進行索引編製,將內嵌的權限中繼資料流向到已編製索引的文件,以及基於使用者對授權內容的存取權限進行篩選的搜尋結果。 |
| Azure-function-search | 使用 Azure 函式向 Foundry IQ 服務發送查詢。 您可以將此 Python 版本替換為 api 程式碼,此程式碼在 使用 .NET 將搜尋功能新增至網站中使用。 |
| 大量插入 | 使用推送 API 上傳並索引文件。 |
| index-backup-and-restore.ipynb | 在索引中建立可擷取欄位的本機副本,並將這些欄位推送至新索引。 |
| resumable-index-backup-restore | 備份和還原超過 100,000 個文件的較大索引。 |
Tip
使用 範例瀏覽器 在 GitHub 上搜尋 Microsoft 程式碼範例。 您可以按產品、服務和語言過濾搜索。