Azure - Foundry IQ
Azure AI 検索を利用して Foundry IQ ナレッジ ベースに接続します。 Foundry IQ は、Azure、SharePoint、OneLake、および Web 全体で、組織のデータから引用されたアクセス許可に対応した応答をエージェントに提供するマネージド ナレッジ レイヤーです。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Standard | すべての地域 Power Automate |
| ロジック アプリ | Standard | すべての Logic Apps リージョン |
| Power Apps | Standard | すべての Power Apps リージョン |
| Power Automate（パワーオートメート） | Standard | すべての地域 Power Automate |
| 連絡先 | |
|---|---|
| 名前 | Microsoft |
| URL | https://support.microsoft.com/ |
| abapi@microsoft.com |
| コネクタ メタデータ | |
|---|---|
| 発行者 | Microsoft |
| ウェブサイト | https://learn.microsoft.com/en-us/azure/search/ |
| プライバシー ポリシー | https://privacy.microsoft.com/en-us/privacystatement |
| カテゴリ | AI |
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| API キー | Foundry IQ 検索サービスにアクセスするための API キーを指定します。 | すべてのリージョン | 共有可能 |
| クライアント証明書の認証 | PFX 証明書とパスワードを使用してMicrosoft Entra ID資格情報を指定します。 | すべてのリージョン | 共有可能 |
| マネージド ID | マネージド ID を使用して接続を作成します。 | LOGICAPPS のみ | 共有可能 |
| Microsoft Entra ID 統合 | Microsoft Entra IDを使用して Foundry IQ 検索サービスにアクセスします。 | すべてのリージョン | 共有不可 |
| サービス プリンシパル (Microsoft Entra ID アプリケーション) | foundry IQ 検索サービスにアクセスするには、Microsoft Entra ID アプリケーションを使用します。 | すべてのリージョン | 共有不可 |
| 既定 [非推奨] | このオプションは、明示的な認証の種類がない古い接続に対してのみ行われ、下位互換性のためにのみ提供されます。 | すべてのリージョン | 共有不可 |
API キー
認証 ID: apiKeyAuth
適用対象: すべてのリージョン
Foundry IQ 検索サービスにアクセスするための API キーを指定します。
これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs
| 名前 | タイプ | 説明 | 必須 |
|---|---|---|---|
| Foundry IQ Search Service エンドポイント | 文字列 | Azure AI 検索 エンドポイント | 正しい |
| Foundry IQ Search Service API キー | securestring | Azure AI 検索 API キー | 正しい |
クライアント証明書認証
認証 ID: certOauth
適用対象: すべてのリージョン
PFX 証明書とパスワードを使用してMicrosoft Entra ID資格情報を指定します。
これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs
| 名前 | タイプ | 説明 | 必須 |
|---|---|---|---|
| Foundry IQ Search Service エンドポイント | 文字列 | Azure AI 検索 エンドポイント | 正しい |
| Tenant | 文字列 | 正しい | |
| クライアント ID | 文字列 | Microsoft Entra ID アプリケーションのクライアント ID | |
| クライアント証明書シークレット | クライアント証明書 | このアプリケーションで許可されるクライアント証明書シークレット | 正しい |
マネージド ID
認証 ID: managedIdentityAuth
適用: LOGICAPPS のみ
マネージド ID を使用して接続を作成します。
これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs
| 名前 | タイプ | 説明 | 必須 |
|---|---|---|---|
| マネージド ID | managedIdentity | マネージド ID を使用したサインイン | 正しい |
| Foundry IQ Search Service エンドポイント | 文字列 | Azure AI 検索 エンドポイント | 正しい |
Microsoft Entra ID 統合
認証 ID: oauth
適用対象: すべてのリージョン
Microsoft Entra IDを使用して Foundry IQ 検索サービスにアクセスします。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | 説明 | 必須 |
|---|---|---|---|
| Foundry IQ Search Service エンドポイント | 文字列 | Azure AI 検索 エンドポイント | 正しい |
サービス プリンシパル (Microsoft Entra ID アプリケーション)
認証 ID: oauthSP
適用対象: すべてのリージョン
foundry IQ 検索サービスにアクセスするには、Microsoft Entra ID アプリケーションを使用します。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | 説明 | 必須 |
|---|---|---|---|
| Foundry IQ Search Service エンドポイント | 文字列 | Azure AI 検索 エンドポイント | 正しい |
| Tenant | 文字列 | 正しい | |
| クライアント ID | 文字列 | 正しい | |
| クライアント シークレット | securestring | 正しい |
既定 [非推奨]
適用対象: すべてのリージョン
このオプションは、明示的な認証の種類がない古い接続に対してのみ行われ、下位互換性のためにのみ提供されます。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | 説明 | 必須 |
|---|---|---|---|
| Foundry IQ Search Service エンドポイント | 文字列 | Azure AI 検索 エンドポイント | 正しい |
| Foundry IQ Search Service API キー | securestring | Azure AI 検索 API キー | 正しい |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 5000 | 60 秒 |
アクション
| Foundry IQ Knowledge Retrieval API (非推奨) [非推奨] |
Foundry IQ ナレッジ ベースの取得をMicrosoftします。 Foundry IQ ナレッジ ベースを使用してエージェントを接地し、高品質で消費ベースの取得を行い、アクセス許可に対応した、引用された応答を提供します。 (deprecated) |
| Foundry IQ Knowledge Retrieval MCP |
Microsoft MCP プロトコルを使用した Foundry IQ ナレッジ ベースの取得。 Foundry IQ ナレッジ ベースを使用してエージェントを接地し、高品質で消費ベースの取得を行い、アクセス許可に対応した、引用された応答を提供します。 |
Foundry IQ Knowledge Retrieval API (非推奨) [非推奨]
Foundry IQ ナレッジ ベースの取得をMicrosoftします。 Foundry IQ ナレッジ ベースを使用してエージェントを接地し、高品質で消費ベースの取得を行い、アクセス許可に対応した、引用された応答を提供します。 (deprecated)
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ナレッジ ベース名
|
knowledgeBaseName | True | string |
クエリを実行する Foundry IQ ナレッジ ベースの名前。 |
|
API バージョン
|
api-version | True | string |
Azure AI 検索 ナレッジ ベース サービスの API バージョン。 |
|
クエリ ソース承認トークン
|
x-ms-query-source-authorization | string |
ドキュメント レベルの承認のためにAzure AI 検索に渡されるユーザー トークン。 |
|
|
ロール
|
role | string |
メッセージの送信者のロール (例: "user"、"assistant")。 |
|
|
型
|
type | string |
コンテンツの種類 (例: "text")。 |
|
|
SMS 送信
|
text | string |
メッセージのテキスト コンテンツ。 |
返品
- Body
- RetrieveResponse
Foundry IQ Knowledge Retrieval MCP
Microsoft MCP プロトコルを使用した Foundry IQ ナレッジ ベースの取得。 Foundry IQ ナレッジ ベースを使用してエージェントを接地し、高品質で消費ベースの取得を行い、アクセス許可に対応した、引用された応答を提供します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ナレッジ ベース名
|
knowledgeBaseName | True | string |
クエリを実行する Foundry IQ ナレッジ ベースの名前。 |
|
API バージョン
|
api-version | True | string |
Azure AI 検索 ナレッジ ベース サービスの API バージョン。 |
定義
RetrieveResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
response
|
response | array of RetrieveResponseItem |
ナレッジ ベースから引用されたコンテンツを含む取得応答。 |
|
アクティビティ
|
activity | array of RetrieveActivity |
クエリ計画、検索インデックス呼び出し、および推論手順を示すアクティビティ ログ。 |
|
references
|
references | array of RetrieveReference |
関連性スコアとメタデータを含むソース ドキュメント参照。 |
RetrieveResponseItem
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
コンテンツ
|
content | array of object |
応答内のコンテンツ項目。 |
|
型
|
content.type | string |
コンテンツの種類 (例: "text")。 |
|
SMS 送信
|
content.text | string |
ナレッジ ベースから引用された結果を含む取得されたテキスト コンテンツ。 |
RetrieveActivity
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
型
|
type | string |
アクティビティの種類 (例: 'modelQueryPlanning'、'searchIndex'、'agenticReasoning')。 |
|
id
|
id | integer |
アクティビティ ステップ識別子。 |
|
knowledgeSourceName
|
knowledgeSourceName | string |
クエリを実行したナレッジ ソースの名前。 |
|
elapsedMs
|
elapsedMs | integer |
このアクティビティ ステップの経過時間 (ミリ秒単位)。 |
|
inputTokens
|
inputTokens | integer |
モデル クエリ計画手順で使用された入力トークンの数。 |
|
outputTokens
|
outputTokens | integer |
モデル クエリ計画手順で生成された出力トークンの数。 |
|
queryTime
|
queryTime | date-time |
検索インデックス クエリが実行されたときのタイムスタンプ。 |
|
count
|
count | integer |
検索インデックス クエリから返された結果の数。 |
|
searchIndexArguments
|
searchIndexArguments | SearchIndexArguments |
検索インデックス クエリに渡される引数。 |
|
種類
|
retrievalReasoningEffort.kind | string |
適用された推論作業のレベル (例: "low"、"medium"、"high")。 |
|
reasoningTokens
|
reasoningTokens | integer |
エージェント推論手順で使用されたトークンの数。 |
SearchIndexArguments
検索インデックス クエリに渡される引数。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
検索
|
search | string |
インデックスに送信される検索クエリ テキスト。 |
|
フィルタ
|
filter | string |
検索クエリに適用される OData フィルター式。 |
|
sourceDataFields
|
sourceDataFields | array of object |
検索インデックスから要求されたソース データ フィールド。 |
|
name
|
sourceDataFields.name | string |
ソース データ フィールドの名前。 |
|
検索フィールド
|
searchFields | array of string |
インデックス内で検索する特定のフィールド。 |
|
semanticConfigurationName
|
semanticConfigurationName | string |
ランク付けに使用されるセマンティック構成の名前。 |
RetrieveReference
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
型
|
type | string |
参照型 (例: 'searchIndex')。 |
|
id
|
id | string |
参照識別子。 |
|
activitySource
|
activitySource | integer |
この参照を生成したアクティビティ ステップ識別子。 |
|
sourceData
|
sourceData | object |
参照に関連付けられている追加のソース データ。 |
|
docKey
|
docKey | string |
検索インデックス内のソース ドキュメント キー。 |
|
title
|
title | string |
参照先のソース ドキュメントのタイトル。 |
|
rerankerScore
|
rerankerScore | float |
この参照のセマンティック リランカーの関連性スコア。 |