Microsoft Fabric データ エージェントを使用する (プレビュー)

Microsoft Fabric ツールをエージェントに追加するには、この記事の上部または Azure AI Foundry ポータルに記載されているコード例を使用します。 ポータルを使用する場合:

1. Azure AI Foundry のエージェントの [エージェント] 画面に移動し、右側の [セットアップ] ウィンドウを下にスクロールしてナレッジを取得します。 その後、追加を選択します。

   

2. Microsoft Fabric を選択し、指示に従ってツールを追加します。 エージェントごとに追加できるのは 1 つだけです。

3. クリックして新しい接続を追加します。 接続を追加したら、既存の一覧から直接選択できます。

   1. 新しい接続を作成するには、発行された Fabric データ エージェント エンドポイントで workspace-id と artifact-id を見つける必要があります。 Fabric データ エージェント エンドポイントは次のようになります。 https://<environment>.fabric.microsoft.com/groups/<workspace_id>/aiskills/<artifact-id>

   2. その後、両方を接続に追加できます。 両方の is secret をオンにしていることを確認します

      

REST API クイック スタートに従って、環境変数のAGENT_TOKEN、AZURE_AI_FOUNDRY_PROJECT_ENDPOINT、API_VERSIONに適切な値を設定します。 API_VERSIONの場合は、2025-05-15-previewを使用していることを確認します。

Microsoft Fabric ツールを有効にしてエージェントを作成する

curl --request POST \
  --url $AZURE_AI_FOUNDRY_PROJECT_ENDPOINT/assistants?api-version=$API_VERSION \
  -H "Authorization: Bearer $AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "instructions": "You are a helpful agent.",
        "name": "my-agent",
        "model": "gpt-4o",
        "tools": [
          {
            "type": "fabric_dataagent",
            "fabric_dataagent": {
                "connections": [
                    {
                        "connection_id": "/subscriptions/<sub-id>/resourceGroups/<your-rg-name>/providers/Microsoft.CognitiveServices/accounts/<your-ai-services-name>/projects/<your-project-name>/connections/<your-fabric-connection-name>"
                    }
                ]
            }
          }
        ]
      }'

スレッドを作成する

スレッドを作成する

curl --request POST \
  --url $AZURE_AI_FOUNDRY_PROJECT_ENDPOINT/threads?api-version=$API_VERSION \
  -H "Authorization: Bearer $AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d ''

ユーザーの質問をスレッドに追加する

curl --request POST \
  --url $AZURE_AI_FOUNDRY_PROJECT_ENDPOINT/threads/thread_abc123/messages?api-version=$API_VERSION \
  -H "Authorization: Bearer $AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
      "role": "user",
      "content": "<question related to your data>"
    }'

実行を作成して出力を確認する

スレッドを実行する

curl --request POST \
  --url $AZURE_AI_FOUNDRY_PROJECT_ENDPOINT/threads/thread_abc123/runs?api-version=$API_VERSION \
  -H "Authorization: Bearer $AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "assistant_id": "asst_abc123",
  }'

実行の状態を取得する

curl --request GET \
  --url $AZURE_AI_FOUNDRY_PROJECT_ENDPOINT/threads/thread_abc123/runs/run_abc123?api-version=$API_VERSION \
  -H "Authorization: Bearer $AGENT_TOKEN"

エージェントの応答を取得する

curl --request GET \
  --url $AZURE_AI_FOUNDRY_PROJECT_ENDPOINT/threads/thread_abc123/messages?api-version=$API_VERSION \
  -H "Authorization: Bearer $AGENT_TOKEN"