Fabric Data Agent ナレッジソースを作成する (プレビュー)

Note

Azure AI 検索は、Azure ポータル、REST API、およびAzure SDKから使用できます。また、Foundry IQ は、エンタープライズコンテンツを、Microsoft Foundry ポータルのエージェントの再利用可能なアクセス許可に対応したナレッジベースに変換するマネージドナレッジレイヤーです。

Important

これらの機能は、2026-05-01-preview REST API の一部です。 2026-05-01-preview は、お客様の Azure サブスクリプションの一部としてお客様にライセンス供与されるものであり、Microsoft Product Terms における「Previews」に適用される条件、Microsoft Products and Services Data Protection Addendum（「DPA」）、および Supplemental Terms of Use for Microsoft Azure Previews に従うものとします。

2026-05-01-preview では、他のMicrosoft サービスやサードパーティのサービスへの接続がサポートされています。これらのサービスの利用は各サービスの利用規約に従うものとし、データが Azure コンプライアンス境界の外部で処理または保存されたり、Azure コンプライアンス境界内に流入したりする場合があります。

Fabric IQ に接続すると、コストが発生する可能性があり、データがAzureコンプライアンス境界の外に送信され、該当するサービス条件とデータ処理ポリシーに従って処理される可能性があります。データが組織のコンプライアンスと地理的境界の外部に流れるかどうか、および関連する影響、および適切なアクセス許可、境界、承認がプロビジョニングされるかどうかを管理するのは、お客様の責任です。

特定のユースケースのコンテキストで構築したアプリケーションを慎重に確認およびテストし、すべての適切な決定とカスタマイズを行う責任があります。これには、メタプロンプト、コンテンツフィルター、その他の安全システムなどの独自の責任ある AI 軽減策の実装や、アプリケーションが適切な品質、信頼性、セキュリティ、信頼性の標準を満たしていることを確認する機能が含まれます。詳細については、「Azure AI 検索透過性に関するメモを参照してください。

Fabric Data Agent ナレッジソース (プレビュー) は、Microsoft Fabric Data Agent をAzure AI 検索のエージェント取得パイプラインに接続します。ナレッジソースは個別に作成され、ナレッジベースで参照され、実行時にナレッジベースのクエリが実行されるときに、グラウンドデータとして使用されます。

データエージェントは仮想アナリストとして機能し、Microsoft Fabric データに対してクエリを生成して実行し、自然言語の回答、テーブル、グラフを返します。これにより、Fabricデータエージェントのナレッジソースは、チャーンの多いデータや分析クエリに役立ちます。

インデックス付きナレッジソースとは異なり、Fabric Data Agent ナレッジソースは、取得時にライブデータに直接クエリを実行します。インジェストパイプラインは必要ありません。クエリには、エンドユーザーの代わりに Fabric データエージェントのクエリを実行するために取得エンジンが使用するエンドユーザーアクセストークンが必要です。

使用サポート

Azure Portal	Microsoft Foundry ポータル	.NET SDK	Python SDK	Java SDK	JavaScript SDK	REST API
❌	✔️	✔️	✔️	✔️	✔️	✔️

Prerequisites

エージェント検索を提供する任意のリージョンの Azure AI 検索サービス。
data エージェントを持つMicrosoft Fabric ワークスペース。
検索サービスとワークスペースは、同じMicrosoft Entra ID テナント内にある必要があります。
ナレッジソースを作成する権限。ユーザーアカウントに割り当てられた Search Service 共同作成者ロール (推奨) を使用してキーレス認証を構成するか、API キーを使用します。

最新の Azure.Search.Documents プレビューパッケージ: dotnet add package Azure.Search.Documents --prerelease

最新の azure-search-documents プレビューパッケージ: pip install --pre azure-search-documents

Search Service REST API の 2026-05-01-preview バージョン。

データガバナンスとコンプライアンス

Fabric IQ は、ワークスペースのリージョンのMicrosoft Fabricコンプライアンス境界内で要求を処理します。次のコミットメントは、Fabric IQ を介してエージェントクエリをルーティングする場合に適用されます。

データの保存場所

Fabric IQ は、Microsoft Fabric ワークスペースが存在するリージョン内のデータを取得して処理します。データは、クエリの実行中にリージョンの境界を越えません。該当するリージョンとそのコンプライアンススコープは、ワークスペースの場所によって決まります。サポートされているリージョンの一覧と各リージョンが満たすコンプライアンスフレームワークについては、Microsoft Fabric リージョンの可用性を参照してください。

Note

Azure AI 検索サービスが Fabric ワークスペースとは異なるAzure リージョンにある場合、クエリ結果はリージョン間で返されます。 Microsoft Fabricリージョンの可用性と組織のデータ所在地の要件を確認してから、別のリージョンのFabric ワークスペースに接続します。

コンプライアンス認定

Fabric IQ は、ワークスペースリージョンのMicrosoft Fabricのコンプライアンス認定を継承します。コンプライアンスドキュメント、監査レポート、および各リージョンに適用されるフレームワークについては、Microsoft Fabricリージョンの可用性を参照してください。

既存のナレッジソースを確認する

ナレッジソースは、最上位の再利用可能なオブジェクトです。既存のナレッジソースについて知ることは、新しいオブジェクトを再利用または名前付けする場合に役立ちます。

次のコードを実行して、名前と種類でナレッジソースを一覧表示します。

// List knowledge sources by name and type
using Azure.Search.Documents.Indexes;

var indexClient = new SearchIndexClient(new Uri(searchEndpoint), credential);
var knowledgeSources = indexClient.GetKnowledgeSourcesAsync();

Console.WriteLine("Knowledge Sources:");

await foreach (var ks in knowledgeSources)
{
    Console.WriteLine($"  Name: {ks.Name}, Type: {ks.GetType().Name}");
}

Reference:SearchIndexClient

# List knowledge sources by name and type
from azure.core.credentials import AzureKeyCredential
from azure.search.documents.indexes import SearchIndexClient

index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))

for ks in index_client.list_knowledge_sources():
    print(f"  - {ks.name} ({ks.kind})")

Reference:SearchIndexClient

### List knowledge sources by name and type
GET {{search-url}}/knowledgesources?api-version={{api-version}}&$select=name,kind
Authorization: Bearer {{token}}

リファレンス:ナレッジソース - リスト

名前で 1 つのナレッジソースを返して、その JSON 定義を確認することもできます。

using Azure.Search.Documents.Indexes;
using System.Text.Json;

var indexClient = new SearchIndexClient(new Uri(searchEndpoint), credential);

// Specify the knowledge source name to retrieve
string ksNameToGet = "earth-knowledge-source";

// Get its definition
var knowledgeSourceResponse = await indexClient.GetKnowledgeSourceAsync(ksNameToGet);
var ks = knowledgeSourceResponse.Value;

// Serialize to JSON for display
var jsonOptions = new JsonSerializerOptions 
{ 
    WriteIndented = true,
    DefaultIgnoreCondition = System.Text.Json.Serialization.JsonIgnoreCondition.Never
};
Console.WriteLine(JsonSerializer.Serialize(ks, ks.GetType(), jsonOptions));

Reference:SearchIndexClient

# Get a knowledge source definition
from azure.core.credentials import AzureKeyCredential
from azure.search.documents.indexes import SearchIndexClient
import json

index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))

ks = index_client.get_knowledge_source("knowledge_source_name")
print(json.dumps(ks.as_dict(), indent = 2))

Reference:SearchIndexClient

### Get a knowledge source definition
GET {{search-url}}/knowledgesources/{{knowledge-source-name}}?api-version={{api-version}}
Authorization: Bearer {{token}}

リファレンス:ナレッジソース - 取得

次の JSON は、Fabric Data Agent のナレッジソースに対する応答の例です。

{
  "name": "my-fabric-data-agent-ks",
  "kind": "fabricDataAgent",
  "description": "A Fabric Data Agent knowledge source.",
  "encryptionKey": null,
  "fabricDataAgentParameters": {
    "workspaceId": "00000000-0000-0000-0000-000000000000",
    "dataAgentId": "00000000-0000-0000-0000-000000000001"
  }
}

ナレッジソースを作成する

次のコードを実行して、Fabric Data Agent ナレッジソースを作成します。

using Azure;
using Azure.Search.Documents.Indexes;
using Azure.Search.Documents.Indexes.Models;

Uri searchEndpoint = new Uri("<search-service-url>");
AzureKeyCredential credential = new AzureKeyCredential("<api-key>");
var indexClient = new SearchIndexClient(searchEndpoint, credential);

var fabricDataAgent = new FabricDataAgentKnowledgeSource(
    "<knowledge-source-name>",
    new FabricDataAgentKnowledgeSourceParameters("<fabric-workspace-id>", "<fabric-data-agent-id>"))
{
    Description = "A Fabric Data Agent knowledge source."
};

await indexClient.CreateOrUpdateKnowledgeSourceAsync(fabricDataAgent);

Reference:SearchIndexClient

from azure.core.credentials import AzureKeyCredential
from azure.search.documents.indexes import SearchIndexClient
from azure.search.documents.indexes.models import (
    FabricDataAgentKnowledgeSource,
    FabricDataAgentKnowledgeSourceParameters,
)

index_client = SearchIndexClient(
    endpoint="<search-service-url>",
    credential=AzureKeyCredential("<api-key>")
)

knowledge_source = FabricDataAgentKnowledgeSource(
    name="<knowledge-source-name>",
    description="A Fabric Data Agent knowledge source.",
    fabric_data_agent_parameters=FabricDataAgentKnowledgeSourceParameters(
        workspace_id="<fabric-workspace-id>",
        data_agent_id="<fabric-data-agent-id>"
    )
)

index_client.create_or_update_knowledge_source(knowledge_source)

Reference:SearchIndexClient

### Create a Fabric Data Agent knowledge source
PUT {{search-url}}/knowledgesources/my-fabric-data-agent-ks?api-version=2026-05-01-preview
api-key: {{api-key}}
Content-Type: application/json

{
  "name": "my-fabric-data-agent-ks",
  "kind": "fabricDataAgent",
  "description": "A Fabric Data Agent knowledge source.",
  "fabricDataAgentParameters": {
    "workspaceId": "{fabric-workspace-id}",
    "dataAgentId": "{fabric-data-agent-id}"
  }
}

リファレンス:ナレッジソース - 作成または更新

ナレッジベースに割り当てる

ナレッジソースに満足している場合は、ナレッジベースに追加します。

Important

Fabric Data Agent のナレッジソースでは、minimal検索推論機能はサポートされていません。代わりに、low タグまたは medium タグを使用してください。

ナレッジベースのクエリを実行する

ナレッジベースが構成されたら、Fabric データエージェントのコンテンツを照会するために、取得アクションまたは MCP エンドポイントを呼び出します。このナレッジソースには、クエリ時のアクセス許可の適用と応答の特性が固有です。

クエリ時にアクセス許可を適用する

Fabric Data Agent のサポート情報ソースでは、代理 (OBO) トークンフローが使用されます。取得要求の x-ms-query-source-authorization ヘッダーにエンドユーザーアクセストークンを渡します。トークンのスコープは、Azure AI 検索対象ユーザー (https://search.azure.com/.default) にする必要があります。取得エンジンは、このトークンをMicrosoft Fabricスコープトークンと交換し、それを使用してエンドユーザーに代わってFabricデータエージェントにクエリを実行します。

取得要求では、標準Azure AI 検索認証も必要です。 x-ms-query-source-authorization トークンは個別に渡され、サービス認証に代わることはありません。

トークンを渡す手順については、「クエリ時にアクセス許可を適用する (プレビュー)」を参照してください。

Fabric Data Agent 固有の応答フィールド

Fabric Data Agent のナレッジソースは、結果を各 sourceData エントリの references オブジェクトに返し、クエリ診断を activity 配列に返します。 sourceData 含む：

fabricAnswer: データエージェントの自然言語の回答。
fabricEmbeddedResources: クエリで構造化された出力が生成されるときに、テーブルやグラフなどの埋め込みリソース。

次の例は、Fabric Data Agent ナレッジソース参照とそれに対応するアクティビティレコードを含む取得応答を示しています。応答の取得の解釈に関するより広範なガイダンスについては、応答の確認を参照してください。

Tip

参照のsourceDataを受信するには、includeReferenceSourceDataを取得要求のtrue内のナレッジソースエントリのknowledgeSourceParamsに設定します。

{
  "response": [
      // ... Response omitted for brevity
  ],
  "activity": [
    {
      "type": "fabricDataAgent",
      "id": 1,
      "knowledgeSourceName": "my-fabric-data-agent-ks",
      "queryTime": "2026-05-11T19:37:11.600Z",
      "count": 1,
      "fabricDataAgentArguments": {
        "search": "my query"
      }
    },
    {
      // ... Additional activity records omitted for brevity 
    }
  ],
  "references": [
    {
      "type": "fabricDataAgent",
      "id": "0",
      "activitySource": 1,
      "rerankerScore": 2.57,
      "workspaceId": "00000000-0000-0000-0000-000000000000",
      "dataAgentId": "00000000-0000-0000-0000-000000000001",
      "sourceData": {
        "fabricAnswer": "There were 47 airline delays in Q1 2026. The majority occurred on transcontinental routes.",
        "fabricEmbeddedResources": [
          {
            "title": "Q1 2026 Airline Operations Report",
            "mimeType": "text/csv",
            "content": "Route | Delays | Avg. Delay (min)\n--- | --- | ---\nJFK–LAX | 18 | 42\nORD–MIA | 12 | 31"
          }
        ]
      }
    },
    {
      // ... Additional references omitted for brevity 
    }
  ]
}

ナレッジソースを削除する

ナレッジソースを削除する前に、ナレッジソースを参照するすべてのナレッジベースを削除するか、ナレッジベース定義を更新して参照を削除する必要があります。インデックスとインデクサーパイプラインを生成するナレッジソースの場合、 生成されたすべてのオブジェクト も削除されます。ただし、既存のインデックスを使用してナレッジソースを作成した場合、インデックスは削除されません。

使用中のナレッジソースを削除しようとすると、アクションは失敗し、影響を受けるナレッジベースの一覧が返されます。

ナレッジソースを削除するには:

検索サービスのすべてのナレッジベースの一覧を取得します。

using Azure.Search.Documents.Indexes;

var indexClient = new SearchIndexClient(new Uri(searchEndpoint), credential);
var knowledgeBases = indexClient.GetKnowledgeBasesAsync();

Console.WriteLine("Knowledge Bases:");

await foreach (var kb in knowledgeBases)
{
    Console.WriteLine($"  - {kb.Name}");
}

Reference:SearchIndexClient

応答の例は次のようになります。

 {
     "@odata.context": "https://my-search-service.search.windows.net/$metadata#knowledgebases(name)",
     "value": [
     {
         "name": "my-kb"
     },
     {
         "name": "my-kb-2"
     }
     ]
 }

個別のナレッジベース定義を取得して、ナレッジソースの参照を確認する。

using Azure.Search.Documents.Indexes;
using System.Text.Json;

var indexClient = new SearchIndexClient(new Uri(searchEndpoint), credential);

// Specify the knowledge base name to retrieve
string kbNameToGet = "earth-knowledge-base";

// Get a specific knowledge base definition
var knowledgeBaseResponse = await indexClient.GetKnowledgeBaseAsync(kbNameToGet);
var kb = knowledgeBaseResponse.Value;

// Serialize to JSON for display
string json = JsonSerializer.Serialize(kb, new JsonSerializerOptions { WriteIndented = true });
Console.WriteLine(json);

Reference:SearchIndexClient

応答の例は次のようになります。

 {
   "Name": "earth-knowledge-base",
   "KnowledgeSources": [
     {
       "Name": "earth-knowledge-source"
     }
   ],
   "Models": [
     {}
   ],
   "RetrievalReasoningEffort": {},
   "OutputMode": {},
   "ETag": "\u00220x8DE278629D782B3\u0022",
   "EncryptionKey": null,
   "Description": null,
   "RetrievalInstructions": null,
   "AnswerInstructions": null
 }

ナレッジベースを削除するか、複数のナレッジソースがある場合は、ナレッジベースを更新してソースを削除します。この例では、削除を示します。

using Azure.Search.Documents.Indexes;
var indexClient = new SearchIndexClient(new Uri(searchEndpoint), credential);

await indexClient.DeleteKnowledgeBaseAsync(knowledgeBaseName);
System.Console.WriteLine($"Knowledge base '{knowledgeBaseName}' deleted successfully.");

Reference:SearchIndexClient

ナレッジソースを削除します。

await indexClient.DeleteKnowledgeSourceAsync(knowledgeSourceName);
System.Console.WriteLine($"Knowledge source '{knowledgeSourceName}' deleted successfully.");

Reference:SearchIndexClient

検索サービスのすべてのナレッジベースの一覧を取得します。

# Get knowledge bases
from azure.core.credentials import AzureKeyCredential
from azure.search.documents.indexes import SearchIndexClient

index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))

print("Knowledge Bases:")
for kb in index_client.list_knowledge_bases():
    print(f"  - {kb.name}")

Reference:SearchIndexClient

応答の例は次のようになります。

 {
     "@odata.context": "https://my-search-service.search.windows.net/$metadata#knowledgebases(name)",
     "value": [
     {
         "name": "my-kb"
     },
     {
         "name": "my-kb-2"
     }
     ]
 }

個別のナレッジベース定義を取得して、ナレッジソースの参照を確認する。

# Get a knowledge base definition
from azure.core.credentials import AzureKeyCredential
from azure.search.documents.indexes import SearchIndexClient

index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))
kb = index_client.get_knowledge_base("knowledge_base_name")
print(kb)

Reference:SearchIndexClient

応答の例は次のようになります。

 {
   "name": "my-kb",
   "description": null,
   "retrievalInstructions": null,
   "answerInstructions": null,
   "outputMode": null,
   "knowledgeSources": [
     {
       "name": "my-blob-ks"
     }
   ],
   "models": [],
   "encryptionKey": null,
   "retrievalReasoningEffort": {
     "kind": "low"
   }
 }

# Delete a knowledge base
from azure.core.credentials import AzureKeyCredential 
from azure.search.documents.indexes import SearchIndexClient

index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))
index_client.delete_knowledge_base("knowledge_base_name")
print(f"Knowledge base deleted successfully.")

Reference:SearchIndexClient

ナレッジソースを削除します。

# Delete a knowledge source
from azure.core.credentials import AzureKeyCredential 
from azure.search.documents.indexes import SearchIndexClient

index_client = SearchIndexClient(endpoint = "search_url", credential = AzureKeyCredential("api_key"))
index_client.delete_knowledge_source("knowledge_source_name")
print(f"Knowledge source deleted successfully.")

Reference:SearchIndexClient

検索サービスのすべてのナレッジベースの一覧を取得します。

### Get knowledge bases
GET {{search-url}}/knowledgebases?api-version={{api-version}}&$select=name
Authorization: Bearer {{token}}

リファレンス:ナレッジベース - リスト

応答の例は次のようになります。

 {
     "@odata.context": "https://my-search-service.search.windows.net/$metadata#knowledgebases(name)",
     "value": [
     {
         "name": "my-kb"
     },
     {
         "name": "my-kb-2"
     }
     ]
 }

個別のナレッジベース定義を取得して、ナレッジソースの参照を確認する。

### Get a knowledge base definition
GET {{search-url}}/knowledgebases/{{knowledge-base-name}}?api-version={{api-version}}
Authorization: Bearer {{token}}

リファレンス:ナレッジベース - 取得

応答の例は次のようになります。

 {
   "name": "my-kb",
   "description": null,
   "retrievalInstructions": null,
   "answerInstructions": null,
   "outputMode": null,
   "knowledgeSources": [
     {
       "name": "my-blob-ks"
     }
   ],
   "models": [],
   "encryptionKey": null,
   "retrievalReasoningEffort": {
     "kind": "low"
   }
 }

ナレッジベースを削除するか、複数のナレッジソースがある場合は、ナレッジベースを更新してソースを削除します。この例では、削除を示します。
```
### Delete a knowledge base
DELETE {{search-url}}/knowledgebases/{{knowledge-base-name}}?api-version={{api-version}}
Authorization: Bearer {{token}}
```
リファレンス:ナレッジベース - 削除

ナレッジソースを削除します。

### Delete a knowledge source
DELETE {{search-url}}/knowledgesources/{{knowledge-source-name}}?api-version={{api-version}}
Authorization: Bearer {{token}}

リファレンス:ナレッジソース - 削除

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-06-29

Fabric Data Agent ナレッジ ソースを作成する (プレビュー)

使用サポート

Prerequisites

データ ガバナンスとコンプライアンス

データの保存場所

コンプライアンス認定

既存のナレッジ ソースを確認する

ナレッジ ソースを作成する

ナレッジ ベースに割り当てる

ナレッジ ベースのクエリを実行する

クエリ時にアクセス許可を適用する

Fabric Data Agent 固有の応答フィールド

ナレッジ ソースを削除する

関連するコンテンツ

フィードバック

その他のリソース

Fabric Data Agent ナレッジソースを作成する (プレビュー)

データガバナンスとコンプライアンス

既存のナレッジソースを確認する

ナレッジソースを作成する

ナレッジベースに割り当てる

ナレッジベースのクエリを実行する

ナレッジソースを削除する