Important
Microsoft Agent 365 の早期アクセスを利用するには、フロンティア プレビュープログラムに参加する必要があります。 フロンティアは、Microsoft の最新の AI イノベーションと直接接続します。 Frontier のプレビューは、お客様の契約書に記載されている既存のプレビュー利用規約に従います。 これらの機能は現在開発中であるため、提供状況や機能は今後変更される可能性があります。
エージェントを構築し、ローカルでテストしました。次はクラウドで稼働させるタイミングです。 このステップは任意で、すでにクラウドにエージェントをデプロイしている場合は省略可能です(Azureでなくてもいい)。
このガイドでは、エージェント コードを Azure に展開し、Microsoft 管理センターに公開する手順を説明します。これにより、組織内で検出可能な資産となります。
また、Azureではなく、すでにエージェントをAWSやGCPなど他のクラウドプロバイダーにデプロイしている場合、メッセージングエンドポイントを更新する方法を示すリソースもあります。
[前提条件]
開始する前に、次のことを確認してください。
必要なアカウントとアクセス許可
- Azureサブスクリプションとコントリビューターアクセス。
- 有効で到達可能なメッセージングエンドポイントを持つ動作するエージェントコード。 必ずローカルでテストし、エージェントコードが構築・実行可能であることを確認してください。
- 有効なエージェントブループリントを得るためにセットアップエージェントブルー プリントのステップ を完了してください。
- コード内の設定ファイル
a365.config.json、a365.generated.config.json、設定ファイル(例:.envファイル)が最新であることを確認してください。
必要なツール
- Azure CLIのインストールと認証済み(Azure CLIのインストール)
- A365 CLI インストール済み (Agent 365 CLI)
Azure にデプロイ
a365 deployコマンドはセットアップ時に作成したAzure Web Appにエージェントをデプロイします。
これによりエージェントコードがAzureにアップロードされ、クラウド上で実行でき、そのエンドポイントへのエージェントリクエストを処理できるようになります。
エージェントの展開
展開コマンドを実行します:
a365 deploy
注
a365 deploy -h このコマンドを実行するすべてのオプションとサブコマンドを示します。
.NET エージェントの展開コマンド:
- .NET プロジェクト ファイル (
*.csproj、*.fsproj、*.vbproj) を検出します -
dotnet restoreを使用して NuGet パッケージを復元します -
dotnet publishを使用してリリース構成でアプリケーションを公開する - エントリ ポイント DLL コマンドを使用して Oryx マニフェストを作成します (例:
dotnet YourApp.dll) - 検出された .NET バージョンに基づいて Azure ランタイムを構成します (既定値:
DOTNET|8.0) - zip ファイル経由で展開して進行状況をリアルタイムで表示する
Warnung
シークレット管理: 展開時には、環境変数 (API キーやシークレットを含む) は、Azure App Settings として保存されます。 環境変数は設定に一般的に使用されますが、プレーン テキストで保存されます。 運用環境では、Microsoft は機密性の高いシークレットに対して Azure Key Vault の使用を推奨しています。 詳細については、Core ASP.NET で開発中のアプリ シークレットの安全なストレージと Azure Key Vault 構成プロバイダーを参照してください。 機密情報を含む .env ファイルをソース管理に絶対にコミットしないでください。
デプロイを検証する
展開の完了後:
- Azure Portal で Web アプリに移動します
- 設定>構成 に移動して、アプリの設定を確認します
- Deployment Center の展開ログを確認します
次のステップ
次に、エージェントアプリケーションをMicrosoft Admin Centerに公開し、そこからエージェントのインスタンスやユーザーを作成してください:Microsoft Admin Centerにエージェントを公開します
エージェントはクラウド上で稼働し、エージェントからのリクエストに対応できる状態です。 エージェントが実際のリクエストを処理する際には、コードの次のステップを考慮してください: