Microsoft.App エージェント

• 最新
• 2026-01-01

Bicep リソース定義

エージェントのリソースタイプは、以下の操作を対象に展開可能です:

• Resource groups - リソースグループのデプロイコマンド

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.App/agents リソースを作成するには、次のBicepをテンプレートに追加してください。

resource symbolicname 'Microsoft.App/agents@2026-01-01' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    actionConfiguration: {
      accessLevel: 'string'
      identity: 'string'
      mode: 'string'
    }
    agentIdentity: {
      initialSponsorGroupId: 'string'
    }
    agentSpaceId: 'string'
    defaultModel: {
      name: 'string'
      provider: 'string'
    }
    incidentManagementConfiguration: {
      connectionKey: 'string'
      connectionName: 'string'
      connectionUrl: 'string'
      oboUser: 'string'
      type: 'string'
    }
    knowledgeGraphConfiguration: {
      identity: 'string'
      managedResources: [
        'string'
      ]
    }
    logConfiguration: {
      applicationInsightsConfiguration: {
        appId: 'string'
        connectionString: 'string'
      }
    }
    upgradeChannel: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

プロパティ値

Microsoft.App/agents

名前	説明	価値
ID	このリソースに割り当てられているマネージド サービス ID。	ManagedServiceIdentity
位置	リソースが存在する地理的な場所	string (必須)
名前	リソース名	string 制約： パターン = ^[A-Za-z]([-A-Za-z0-9]{0,30}[A-Za-z0-9])$ (必須)
プロパティ	このリソースのリソース固有のプロパティ。	エージェントプロパティ
タグ	リソース タグ	タグ名と値のディクショナリ。 テンプレート の タグを参照してください

アクション構成

名前	説明	価値
accessLevel (アクセスレベル)	アクションのアクセスレベル	'High' 'Low'
ID	アクションが用いる恒等式	文字列
mode	作用様式	「自律的」 「読み取り専用」 『レビュー』

エージェントアイデンティティ

名前	説明	価値
イニシャルスポンサーグループID	初期スポンサーグループID(エージェント識別に必要)	string (必須)

エージェントプロパティ

名前	説明	価値
actionConfiguration	アクションの構成	アクション構成
agentIdentity	リソースへのアクセスのためのエージェント識別設定	エージェントアイデンティティ
agentSpaceId	エージェントが参照するエージェントスペースID	文字列
defaultModel	エージェントのデフォルトのAIモデル設定	デフォルトモデル
incidentManagementConfiguration	インシデント管理の構成	IncidentManagementConfiguration
knowledgeGraphConfiguration	エージェントのナレッジグラフ構成	KnowledgeGraphConfiguration
ログ構成	ログ構成	ログ構成
アップグレードチャネル	エージェントのアップグレードチャネル	'Preview' 'Stable'

ApplicationInsightsConfiguration

名前	説明	価値
アプリID	Application InsightsリソースのApplication ID	文字列
connectionString	Application Insightsリソースの接続文字列	string 制約： 機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。

デフォルトモデル

名前	説明	価値
名前	モデル名(例:gpt-5、claude-opus-4-5、claude-sonnet-4-5)	文字列
プロバイダ	AIプロバイダー名(例:MicrosoftFoundry、Anthropic)	文字列

IncidentManagementConfiguration

名前	説明	価値
接続キー	つながりの鍵	string 制約： 機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
connectionName	接続の名称	文字列
connectionUrl	接続のURLです	文字列
oboUser	接続のユーザー	文字列
型	インシデント管理システムの種類	文字列

KnowledgeGraphConfiguration

名前	説明	価値
ID	知識グラフにアクセスするために使われたアイデンティティ	文字列
managedResources	エージェントが管理するリソース一覧	string[]

ログ構成

名前	説明	価値
applicationInsightsConfiguration	Application Insights 構成	ApplicationInsightsConfiguration

ManagedServiceIdentity

名前	説明	価値
型	マネージド サービス ID の種類 (SystemAssigned 型と UserAssigned 型の両方が許可されます)。	「なし」 'システム割り当て' 'システム割り当て済み、ユーザー割り当て済み' 'UserAssigned' (必須)
userAssignedIdentities (ユーザー割り当て済みアイデンティティ)	リソースに関連付けられているユーザー割り当て ID のセット。 userAssignedIdentities ディクショナリ キーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} という形式の ARM リソース ID になります。 ディクショナリ値は、要求内の空のオブジェクト ({}) にすることができます。	ManagedServiceIdentityUserAssignedIdentities の

ManagedServiceIdentityUserAssignedIdentities

名前	説明	価値

追跡リソースタグ

名前	説明	価値

UserAssignedIdentity

名前	説明	価値

ARM テンプレート リソース定義

エージェントのリソースタイプは、以下の操作を対象に展開可能です:

• Resource groups - リソースグループのデプロイコマンド

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.App/agents リソースを作成するには、テンプレートに以下のJSONを追加してください。

{
  "type": "Microsoft.App/agents",
  "apiVersion": "2026-01-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "actionConfiguration": {
      "accessLevel": "string",
      "identity": "string",
      "mode": "string"
    },
    "agentIdentity": {
      "initialSponsorGroupId": "string"
    },
    "agentSpaceId": "string",
    "defaultModel": {
      "name": "string",
      "provider": "string"
    },
    "incidentManagementConfiguration": {
      "connectionKey": "string",
      "connectionName": "string",
      "connectionUrl": "string",
      "oboUser": "string",
      "type": "string"
    },
    "knowledgeGraphConfiguration": {
      "identity": "string",
      "managedResources": [ "string" ]
    },
    "logConfiguration": {
      "applicationInsightsConfiguration": {
        "appId": "string",
        "connectionString": "string"
      }
    },
    "upgradeChannel": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

プロパティ値

Microsoft.App/agents

名前	説明	価値
apiVersion	API のバージョン	'2026-01-01'
ID	このリソースに割り当てられているマネージド サービス ID。	ManagedServiceIdentity
位置	リソースが存在する地理的な場所	string (必須)
名前	リソース名	string 制約： パターン = ^[A-Za-z]([-A-Za-z0-9]{0,30}[A-Za-z0-9])$ (必須)
プロパティ	このリソースのリソース固有のプロパティ。	エージェントプロパティ
タグ	リソース タグ	タグ名と値のディクショナリ。 テンプレート の タグを参照してください
型	リソースの種類	「Microsoft.App/agents」

アクション構成

名前	説明	価値
accessLevel (アクセスレベル)	アクションのアクセスレベル	'High' 'Low'
ID	アクションが用いる恒等式	文字列
mode	作用様式	「自律的」 「読み取り専用」 『レビュー』

エージェントアイデンティティ

名前	説明	価値
イニシャルスポンサーグループID	初期スポンサーグループID(エージェント識別に必要)	string (必須)

エージェントプロパティ

名前	説明	価値
actionConfiguration	アクションの構成	アクション構成
agentIdentity	リソースへのアクセスのためのエージェント識別設定	エージェントアイデンティティ
agentSpaceId	エージェントが参照するエージェントスペースID	文字列
defaultModel	エージェントのデフォルトのAIモデル設定	デフォルトモデル
incidentManagementConfiguration	インシデント管理の構成	IncidentManagementConfiguration
knowledgeGraphConfiguration	エージェントのナレッジグラフ構成	KnowledgeGraphConfiguration
ログ構成	ログ構成	ログ構成
アップグレードチャネル	エージェントのアップグレードチャネル	'Preview' 'Stable'

ApplicationInsightsConfiguration

名前	説明	価値
アプリID	Application InsightsリソースのApplication ID	文字列
connectionString	Application Insightsリソースの接続文字列	string 制約： 機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。

デフォルトモデル

名前	説明	価値
名前	モデル名(例:gpt-5、claude-opus-4-5、claude-sonnet-4-5)	文字列
プロバイダ	AIプロバイダー名(例:MicrosoftFoundry、Anthropic)	文字列

IncidentManagementConfiguration

名前	説明	価値
接続キー	つながりの鍵	string 制約： 機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
connectionName	接続の名称	文字列
connectionUrl	接続のURLです	文字列
oboUser	接続のユーザー	文字列
型	インシデント管理システムの種類	文字列

KnowledgeGraphConfiguration

名前	説明	価値
ID	知識グラフにアクセスするために使われたアイデンティティ	文字列
managedResources	エージェントが管理するリソース一覧	string[]

ログ構成

名前	説明	価値
applicationInsightsConfiguration	Application Insights 構成	ApplicationInsightsConfiguration

ManagedServiceIdentity

名前	説明	価値
型	マネージド サービス ID の種類 (SystemAssigned 型と UserAssigned 型の両方が許可されます)。	「なし」 'システム割り当て' 'システム割り当て済み、ユーザー割り当て済み' 'UserAssigned' (必須)
userAssignedIdentities (ユーザー割り当て済みアイデンティティ)	リソースに関連付けられているユーザー割り当て ID のセット。 userAssignedIdentities ディクショナリ キーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} という形式の ARM リソース ID になります。 ディクショナリ値は、要求内の空のオブジェクト ({}) にすることができます。	ManagedServiceIdentityUserAssignedIdentities の

ManagedServiceIdentityUserAssignedIdentities

名前	説明	価値

追跡リソースタグ

名前	説明	価値

UserAssignedIdentity

名前	説明	価値

使用例

Terraform (AzAPI プロバイダー) リソース定義

エージェントのリソースタイプは、以下の操作を対象に展開可能です:

• リソース グループ

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.App/agents リソースを作成するには、テンプレートに以下のTerraformを追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.App/agents@2026-01-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      actionConfiguration = {
        accessLevel = "string"
        identity = "string"
        mode = "string"
      }
      agentIdentity = {
        initialSponsorGroupId = "string"
      }
      agentSpaceId = "string"
      defaultModel = {
        name = "string"
        provider = "string"
      }
      incidentManagementConfiguration = {
        connectionKey = "string"
        connectionName = "string"
        connectionUrl = "string"
        oboUser = "string"
        type = "string"
      }
      knowledgeGraphConfiguration = {
        identity = "string"
        managedResources = [
          "string"
        ]
      }
      logConfiguration = {
        applicationInsightsConfiguration = {
          appId = "string"
          connectionString = "string"
        }
      }
      upgradeChannel = "string"
    }
  }
}

プロパティ値

Microsoft.App/agents

名前	説明	価値
ID	このリソースに割り当てられているマネージド サービス ID。	ManagedServiceIdentity
位置	リソースが存在する地理的な場所	string (必須)
名前	リソース名	string 制約： パターン = ^[A-Za-z]([-A-Za-z0-9]{0,30}[A-Za-z0-9])$ (必須)
プロパティ	このリソースのリソース固有のプロパティ。	エージェントプロパティ
タグ	リソース タグ	タグ名と値のディクショナリ。
型	リソースの種類	「Microsoft.App/agents@2026-01-01」

アクション構成

名前	説明	価値
accessLevel (アクセスレベル)	アクションのアクセスレベル	'High' 'Low'
ID	アクションが用いる恒等式	文字列
mode	作用様式	「自律的」 「読み取り専用」 『レビュー』

エージェントアイデンティティ

名前	説明	価値
イニシャルスポンサーグループID	初期スポンサーグループID(エージェント識別に必要)	string (必須)

エージェントプロパティ

名前	説明	価値
actionConfiguration	アクションの構成	アクション構成
agentIdentity	リソースへのアクセスのためのエージェント識別設定	エージェントアイデンティティ
agentSpaceId	エージェントが参照するエージェントスペースID	文字列
defaultModel	エージェントのデフォルトのAIモデル設定	デフォルトモデル
incidentManagementConfiguration	インシデント管理の構成	IncidentManagementConfiguration
knowledgeGraphConfiguration	エージェントのナレッジグラフ構成	KnowledgeGraphConfiguration
ログ構成	ログ構成	ログ構成
アップグレードチャネル	エージェントのアップグレードチャネル	'Preview' 'Stable'

ApplicationInsightsConfiguration

名前	説明	価値
アプリID	Application InsightsリソースのApplication ID	文字列
connectionString	Application Insightsリソースの接続文字列	string 制約： 機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。

デフォルトモデル

名前	説明	価値
名前	モデル名(例:gpt-5、claude-opus-4-5、claude-sonnet-4-5)	文字列
プロバイダ	AIプロバイダー名(例:MicrosoftFoundry、Anthropic)	文字列

IncidentManagementConfiguration

名前	説明	価値
接続キー	つながりの鍵	string 制約： 機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
connectionName	接続の名称	文字列
connectionUrl	接続のURLです	文字列
oboUser	接続のユーザー	文字列
型	インシデント管理システムの種類	文字列

KnowledgeGraphConfiguration

名前	説明	価値
ID	知識グラフにアクセスするために使われたアイデンティティ	文字列
managedResources	エージェントが管理するリソース一覧	string[]

ログ構成

名前	説明	価値
applicationInsightsConfiguration	Application Insights 構成	ApplicationInsightsConfiguration

ManagedServiceIdentity

名前	説明	価値
型	マネージド サービス ID の種類 (SystemAssigned 型と UserAssigned 型の両方が許可されます)。	「なし」 'システム割り当て' 'システム割り当て済み、ユーザー割り当て済み' 'UserAssigned' (必須)
userAssignedIdentities (ユーザー割り当て済みアイデンティティ)	リソースに関連付けられているユーザー割り当て ID のセット。 userAssignedIdentities ディクショナリ キーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} という形式の ARM リソース ID になります。 ディクショナリ値は、要求内の空のオブジェクト ({}) にすることができます。	ManagedServiceIdentityUserAssignedIdentities の

ManagedServiceIdentityUserAssignedIdentities

名前	説明	価値

追跡リソースタグ

名前	説明	価値

UserAssignedIdentity

名前	説明	価値