エージェント365のAIガイド付きセットアップ

Agent 365 開発ライフサイクルには、CLI のインストール、前提条件の構成、エージェント ブループリントの作成、コードのデプロイ、Microsoft 365管理センターへの発行という複数の手順が含まれます。 各ステップには独自の前提条件、検証チェック、意思決定ポイントがあります。

AI ガイド付きセットアップは、AI コーディング エージェント (VS Code でのGitHub Copilotなど) を使用して、ユーザーに代わってライフサイクル ステップを実行することで、このワークフロー全体を自動化します。 複数のドキュメントページを移動したり手動でコマンドを実行する代わりに、AIエージェントに単一の命令ファイルを提供し、インタラクティブにプロセスを案内してくれます。

メリット

AIガイド付きセットアップは、手動ワークフローに比べていくつかの利点があります。

• シングルエントリーポイント — 1つの命令ファイルで複数のドキュメントページ間を移動する必要がなくなります。 AIエージェントは手順を順番に追い、トランジションを自動的に処理します。
• 自動前提条件検証 — AI エージェントは、Azure CLIがインストールおよび認証されていること、カスタム クライアント アプリの登録に管理者の同意を得た正しいアクセス許可があること、および言語固有のビルド ツールが使用可能であることを検証してから、a365 CLI コマンドを実行します。
• Smart の既定値と自動検出 — AI エージェントは、既存のリソース グループ、App Service プラン、ユーザー情報についてAzure サブスクリプションに対してクエリを実行し、構成入力を収集するときにそれらの値を提案として使用します。
• 派生命名規則 — エージェントに単一のベース名を割り当てると、AIエージェントが関連するすべてのリソース名(アイデンティティ、設計図、ユーザープリンシパル名、ウェブアプリ)を一貫したパターンで導出します。
• インラインエラー処理 — コマンドが失敗した場合、AIエージェントがエラーを分析し、修正案を提案し、再挑戦します。トラブルシューティングのドキュメントを探す必要がなくなります。
• 非インタラクティブな設定 — AIエージェントは a365.config.json ファイルを直接作成しインポートするため、自動化環境におけるインタラクティブCLIウィザードの問題を回避します。

[前提条件]

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

必要なツール

• Visual Studio CodeGitHub Copilot および GitHub Copilot Chat 拡張機能がインストールされています。 AI誘導のセットアップには、端末アクセスを持つAIコーディングエージェントが必要です。
• .NET 8.0 以降 — エージェント 365 CLI に必要です。 Install .NET。
• Azure CLI — 認証とリソース管理に必要です。 Install Azure CLI。

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

• 共同作成者アクセス権を持つ Azure サブスクリプション
• Microsoft Entra テナントのいずれかのロールを持つ。
  • グローバル管理者
  • エージェントID管理者
  • エージェントIDデベロッパー
• カスタムクライアントアプリ登録 - 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 チャットを開く

GitHub Copilotチャット パネルを開き、Agent モードに切り替えます。 エージェント モードでは、GitHub Copilotターミナル コマンドの実行、ファイルの読み取り、プロジェクトの操作を行うことができます。AI ガイド付きセットアップで必要なすべての機能です。

ステップ3:指示ファイルを添付して開始

Copilotチャットの入力欄でa365-setup-instructions.md ファイルを添付し、簡潔なプロンプトと共に送信してください。 例えば次が挙げられます。

Follow the steps in #file:a365-setup-instructions.md

AIエージェントは命令ファイルを読み取り、ガイド付きセットアップを開始します。 5つのステップからなるタスクリストを作成し、それらを順番に進めていきます。

1. Agent 365のCLIを検証してインストール する - CLIの確認、インストールまたは更新を行い、動作を確認します。
2. Validate の前提条件 - Azure CLI認証を確認し、カスタム クライアント アプリの登録とアクセス許可を検証し、プロジェクトの種類に合わせてビルド ツールがインストールされていることを確認します。
3. エージェント 365 CLI の構成 - Azureホスト型デプロイとセルフホステッド デプロイのどちらが必要かを確認し、構成値を収集し、リソース名を派生させ、a365.config.json ファイルを作成します。
4. リソースのプロビジョニング - a365 setup all を実行して、Azureインフラストラクチャとエージェント ブループリントを作成します。
5. 発行と配置 - マニフェストを確認し、エージェントをMicrosoft 365管理センターに発行し、コードをAzureに展開し、配置後の手順を提供します。

ステップ4:プロンプトに応答する

AIエージェントは特定のポイントで一時停止し、あなたから入力を収集します:

• カスタムクライアントアプリID — カスタムクライアントアプリの登録のためのYour Application(クライアント)ID。
• 展開の種類 — Azure Web アプリ (Azure ホスト) を作成するか、既存のエンドポイント (セルフホステッド) を使用するか。
• 構成値 — リソース グループ、場所、エージェント名、マネージャーの電子メール、App Service プラン (Azure ホスト) またはエージェント名とマネージャーの電子メール (セルフホステッドの場合)。
• 派生値確認 — エージェントの識別、設計図、ユーザープリンシパルの自動生成名を確認します。
• マニフェストレビュー — manifest.json にエージェントの名前、説明、開発者情報が更新されているか確認してください。

ステップ5:展開後のタスク完了

CLIコマンドが終了すると、AIエージェントはブラウザ操作を必要とする手動ステップの指示を提供します:

1. Teams Developer Portalでエージェントを設定する — エージェントの種類とボットIDを設定します。
2. エージェントインスタンスを作成する — Teamsにインスタンスをリクエストし、管理者の承認を得てください。
3. エージェントをテスト する — Teamsでエージェントにメッセージを送り、動作を確認しましょう。

これらの展開後の詳細な手順については、「 エージェントインスタンスの作成」を参照してください。

AIガイド付きセットアップがカバーしていること

AIガイド付きセットアップは 、開発ライフサイクルの以下の段階を自動化します:

トラブルシューティング

AIエージェントはターミナルコマンドを実行しません

AI エージェントがコマンドを記述しても実行しない場合は、GitHub Copilot Chat で Agent モードを使用していることを確認します。 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エージェントに特定の値を更新してもらうよう依頼します

次のステップ