エージェント365の設定方法

Important

Microsoft Agent 365 の早期アクセスを利用するには、フロンティアプレビュープログラムに参加する必要があります。フロンティアは、Microsoft の最新の AI イノベーションと直接接続します。 Frontier のプレビューは、お客様の契約書に記載されている既存のプレビュー利用規約に従います。これらの機能は現在開発中であるため、提供状況や機能は今後変更される可能性があります。

Agent 365のCLIは、Agent Blueprintのような必要なエージェントリソースを作成するために、あなたのテナント、サブスクリプション、その他の詳細を知る必要があります。 CLIはこの情報を作業ディレクトリ内の中央設定ファイル「 a365.config.json 」に保存します。 CLIのすべてのコマンドはこの設定ファイルを使用します。

[前提条件]

開始する前に、次の前提条件を満たしていることを確認してください。

Agent 365 CLI - Agent 365 CLI インストールを参照してください。

必要なアクセス許可:

次のいずれかのロールを持つ有効なMicrosoft Entra テナントユーザー。
- グローバル管理者
- エージェントID管理者
- エージェントIDデベロッパー
リソースを作成するアクセス許可を持つAzure サブスクリプションへのアクセス

Agent 365のCLIを設定してください

a365 config initコマンドは、すべてのAgent 365 CLIコマンドで使用される中央設定ファイルa365.config.jsonをワーキングディレクトリに作成します。 CLI は、Azure CLI統合とスマートな既定値を備えた対話型ウィザードを提供し、手動入力を最小限に抑えます。

Azureで認証する

構成を初期化する前に、コマンド

az login

プロンプトが表示されたら、適切なサブスクリプションを選択します。構成ウィザードでは、Azure CLIを使用して、使用可能なサブスクリプション、リソースグループ、および App Service プランのクエリを実行します。最もスムーズな開発体験を得るために、テナントユーザーアカウントを適切な役割と権限、サブスクリプション、アプリサービスプランを設定してから始めてください。

構成の初期化

インタラクティブ設定ウィザードを開始するには a365 config init コマンドを実行してください:

a365 config init

ウィザードでは、Azure CLI統合とスマートな既定値を使用して、手動入力を最小限に抑えます。次の指示が表示されます

フィールド	Description	Example
クライアントアプリID	カスタムクライアントアプリの登録ID	`00001111-aaaa-2222-bbbb-3333cccc4444`
展開プロジェクトのパス	エージェントプロジェクトディレクトリへのパス	`C:\MyAgent\sample-agent`
マネージャーのメール	このエージェントを監督するマネージャーのメールアドレス	`manager@yourtenant.com`
Azure サブスクリプション	使用可能なAzure サブスクリプションから選択する	インタラクティブな選択
リソースグループ	既存リソースグループを選択するか、新しいリソースグループを作成する	インタラクティブな選択
アプリサービスプラン	既存アプリプランを選択するか、新しいアプリサービスプランを作成する	インタラクティブな選択
場所	デプロイ用のAzureリージョン	`eastus`、`canadacentral`

ウィザードは関連するリソース名(ウェブアプリ、エージェント識別、設計図、エージェントユーザー)を自動的に生成し、プロジェクトタイプも検証します。保存する前に、必要に応じて外部リソース (Teams のプレゼンスファイルやOneDrive ファイルなど) のカスタムブループリントアクセス許可を構成し、生成された名前をカスタマイズできます。

設定ファイル構造について詳しくはこちら

エージェント365の設定ファイルを検証する

Agent 365は開発ライフサイクル全体を通じて複数の設定ファイルを使用します:

File	目的	作成日時	手動で編集するの?
`a365.config.json`	ユーザー提供の設定	`a365 config init` の後	イエス
`a365.generated.config.json`	CLIで生成された値(エージェントID、リソースID)	`a365 setup` の後	いいえ
`.env` または `appsettings.json`	ランタイム環境変数	地域の発展のために創造します	イエス

設定完了後、以下の項目が揃っているか確認してください:

`a365.config.json` ファイルの作成を確認

a365.config.jsonファイルが存在するかどうかを目で確認してください。または、この検証を自動化するためにスクリプト内の Test-Path PowerShellコマンドを使うこともできます。

# Check file exists in current working directory
Test-Path a365.config.json
# Should return: True

`a365.config.json`設定データの検証

a365 config displayコマンドを実行して、現在のAgent 365のCLI設定を確認します。

a365 config display

このコマンドの出力は次のようになります:

{
  "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
  "resourceGroup": "your-resource-group",
  "location": "location-of-your-azure-resources",
  "environment": "prod",
  "needDeployment": true,
  "clientAppId": "00001111-aaaa-2222-bbbb-3333cccc4444",
  "appServicePlanName": "your-app-service-plan",
  "appServicePlanSku": "service-plan-sku",
  "webAppName": "your-web-app",
  "agentIdentityDisplayName": "your-agent-name Identity",
  "agentBlueprintDisplayName": "your-agent-name Blueprint",
  "agentUserPrincipalName": "youragent@yourtenant.onmicrosoft.com",
  "agentUserDisplayName": "your-agent-name Agent User",
  "managerEmail": "manager@yourtenant.com",
  "agentUserUsageLocation": "usage-location",
  "deploymentProjectPath": "C:\\path\\to\\your\\project",
  "agentDescription": "your-agent-name - Agent 365 Agent"
}

検証チェックリスト

✅ すべてのフィールドは有効な値を持ちます(空文字列やヌルはありません)
✅ tenantId subscriptionId有効なGUIDです
✅ clientAppId 有効なGUID(カスタムクライアントアプリの登録)です。
✅ resourceGroup と appServicePlanName がAzure サブスクリプションに存在します
✅ managerEmail テナントドメインを使います
✅ deploymentProjectPath エージェントコードディレクトリを指し示します
✅ agentUserPrincipalName フォーマットに従います agentname@tenant.com
✅ environment は設定されます(通常 prod)
✅ needDeployment は初期セットアップtrueです。デプロイメントが不要なら、エージェントメッセージングエンドポイントの設定方法を学びましょう。

設定が期待値と一致しない場合は、トラブルシューティングのセクションで詳細な解決策をご覧ください。

ヒント

a365.config.jsonファイルのバックアップを取っておきましょう。ソース管理にコミットできます(秘密は含まれていません)。

a365.generated.config.json ファイルに .gitignore を追加します。このファイルには生成されたシークレットが含まれており、ソース管理にコミットしないでください。

次のステップ

すべて問題なければ、準備ができています。

セットアップエージェントブループリント

トラブルシューティング

これらのステップを使って、 a365.config.json とAgent 365 CLIに関する一般的な問題を迅速に診断し解決しましょう。

構成ファイルが存在しない
構成値が見つからないか無効です
テナントまたはサブスクリプションが無効です
カスタムクライアントアプリの検証が失敗する
無効なエージェントユーザープリンシパル名
Web アプリ名は既に取得されています

構成ファイルが存在しない

症状：CLIコマンドは「Configuration Not found」で失敗するか、Test-Path a365.config.jsonFalse返します。

解決策: 新しい a365.config.json ファイルを作成します。

Azureで認証し、構成を初期化する手順を完了します。

構成値が見つからないか無効です

症状： 設定ファイルは存在しますが、空欄や検証エラーがあります。

解決策:手順に従って設定データを確認a365.config.jsonしてください。

もしどの項目でも間違っている場合:

選択肢1:ウィザードをa365 config initコマンドで再実行してください。
オプション2: 正しい値を手動で a365.config.json 編集してください。

テナントまたはサブスクリプションが無効です

症状： CLIは認証や認可エラーで失敗します。

Solution:

これらのコマンドを使用して、Azureで再認証し、サインインしたアカウントを確認し、正しいサブスクリプションに切り替えて、Agent 365 CLI 構成を再初期化します。

# Re-authenticate with Azure
az login

# Verify you're logged into the correct account
az account show

# If needed, switch to the correct subscription
az account set --subscription "<subscription-name-or-id>"

# Re-initialize configuration
a365 config init

カスタムクライアントアプリの検証が失敗する

症状： カスタムクライアントアプリIDの検証時に設定ウィザードが失敗します。

解決策:カスタムクライアントアプリの登録を確認し、必要な権限と管理者の同意がすべてあるか確認してください。

無効なエージェントユーザープリンシパル名

症状： 構成中にエージェントユーザープリンシパル名の検証が失敗する。

ソリューション： UPN が username@domain形式に従っていることを確認します。たとえば、「 demo.agent@contoso.onmicrosoft.com 」のように入力します。ドメインサフィックスが見つからないのが最も一般的な原因です。

Web アプリ名は既に取得されています

症状： Web アプリ名が既に使用されているため、セットアップは失敗します。

Solution: Web アプリ名は、Azureでグローバルに一意である必要があります。 webAppNameのa365.config.jsonを一意の値に更新するか、a365 config init再実行して新しい名前を生成します。

フィードバック

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

Last updated on 2026-03-10