Azure AI 搜尋服務
Azure AI 搜尋服務可在傳統和生成式 AI 搜尋應用程式中，針對使用者擁有的內容大規模提供安全的資訊擷取。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | Microsoft |
| URL | https://support.microsoft.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft |
| 網站 | https://learn.microsoft.com/en-us/azure/search/search-what-is-azure-search/ |
| 類別 | 人工智慧;商業智慧 |
| 隱私策略 | https://privacy.microsoft.com/en-us/privacystatement |
正在建立連線
連接器支援下列驗證類型：
| [variables（'connectionStringAuthDefaultDisplayName'）] | [variables（'connectionStringAuthDefaultDescription'）] | 除了 Azure Government 和美國政府（GCC）以外的所有區域 | 不可共享 |
| 存取金鑰 | 提供連接字串以存取您的 Azure AI 搜尋服務。 | 僅限 Azure Government 與美國政府（GCC） | 不可共享 |
| 用戶端憑證驗證 | 使用 PFX 憑證和密碼提供 Microsoft Entra ID 認證 | 所有區域 | 可共用 |
| 受控識別 | 使用受控識別建立連線 | 僅限 LOGICAPPS | 可共用 |
| Microsoft Entra ID 整合式 | 使用 Microsoft Entra ID 來存取 | 所有區域 | 不可共享 |
| 服務主體 （Microsoft Entra ID 應用程式） | 使用 Microsoft Entra ID 應用程式來存取您的 Azure AI 搜尋服務。 | 所有區域 | 不可共享 |
| 預設值 [已棄用] | 此選項僅適用於沒有明確驗證類型的舊連線，並且僅用於回溯相容性。 | 所有區域 | 不可共享 |
[variables（'connectionStringAuthDefaultDisplayName'）]
驗證 ID：adminkey
適用範圍：除 Azure Government 及美國政府（GCC）外的所有區域
[variables（'connectionStringAuthDefaultDescription'）]
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| Azure AI 搜尋端點 URL | 字串 | 要連線的 Azure AI 搜尋服務端點 | 對 |
| Azure AI 搜尋系統管理員金鑰 | securestring | 與 Azure AI 搜尋服務連線的系統管理員金鑰 | 對 |
存取鍵
驗證 ID：adminkey
適用：僅限 Azure Government 及美國政府（GCC）
提供連接字串以存取您的 Azure AI 搜尋服務。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| Azure AI 搜尋端點 URL | 字串 | 要連線的 Azure AI 搜尋服務端點 | 對 |
| Azure AI 搜尋系統管理員金鑰 | securestring | 與 Azure AI 搜尋服務連線的系統管理員金鑰 | 對 |
用戶端憑證驗證
驗證 ID：certOauth
適用：所有地區
使用 PFX 憑證和密碼提供 Microsoft Entra ID 認證
這是可共享的連接。 如果 Power App 與其他使用者共用，也會共用連線。 如需詳細資訊，請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| Azure AI 搜尋端點 URL | 字串 | 提供 Azure AI 搜尋服務命名空間端點 （例如：ai://testai.search.windows.net/） | 對 |
| 租戶 | 字串 | 對 | |
| 用戶端識別碼 | 字串 | Microsoft Entra ID 應用程式的用戶端識別碼 | |
| 用戶端憑證密碼 | 客戶憑證 | 此應用程式允許的用戶端憑證密碼 | 對 |
受控識別
驗證 ID：managedIdentityAuth
適用：僅限 LOGICAPPS
使用受控識別建立連線
這是可共享的連接。 如果 Power App 與其他使用者共用，也會共用連線。 如需詳細資訊，請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 受控識別 | managedIdentity | 使用受控識別登入 | 對 |
| Azure AI 搜尋端點 URL | 字串 | 提供 Azure AI 搜尋服務命名空間端點 （例如：ai://testai.search.windows.net/） | 對 |
Microsoft整合的 Entra ID
驗證 ID：oauth
適用：所有地區
使用 Microsoft Entra ID 來存取
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| Azure AI 搜尋端點 URL | 字串 | 提供 Azure AI 搜尋服務命名空間端點 （例如：ai://testai.search.windows.net/） | 對 |
服務主體 （Microsoft Entra ID 應用程式）
驗證 ID：oauthSP
適用：所有地區
使用 Microsoft Entra ID 應用程式來存取您的 Azure AI 搜尋服務。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| Azure AI 搜尋端點 URL | 字串 | 提供 Azure AI 搜尋服務命名空間端點 （例如：ai://testai.search.windows.net/） | 對 |
| 租戶 | 字串 | 對 | |
| 用戶端識別碼 | 字串 | 對 | |
| 用戶端密碼 | securestring | 對 |
預設值 [已棄用]
適用：所有地區
此選項僅適用於沒有明確驗證類型的舊連線，並且僅用於回溯相容性。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| Azure AI 搜尋端點 URL | 字串 | 要連線的 Azure AI 搜尋服務端點 | 對 |
| Azure AI 搜尋系統管理員金鑰 | securestring | 與 Azure AI 搜尋服務連線的系統管理員金鑰 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 200 | 60 秒 |
動作
| 代理搜尋（預覽） |
代理搜尋。 |
| 刪除多份文件 |
刪除指定的文件。 |
| 刪除文件 |
刪除單一文件。 |
| 取得搜尋索引 |
此作業會取得 Azure AI 搜尋服務中具有欄位詳細資料的所有索引結構描述。 |
| 取得索引統計資料 |
此作業會取得 Azure AI 搜尋服務中索引的統計資料。 |
| 合併文件 |
合併單一文件。 |
| 搜尋向量 |
帶有過濾器的單一向量搜尋。 |
| 索引多份文件 |
索引指定的文件。 |
| 索引文件 |
為單一文件編製索引。 |
| 自然語言搜尋向量 |
使用自然語言搜尋向量。 |
| 語意混合搜尋 |
具有篩選器的語意混合式搜尋。 |
代理搜尋（預覽）
代理搜尋。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
索引名稱
|
indexName | True | string |
索引名稱。 |
|
代理人名稱
|
agentName | True | string |
客服專員名稱。 |
|
角色
|
role | string |
角色 |
|
|
代理訊息內容
|
content | string |
代理訊息內容 |
傳回
刪除多份文件
刪除指定的文件。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
索引名稱
|
indexName | True | string |
索引名稱。 |
刪除文件
刪除單一文件。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
索引名稱
|
indexName | True | string |
索引名稱。 |
取得搜尋索引
此作業會取得 Azure AI 搜尋服務中具有欄位詳細資料的所有索引結構描述。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
僅具有整合向量的索引
|
onlyIntegratedVectorIndexes | boolean |
如果為true，則只會傳回具有整合向量的索引。 |
傳回
- response
- array of Object
取得索引統計資料
此作業會取得 Azure AI 搜尋服務中索引的統計資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
索引名稱
|
indexName | True | string |
索引名稱。 |
傳回
- response
- object
合併文件
合併單一文件。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
索引名稱
|
indexName | True | string |
索引名稱。 |
搜尋向量
帶有過濾器的單一向量搜尋。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
索引名稱
|
indexName | True | string |
索引名稱。 |
|
向量欄位和值搜尋向量欄位名稱
|
vectorFieldsName | True | string |
搜尋向量欄位名稱。 |
|
向量欄位值
|
vectorFieldsValue | True | array of float | |
|
要返回的最近鄰數
|
nearestNeighbors | True | integer |
要傳回的最近鄰居數目。 |
|
搜尋
|
searchQuery | string |
搜尋查詢條件 |
|
|
搜尋模式
|
searchMode | string |
搜尋模式 |
|
|
篩選條件
|
filterCondition | string |
在尋找最近鄰點之前要套用的篩選條件。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
|
array of string |
索引多份文件
索引文件
自然語言搜尋向量
使用自然語言搜尋向量。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
索引名稱
|
indexName | True | string |
索引名稱。 |
|
搜尋文字
|
searchText | string |
搜尋文字 |
|
|
向量化搜尋欄位
|
vectorizedSearchFields | array of string |
向量化搜尋欄位 |
|
|
選取欄位
|
selectFields | array of string |
選取欄位 |
|
|
篩選條件
|
filterCondition | string |
篩選條件 |
|
|
SessionId（會話識別碼）
|
sessionId | string |
SessionId（會話識別碼） |
|
|
最近鄰居
|
nearestNeighbors | integer |
最近鄰居 |
|
|
熱門搜尋
|
top | integer |
熱門搜尋 |
|
|
略過搜尋
|
skipSearches | integer |
略過搜尋 |
傳回
- response
- array of Object
語意混合搜尋
具有篩選器的語意混合式搜尋。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
索引名稱
|
indexName | True | string |
索引名稱。 |
|
搜尋文字
|
searchText | string |
搜尋文字 |
|
|
向量化搜尋欄位
|
vectorizedSearchFields | array of string |
向量化搜尋欄位 |
|
|
語意組態
|
semanticConfiguration | string |
語意組態 |
|
|
選取欄位
|
selectFields | array of string |
選取欄位 |
|
|
篩選條件
|
filterCondition | string |
篩選條件 |
|
|
SessionId（會話識別碼）
|
sessionId | string |
SessionId（會話識別碼） |
|
|
最近鄰居
|
nearestNeighbors | integer |
最近鄰居 |
|
|
熱門搜尋
|
top | integer |
熱門搜尋 |
|
|
略過搜尋
|
skipSearches | integer |
略過搜尋 |
傳回
- response
- array of Object
定義
物體
AgenticRetrievalOutput
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
response
|
response | array of AgenticRetrievalOutput_Response | |
|
活動
|
activity | array of AgenticRetrievalOutput_Activity | |
|
引用
|
references | array of AgenticRetrievalOutput_References |
AgenticRetrievalOutput_Response
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
代理訊息回應角色
|
role | string |
代理訊息回應角色 |
|
內容
|
content | array of AgenticRetrievalOutput_Response_Content |
AgenticRetrievalOutput_Response_Content
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
代理訊息回應類型
|
type | string |
代理訊息回應類型 |
|
代理訊息回應文字
|
text | array of object |
代理訊息回應文字 |
|
項目
|
text | object |
AgenticRetrievalOutput_Activity
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
代理訊息活動
|
type | string |
代理訊息活動 |
|
代理訊息識別碼
|
id | string |
代理訊息識別碼 |
|
代理訊息輸入標記
|
inputTokens | string |
代理訊息輸入標記 |
|
代理訊息輸出令牌
|
outputTokens | string |
代理訊息輸出令牌 |
|
代理訊息目標索引
|
targetIndex | string |
代理訊息目標索引 |
|
代理訊息搜尋查詢
|
query.search | string |
代理訊息搜尋查詢 |
|
代理訊息查詢過濾器
|
query.filter | string |
代理訊息查詢過濾器 |
|
代理訊息查詢時間
|
queryTime | string |
代理訊息查詢時間 |
|
代理訊息計數
|
count | string |
代理訊息計數 |
AgenticRetrievalOutput_References
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
代理訊息參考類型
|
type | string |
代理訊息參考類型 |
|
代理訊息參考編號
|
id | string |
代理訊息參考編號 |
|
代理訊息參考活動來源
|
activitySource | string |
代理訊息參考活動來源 |
|
代理訊息參考文件金鑰
|
docKey | string |
代理訊息參考文件金鑰 |
|
代理訊息參考來源資料
|
sourceData | string |
代理訊息參考來源資料 |
物件
這是類型 'object'。