次の方法で共有


Deploy agent to Azure

Important

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

エージェントを構築し、ローカルでテストしました。次はクラウドで稼働させるタイミングです。 このステップは任意で、すでにクラウドにエージェントをデプロイしている場合は省略可能です(Azureでなくてもいい)。

このガイドでは、エージェント コードを Azure に展開し、Microsoft 管理センターに公開する手順を説明します。これにより、組織内で検出可能な資産となります。

また、Azureではなく、すでにエージェントをAWSやGCPなど他のクラウドプロバイダーにデプロイしている場合、メッセージングエンドポイントを更新する方法を示すリソースもあります。

[前提条件]

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

必要なアカウントとアクセス許可

  • Azureサブスクリプションとコントリビューターアクセス。
  • 有効で到達可能なメッセージングエンドポイントを持つ動作するエージェントコード。 必ずローカルでテストし、エージェントコードが構築・実行可能であることを確認してください。
  • 有効なエージェントブループリントを得るためにセットアップエージェントブルー プリントのステップ を完了してください。
  • コード内の設定ファイル a365.config.jsona365.generated.config.json 、設定ファイル(例:.envファイル)が最新であることを確認してください。

必要なツール

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 ファイルをソース管理に絶対にコミットしないでください。

デプロイを検証する

展開の完了後:

  1. Azure Portal で Web アプリに移動します
  2. 設定>構成 に移動して、アプリの設定を確認します
  3. Deployment Center の展開ログを確認します

次のステップ

次に、エージェントアプリケーションをMicrosoft Admin Centerに公開し、そこからエージェントのインスタンスやユーザーを作成してください:Microsoft Admin Centerにエージェントを公開します

エージェントはクラウド上で稼働し、エージェントからのリクエストに対応できる状態です。 エージェントが実際のリクエストを処理する際には、コードの次のステップを考慮してください:

  • パフォーマンスの監視: 監視機能を使用して、エージェントの動作を追跡し、応答を最適化する
  • その他のツールの追加: ツール カタログを調べてエージェントの機能を拡張する
  • 反復処理と改善: エージェント コードの更新、再展開、再発行 (バージョン番号を増やしてください)。
  • 組織全体でスケーリング: 導入を促進するためにエージェントの成功事例を共有する