このクイックスタートでは、コーディングアシスタントの Agent 365 Skills を使って既存のエージェントをAgent 365に接続します。 パスはエージェントの登録から始まり、選択した機能を追加し、検証で終わります。 AIチームメイトを作成してFrontierプレビュープログラムが必要な場合、ローカルでテストすることも可能です。
各ステップにはそれを扱うスキルの名前が記載され、例のリクエストが表示されます。 スキルを発動するには、スキル名を入力するのではなく、結果を述べて発動します。
Prerequisites
- サポートスタック上の既存のエージェント:Python、Node.js、または.NET。
- Agent 365を有効にしたMicrosoftテナントです。 グローバル管理者としてサインインするか、グローバル管理者が利用可能なエージェントID開発者としてログインしてOAuthの権限付与を完成させます。
- リソース作成の許可を持つAzureサブスクリプションです。
- 対応するコーディングアシスタント:Claude Code、GitHub Copilot CLI、またはVS Codeエージェントモード。
- スキルをインストールするために使われたGitHub CLI(
gh)。
Note
Agent 365のセットアップは、テナントで利用可能なMicrosoft管理のAgent 365 CLIエンタープライズアプリケーションを使用します。 このルート用にカスタムクライアントアプリを作成する必要はありません。 エンタープライズアプリケーションが利用できない場合、セットアップは Agent 365 CLIというテナント所有のアプリにフォールバックされます。 明示的に設定されたカスタムクライアントアプリは引き続きサポートされています。 詳細については、 Agent 365 CLIのカスタムクライアントアプリ登録をご覧ください。
ライセンスは、どの機能を採用するかによって異なります:
- アイデンティティ。 追加の免許はありません。 テナントはエージェント365を有効にしている必要があります。
- 可観測性。 テナント内に少なくとも1人のユーザーがMicrosoft 365 E7またはMicrosoft Agent 365のライセンスを割り当てています。 これがなければ、テレメトリは静かに切断されます。
- ツール（Work IQ）。 Microsoft 365 Copilot ライセンス。 Work IQ MCPはプレビュー段階です。
- 通知。 エージェントのユーザーアカウントで、Frontierプレビュープログラムのテナントのみが利用可能です。
Tip
まずはSDKがエージェントにとって適切な統合メカニズムであるか確認してください。 「 統合オプションを選ぶ」をご覧ください。 登録の背後にあるアイデンティティモデル(設計図、権限、同意など)については、エージェントIDおよびMicrosoft Entra エージェント IDのキーコンセプトを参照してください。
スキルを導入する
コーディングアシスタントにスキルを組み込む:
gh skill add microsoft/agent365-skills
同じコマンドはClaude Code、GitHub Copilot CLI、VS Codeエージェントモードにも適用されます。 その後、アシスタントを再起動して新しいスキルを習得させてください。
プロジェクトのセットアップと検出
コーディングアシスタントでエージェントプロジェクトを開き、次の動作を実行します:
スキル:a365-setup
エージェント365のためにこのプロジェクトを立ち上げた
エージェントに関する質問に答えましょう。 スキルが終了すると、前提条件を検証し、スタックを検出します。
セットアップは生成されたIDとエンドポイントを a365.generated.config.jsonに保存します。 標準的なエージェントセットアップには手作業で作成された設定ファイルは必要ありません。AIのチームメイト設定は手動で作成した a365.config.jsonが必要です。
a365-setup そして、2つのプロビジョニングパスのいずれかにルーティングされます。 選択されたものを完成させ、その後の共有ステップを進めます。
- 標準エージェントで、専用のユーザーアカウントは必要ありません。 エージェントを登録に進んでください。
- AIのチームメイト、つまりそうです。 メッセージと通知を追加するためにスキップ。 このルートにはFrontierプレビュープログラムが必要です。
両方のパスは次に可観測性のための計装に進みます。
エージェントを登録する
a365-setup によって標準エージェント パスにルーティングされた場合は、この手順を完了してください。
スキル:make-a365-agent
このエージェントをエージェント365に登録してください
スキルが完了すると、エージェントはMicrosoft Entraに登録されたブループリント、そこから作成されたエージェントID、必要な権限を持っています。 登録はカタログの可視性を提供します。観測可能性のステップはテレメトリーを追加します。
メッセージや通知の追加
a365-setup によって AI チームメイトのパスに振り分けられた場合は、このステップを完了してください。
スキル:make-ai-teammate
このエージェントにメッセージや通知を追加してください
このスキルはホスティング層とメッセージルーティングを追加し、エージェントを登録します。 その後、Teams、Outlook、Wordコメント、メールを通じてアクセスできます。
Important
このステップでは、エージェントに独自のユーザー アカウント（メールボックスと Teams でのプレゼンスを含む）が付与されます。 この機能はフロンティアプレビュープログラムに参加しているテナントのみが利用可能です。 入居者が登録していない場合はこのステップを省略してください。
オブザーバビリティのための計装
どちらの道でもこのステップを完了してください。 スキルはどのタイプのエージェントを雇っているかを尋ねます。
スキル:instrument-observability
このエージェントに可観測性を加える
促されたら、エージェントが使用する認証モードを選択します:OBO(サインインユーザー代理)、Agentic-User(エージェント自身のユーザーアカウントで、Frontierプレビュープログラムが必要)、またはS2S(サービス間対応、バックグラウンド操作用)。 エクスポーターはエージェントが認証するモードと同じなので、許可モデルに合ったモードを選びましょう。 エージェント の識別性を参照してください。
テスト実行後、エージェントのスパンがMicrosoft Defender、Microsoft Purview、Microsoft 365 管理センターに表示されます。
Important
テレメトリが消えたように見える原因は2つあり、リクエストがHTTP 200を返していてもそのように見えることがあります。 テナント内のユーザーにMicrosoft 365 E7またはMicrosoft Agent 365のライセンスが割り当てられていない場合、そのリクエスト全体が削除されます。SKUが存在するだけでは不十分です。 実行のルートに有効な invoke_agent スパンが存在しない場合、そのスパンは Defender の高度なハンティングで引き続きクエリ可能ですが、3 つの画面のいずれにも表示されません。 ルートスパンは、1つのエージェント呼び出しに対してSDKが送信する最上位スパンです。すべてのツール呼び出しや推論イベントはその中にネストされます。
Microsoft 365 データを接続する
エージェントがMicrosoft 365データを読み取ったり動作したりする場合は、どちらのパスでもこのステップを行ってください。 Work IQツールは権限モデルの委譲が必要なため、観察可能性ステップでS2Sを選択した場合、このステップは自動的に省略されます。
スキル:add-workiq-tools
Work IQ メールとカレンダーを接続する
必要なワークロードをメール、カレンダー、Wordなどで指定してください。 このスキルは対応するWork IQ MCPサーバーを接続し、エージェントは管理者管理下でそのデータにアクセスできます。
Important
Work IQ MCPはプレビュー段階で、Microsoft 365 Copilotライセンスが必要です。 エージェントが Work IQ サーバーを呼び出す前に、グローバル管理者がそれらのサーバーに対する OAuth のアクセス許可を付与する必要があります。 「 ツールの追加および管理」をご覧ください。
ローカルでテストする
もしAIチームメイトの道を進んでいるなら、このステップをクリアしてください。これにはFrontierプレビュープログラムが必要です。 Agents Playgroundはエージェントメッセージングエンドポイントを介して接続するため、標準エージェントには適用されません。
スキル:test-local
このエージェントをローカルでテストしてください
エージェントはローカルのテストハーネスであるAgents Playground上で動作するため、デプロイ前にスモークテストを実施できます。
結果を検証する
エージェントはオンボーディング前と同じように開始・応答し、登録IDでエージェント365に現れるべきです。
もしコーディングアシスタントが内部のAgent 365のValidate and Diagnose機能を公開しているなら、プロジェクトに対してコードレベルのプリフライトを実行するための Agent 365統合の検証 を依頼してください。 計測、Microsoft Entraのアーティファクト、メッセージング、ツールアクセス、関連設定のギャップをチェックします。 この機能は社内で「 a365-code-validator」とも呼ばれ、可用性や正確なルーティングはコーディングアシスタントおよびインストールされたSkillsパッケージに依存します。
展開前に、 Agent 365 SDKの検証チェックリストを必ず確認してください。
Troubleshoot
以下の表を使って、エージェントをエージェント365に接続する際の一般的な問題を特定し、解決してください。
| 症状: | Resolution |
|---|---|
| コーディングアシスタントはコマンドを記述しますが、実行はしません | 端末アクセス可能なモードを使いましょう。 VS Codeではエージェントモードを使いましょう。 AskモードとEditモードはターミナルコマンドを実行できません。 |
| セットアップで不足している Azure の前提条件が報告される |
a365-setupリストにある前提条件を満たしてから、そのスキルを再度実行してください。 |
| ブループリント登録が失敗したり、CLIコマンドが認可エラーを返す | テナント内でエージェントIDの設計図を登録する権限を持つアカウントでサインインしていることを確認してください。 |
| テレメトリは表示されません | テナント内の少なくとも1人のユーザーがMicrosoft 365 E7またはMicrosoft Agent 365ライセンスを割り当てているか確認し、実行がルートで有効なinvoke_agentスパンを出力しているか確認し、選択した認証モードが環境に合っているか確認してください。 コーディングアシスタントにAgent 365との連携を検証してもらいましょう。インストールされたバリデータスキルは計測機器の診断が可能です。 |
| ステップがスキップされたように見える | スキルは状態認識があり、すでに設定されている作業をスキップするため、そのステップはすでに完了している可能性が高いです。 特定のスキルをもう一度実行し、結果を明確に述べてください。 |
| 設定後、設定値を変更する必要があります | もしセットアップが a365.config.jsonを使っているなら、編集して a365 config init -c ./a365.config.jsonを再度実行し、その後該当するスキルを再度実行してください。 |