Agent 365 CLI deploy コマンド リファレンス

エージェント 365 アプリケーション バイナリを構成済みのAzure App Serviceにデプロイし、エージェント 365 ツールのアクセス許可を更新します。deploy コマンドには、エージェント 365 展開を作成するためのオプションが用意されています。 このコマンドを使用して、アプリケーション バイナリを Azure インフラストラクチャにデプロイし、Agent 365 Tools のアクセス許可を付与します。

Minimum ロールが必要です: Azure Contributor + Global Administrator

このコマンドの使用方法については、「Deploy agent to Azureを参照してください。

構文

a365 deploy [command] [options]

オプション

注釈

サブコマンドなしで a365 deploy を実行すると、 2 フェーズのデプロイが実行されます。

• Phase 1 — アプリケーション バイナリ: アプリケーションをビルドしてAzure App Serviceにデプロイします。
• フェーズ 2 — MCP アクセス許可: toolingManifest.json から必要なスコープを読み取り、必要なアクセス許可でエージェント ブループリントを更新します。

どちらのフェーズも、 --dry-runでも実行されます。 ドライラン出力は、ラベル付けされた 2 つのセクションに分かれているため、各フェーズで何が行われるかを確認できます。

プレフライト チェック

デプロイする前に、CLI によって次の検証が行われます。

• Azure 認証とサブスクリプション: Azure CLI セッションとサブスクリプションが有効である必要があります。 そうでない場合、デプロイはエラーで停止します。 az login --tenant <TENANT_ID>とaz account set --subscription <SUBSCRIPTION_ID>で修正。
• Azure App Service存在: デプロイを続行する前に、ターゲット Web アプリが存在している必要があります。 アプリが見つからない場合は、a365 setupまたは正しいwebAppNameを実行し、a365.config.jsonでresourceGroupします。

コンフィギュレーション

CLI は、次の 2 つの構成ファイルから読み取ります。

• a365.config.json — プロジェクト構成 (ユーザーが管理)。
• a365.generated.config.json — セットアップ コマンドによって生成される動的な状態。

MCP ツールスコープは、配置プロジェクト ディレクトリの toolingManifest.json から読み取られます。

CLI には、構成と状態のグローバル コピーも次の位置に格納されます。

• Windows: %LocalAppData%\Microsoft.Agents.A365.DevTools.Cli
• Linux/macOS: ~/.config/a365

フラグの動作

--restart: ビルド ステップをスキップし、既存の publish/ フォルダーの圧縮から直接開始します。 publish/が存在しない場合、デプロイは失敗します。 最初に ( --restartなしで) 完全展開を実行して、 publish/ フォルダーを生成します。

--inspect: アップロード手順の前に一時停止し、 publish/ フォルダーと生成された ZIP ファイルを調べることができます。 アプリ フェーズでのみ使用できます。

--dry-run:変更を加えずに発生するすべてのものを出力します。 a365 deploy (2 フェーズ) を実行すると、出力は次のように分割されます。

• パート 1 - アプリケーション バイナリをデプロイする
• パート 2 — エージェント 365 ツールのアクセス許可の展開/更新

deploy app

セットアップ中に作成されたAzure Web アプリにエージェント コードをデプロイします。

a365 deploy app [options]

構成されたAzure App Serviceに Microsoft Agent 365 アプリケーション バイナリをデプロイします。 このコマンドは、Azureで構成された Azure App Service にアプリケーション バイナリをデプロイします。

app のオプション

deploy mcp

エージェント ブループリントに対する MCP サーバーのアクセス許可を更新します。

a365 deploy mcp [options]

mcp のオプション

使用に関する注記

既存のエージェント ブループリントに対する MCP サーバーのスコープとアクセス許可を更新します。 このコマンドは、エージェント 365 Tools のアクセス許可をエージェント ブループリントに追加します。

エージェント コードで MCP サーバーを追加または変更する場合は、このコマンドを使用して、エージェント ブループリントのアクセス許可を更新します。

このコマンドは、次の操作を行います。

• コードから MCP サーバー構成を読み取ります。
• エージェント ブループリントを必要なアクセス許可で更新します。
• MCP サーバーに必要な API アクセス許可を付与します。

アクセス許可の更新は、次の順序で適用されます。

1. OAuth2 アクセス許可の付与 (ブループリント サービス プリンシパル→ MCP プラットフォーム)
2. 継承可能なアクセス許可 (エージェント ブループリント→ MCP リソース)
3. 管理者の同意 (MCP プラットフォーム→エージェント ID)

deploy mcpを使用する場合:

• エージェントに新しい MCP サーバーを追加した後。
• MCP サーバー構成を変更した後。
• MCP ツールにエージェントからアクセスできない場合。

deploy mcpを実行する必要はありません。

• 初期デプロイ時。 これはセットアップ時に自動的に処理されます。
• MCP を使用せずにエージェント ロジックのみを変更する場合。
• ツールに影響しない定期的なコード更新後。

Troubleshooting

次のセクションを使用して、 deploy コマンドの潜在的な問題を解決します。

• Azureまたは間違ったサブスクリプションにログインしていません
• Web アプリが見つかりません
• アクセス許可の更新が失敗する
• --restart 失敗

Azureまたは間違ったサブスクリプションにログインしていない

az login --tenant <TENANT_ID> および az account set --subscription <SUBSCRIPTION_ID> を実行します。

Web アプリが見つかりません

a365 setupが実行されていることを確認するか、a365.config.jsonでwebAppNameとresourceGroupが正しいことを確認します。

アクセス許可の更新が失敗する

• AgentBlueprintId、AgenticAppId、環境がa365.config.jsonで設定されていることを確認します。
• アカウントにサービス プリンシパルと許可を管理する権限があることを確認します。
• toolingManifest.jsonが配置プロジェクト ディレクトリに存在し、有効なスコープが含まれていることを確認します。

--restart 失敗

publish/ フォルダーを生成する--restartなしで完全配置を実行し、その後のイテレーションに--restartを使用します。

ログ

CLI ログ ファイルは次の位置に格納されます。

• Windows: %LocalAppData%\Microsoft.Agents.A365.DevTools.Cli\logs\
• Linux/macOS: ~/.config/a365/logs/

最新のデプロイ ログ ファイルの最後の 80 行を表示するには、Windows Get-Content または Linux/macOS の tail を使用します。

# Windows
Get-Content $env:LOCALAPPDATA\Microsoft.Agents.A365.DevTools.Cli\logs\a365.deploy.log -Tail 80

# Linux/macOS
tail -80 ~/.config/a365/logs/a365.deploy.log

ランタイム アプリケーション ログの場合は、App Service の stdout/stderr のAzure ポータルで Log Stream を使用します。