Important
Microsoft Agent 365 の早期アクセスを利用するには、フロンティア プレビュープログラムに参加する必要があります。 フロンティアは、Microsoft の最新の AI イノベーションと直接接続します。 Frontier のプレビューは、お客様の契約書に記載されている既存のプレビュー利用規約に従います。 これらの機能は現在開発中であるため、提供状況や機能は今後変更される可能性があります。
Agent 365 の開発ライフサイクル は複数のステップから成り立ちます。CLIのインストール、前提条件の設定、エージェントブループリントの作成、コードのデプロイ、Microsoft 365管理センターへの公開です。 各ステップには独自の前提条件、検証チェック、意思決定ポイントがあります。
AI主導のセットアップは、AIコーディングエージェント(例えばVS CodeのGitHub Copilot)を使ってライフサイクルステップを自動実行し、このワークフロー全体を自動化します。 複数のドキュメントページを移動したり手動でコマンドを実行する代わりに、AIエージェントに単一の命令ファイルを提供し、インタラクティブにプロセスを案内してくれます。
メリット
AIガイド付きセットアップは、手動ワークフローに比べていくつかの利点があります。
- シングルエントリーポイント — 1つの命令ファイルで複数のドキュメントページ間を移動する必要がなくなります。 AIエージェントは手順を順番に追い、トランジションを自動的に処理します。
-
自動前提条件検証 — AIエージェントはAzure CLIがインストール・認証されていること、カスタムクライアントアプリの登録が管理者の同意を得て正しい権限を持っていること、言語固有のビルドツールが利用可能であることを
a365CLIコマンドを実行する前に検証します。 - スマートデフォルトと自動検出 — AIエージェントはAzureサブスクリプションから既存のリソースグループ、App Serviceプラン、ユーザー情報を問い合わせ、それらの値を提案として設定入力を収集します。
- 派生命名規則 — エージェントに単一のベース名を割り当てると、AIエージェントが関連するすべてのリソース名(アイデンティティ、設計図、ユーザープリンシパル名、ウェブアプリ)を一貫したパターンで導出します。
- インラインエラー処理 — コマンドが失敗した場合、AIエージェントがエラーを分析し、修正案を提案し、再挑戦します。トラブルシューティングのドキュメントを探す必要がなくなります。
-
非インタラクティブな設定 — AIエージェントは
a365.config.jsonファイルを直接作成しインポートするため、自動化環境におけるインタラクティブCLIウィザードの問題を回避します。
[前提条件]
開始する前に、次の前提条件を満たしていることを確認してください。
必要なツール
- Visual Studio Code と GitHub CopilotChat 拡張機能をインストールしています。 AI誘導のセットアップには、端末アクセスを持つAIコーディングエージェントが必要です。
- .NET 8.0以降 — エージェント365 CLIに必須。 .NETをインストールしてください。
- Azure CLI — 認証およびリソース管理に必須です。 Azure CLI のインストール。
必要なアカウントとアクセス許可
- Azureサブスクリプション とContributor accessを
- 次のいずれかのロールを持つ Microsoft Entra テナント:
- カスタムクライアントアプリ登録 - AIガイドの設定がこのアプリ登録を検証しますが、アプリはすでにテナント内に存在し、必要な権限と管理者の同意が必要です。 作成が必要な場合は カスタムクライアントアプリの登録 を参照してください。
必要なエージェントコード
- デプロイしたい動作するエージェントプロジェクト(Python、Node.js、または.NET)を用意しましょう。 もし持っていなければ、 クイックスタートのサンプルから始めてみてください。
セットアップ手順のファイルを入手してください
AIガイドによるセットアップは「 a365-setup-instructions.md」という命令ファイルを使用します。
Agent365-devToolsリポジトリにはこのファイルが含まれています。
リポジトリをクローンした場合、ファイルは以下の通りです:
Agent365-devTools/docs/agent365-guided-setup/a365-setup-instructions.md
リポジトリをクローンしていなければ、 GitHubから直接ファイルをダウンロードしてください。
AIガイドのセットアップを実行してください
以下の手順に従って、エージェントプロジェクトでAIガイド付きセットアップを開始してください。
ステップ1:VS Codeでエージェントプロジェクトを開く
Visual Studio Codeでエージェントのプロジェクトディレクトリを開きます。 このディレクトリにはエージェントコード(例えば、 package.json、 *.csproj、 pyproject.toml ファイルを含むディレクトリ)が含まれています。
ステップ2:エージェントモードでGitHub Copilot Chatを開く
GitHubのCopilotチャットパネルを開き、 エージェント モードに切り替えてください。 エージェントモードにより、GitHub Copilotはターミナルコマンドの実行、ファイルの読み取り、プロジェクトとのやり取りなど、AI主導のセットアップで求められる機能を備えています。
Important
エージェントモード(AskやEditモードではなく)を必ず使ってください。 AIガイドのセットアップは、端末コマンドを実行し、環境とやり取りする能力を必要とします。
ステップ3:指示ファイルを添付して開始
Copilot Chatの入力で a365-setup-instructions.md ファイルを添付し、短いプロンプトとともに送信します。 例えば次が挙げられます。
Follow the steps in #file:a365-setup-instructions.md
AIエージェントは命令ファイルを読み取り、ガイド付きセットアップを開始します。 5つのステップからなるタスクリストを作成し、それらを順番に進めていきます。
- Agent 365のCLIを検証してインストール する - CLIの確認、インストールまたは更新を行い、動作を確認します。
- 前提条件の検証 - Azure CLI認証の確認、カスタムクライアントアプリの登録と権限の検証、プロジェクトタイプに合ったビルドツールのインストール確認。
-
Agent 365 CLIの設定 - Azureホストかセルフホスト展開かを尋ね、設定値を収集し、リソース名を導き出し、
a365.config.jsonファイルを作成します。 -
リソースのプロビジョ ニング - Azureインフラとエージェントブループリントを作成するために
a365 setup allを実行します。 - 公開とデプロイ - マニフェストを確認し、エージェントをMicrosoft 365管理センターに公開し、コードをAzureにデプロイし、展開後の指示を提供します。
ステップ4:プロンプトに応答する
AIエージェントは特定のポイントで一時停止し、あなたから入力を収集します:
- カスタムクライアントアプリID — カスタムクライアントアプリの登録のためのYour Application(クライアント)ID。
- デプロイメントタイプ — Azure Web App(Azureホスト)を作成するか、既存のエンドポイント(セルフホスト)を使うか。
- 設定値 — リソースグループ、所在地、エージェント名、マネージャーメール、App Serviceプラン(Azureホストの場合)またはエージェント名とマネージャーメール(セルフホストの場合)。
- 派生値確認 — エージェントの識別、設計図、ユーザープリンシパルの自動生成名を確認します。
-
マニフェストレビュー —
manifest.jsonにエージェントの名前、説明、開発者情報が更新されているか確認してください。
ヒント
AIエージェントは設定入力を求める際に、Azureサブスクリプションの実際の値を例として示しています。 提案を受け入れるか、自分の価値観を提示するかのどちらかです。
ステップ5:展開後のタスク完了
CLIコマンドが終了すると、AIエージェントはブラウザ操作を必要とする手動ステップの指示を提供します:
- Teams Developer Portalでエージェントを設定する — エージェントの種類とボットIDを設定します。
- エージェントインスタンスを作成する — Teamsにインスタンスをリクエストし、管理者の承認を得てください。
- エージェントをテスト する — Teamsでエージェントにメッセージを送り、動作を確認しましょう。
これらの展開後の詳細な手順については、「 エージェントインスタンスの作成」を参照してください。
AIガイド付きセットアップがカバーしていること
AIガイド付きセットアップは 、開発ライフサイクルの以下の段階を自動化します:
| ライフサイクル ステージ | AIエージェントの役割 | 手動相当 |
|---|---|---|
| CLIのインストール | Agent 365 CLIのインストールまたは更新 | Agent 365 CLI |
| [前提条件] | Azure CLI、カスタムクライアントアプリ、権限、ビルドツールの検証 | カスタムクライアントアプリ登録 |
| コンフィギュレーション | 検証済みの値で a365.config.json を作成する |
セットアップエージェント365の設定 |
| ブループリントの設定 | インフラ作成と設計図作成 a365 setup all を運営します |
セットアップエージェントブループリント |
| デプロイメント | コードの構築とデプロイのために a365 deploy を実行します |
Deploy agent to Azure |
| Publishing | 管理者センターでエージェント登録 a365 publish 実行します |
Publish agentからMicrosoft管理センターへ |
注
AIガイドのセットアップは、エージェントコードを 先に作 る必要を置き換えるものではありません。 ガイド付きセットアップを始める前に、動作するエージェントプロジェクトを用意しているべきです。 新しいプロジェクトはクイック スタートから始めましょう。
トラブルシューティング
AIエージェントはターミナルコマンドを実行しません
AIエージェントがコマンドを説明するが実行しない場合は、GitHub Copilot Chatで エージェントモードを使って いることを確認してください。 AskモードとEditモードには端末アクセスがありません。
AIエージェントは検証ステップをスキップします
命令ファイルは厳密なステップ順序を強制します。 AIエージェントがステップを飛ばしているように見えたら、最初から指示に従うようリマインドしてください。 例えば次が挙げられます。
Please start from Step 1 in the setup instructions and work through each step in order.
CLIコマンドは権限エラーで失敗します
もし a365 CLIコマンドが認証エラーで失敗する場合、最も一般的な原因はカスタムクライアントアプリの登録が欠落または不完全であることです。 AIエージェントはStep 2でこの登録を検証しますが、もしその検証を省略していれば、再度実行してください。 完全なセットアップガイドについては 、カスタムクライアントアプリの登録をご覧ください。
設定値が間違っています
a365.config.jsonファイルを作成後に設定値を変更する必要がある場合は、以下のいずれかが可能です:
-
a365.config.jsonファイルを直接編集して再実行してくださいa365 config init -c ./a365.config.json - AIエージェントに特定の値を更新してもらうよう依頼します