Azure SRE エージェントの API リファレンス

Azure SRE エージェントをプログラムで管理および操作するための REST API 操作。

概要

Azure SRE エージェントは、2 つのレイヤーで REST API を提供します。 コントロール プレーン (ARM) を使用して、エージェントとそのサブリソースを作成、構成、および削除します。 チャット、リポジトリ管理、ナレッジのアップロードなどの実行時操作には、 データ プレーン を使用します。

Authentication

コントロール プレーン (ARM)

標準Azure認証 - Azure CLI、サービス プリンシパル、またはマネージド ID:

# Interactive login
az login

# Service principal
az login --service-principal -u $APP_ID -p $SECRET --tenant $TENANT_ID

# Managed identity (from Azure VM or Container App)
az login --identity

データ プレーン

データ プレーンには、対象ユーザー https://azuresre.devを含む別のトークンが必要です。

# Step 1: Get the agent's data plane endpoint
ENDPOINT=$(az rest -m GET \
  --url "https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.App/agents/{agentName}?api-version=2025-05-01-preview" \
  --query properties.agentEndpoint -o tsv)

# Step 2: Get a data plane token
TOKEN=$(az account get-access-token \
  --resource https://azuresre.dev \
  --query accessToken -o tsv)

# Step 3: Call the data plane
curl -H "Authorization: Bearer $TOKEN" "$ENDPOINT/api/v1/threads"

RBAC のロール

Azure ポータル、CLI、または ARM API を使用してロールを割り当てます。

az role assignment create \
  --assignee {userOrServicePrincipalId} \
  --role "SRE Agent Administrator" \
  --scope "/subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.App/agents/{name}"

コントロール プレーン (ARM) 操作

API バージョン

2025-05-01-preview

基準 URL

https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.App/agents/{agentName}

操作テーブルからパス サフィックスを追加し、クエリ パラメーターとして ?api-version=2025-05-01-preview を追加します。 たとえば、 .../agents/{agentName}/start?api-version=2025-05-01-previewと指定します。

エージェント リソース操作

エージェントのプロパティ

副リソース

すべてのサブリソースは、 PUT (作成/更新)、 GET、および DELETE 操作をサポートします。

サブリソース本文の形式

コネクタは直接プロパティを使用します 。

az rest -m PUT \
  --url "https://management.azure.com/subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.App/agents/{agent}/DataConnectors/my-kusto?api-version=2025-05-01-preview" \
  --body '{
    "properties": {
      "name": "my-kusto",
      "dataConnectorType": "Kusto",
      "dataSource": "https://mycluster.eastus2.kusto.windows.net",
      "identity": "system"
    }
  }'

その他のサブリソース (スキル、サブエージェント、ツールなど) では、base64 でエンコードされたエンベロープが使用されます。

# The spec is base64-encoded inside properties.value
SPEC='{"name":"my-tool","description":"Query Azure Resource Graph"}'
ENCODED=$(echo -n "$SPEC" | base64)

az rest -m PUT \
  --url "...Microsoft.App/agents/{agent}/tools/my-tool?api-version=2025-05-01-preview" \
  --body "{\"properties\":{\"value\":\"$ENCODED\"}}"

コネクタの種類

データプレーン操作

データ プレーン API を使用して、メッセージの送信、承認の管理、ナレッジのアップロード、リポジトリ、フック、トリガーの構成など、実行中のエージェントと対話します。

基準 URL

ARM から取得する:

ENDPOINT=$(az rest -m GET \
  --url "...Microsoft.App/agents/{name}?api-version=2025-05-01-preview" \
  --query properties.agentEndpoint -o tsv)

すべてのデータ プレーン パスは、 $ENDPOINT/api/...で始まります。

スレッドとチャット

承認

コード リポジトリ

ナレッジ (エージェント メモリ)

HTTP トリガー

フック

拡張エージェントの構成

データ プレーンを使用して、サブエージェント、ツール、コネクタ、スキル、プロンプト、プラグインを管理します。

すべてのリソースは、 PUT、 GET、 PATCH、および DELETE メソッドをサポートします。

リアルタイム ストリーミング

エージェントは、リアルタイム チャット ストリーミングに SignalR を使用します。

同じベアラー トークンを使用して SignalR クライアント ライブラリを使用して接続します。

例示

エージェントのプロパティを取得する

az rest -m GET \
  --url "https://management.azure.com/subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.App/agents/{name}?api-version=2025-05-01-preview" \
  -o json

すべてのコネクタを一覧表示する

az rest -m GET \
  --url "https://management.azure.com/subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.App/agents/{name}/DataConnectors?api-version=2025-05-01-preview" \
  -o json

データ プレーンを使用してスレッドを一覧表示する

TOKEN=$(az account get-access-token --resource https://azuresre.dev --query accessToken -o tsv)
ENDPOINT="https://{agentEndpoint}"

curl -s -H "Authorization: Bearer $TOKEN" "$ENDPOINT/api/v1/threads"

データ プレーンを使用してコード リポジトリを追加する

curl -X PUT \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  "$ENDPOINT/api/v2/repos/my-repo" \
  -d '{
    "properties": {
      "url": "https://github.com/myorg/myrepo",
      "type": "GitHub"
    }
  }'

関連するコンテンツ

• ARM テンプレート リファレンス: Microsoft Learn の完全なプロパティ スキーマ
• コードとしてのインフラストラクチャを使用してデプロイする: Bicep、Terraform、または PowerShell を使用してエージェントのデプロイを自動化する
• ネットワーク要件: API エンドポイントのファイアウォール許可リスト
• 価格と課金: API 駆動型操作のコスト