エージェント365のガイド付きエージェント設定スキル

Agent 365 Skillsは、サポートされたコーディングアシスタントから既存エージェントをエージェント365に接続するためのガイド付きセットアップパスを提供します。 この エージェントに観測可能性を追加するなど、望む結果を指定すると、スキルがプロジェクトを特定し、必要な値を収集し、統合を変更し、結果を確認します。

スキルはClaude Code、GitHub Copilot CLI、VS Codeエージェントモードを含むすべてのコーディングエージェントで実行されます。

スキルをインストールし、エージェントのオンボーディングパスを進めるには、「 クイックスタート:既存のエージェントをエージェント365に接続する」をご覧ください。

Note

スキルは、以前の instructions.md ファイルを使っていたセットアップワークフローに代わるものです。

スキルを使うタイミング

既存のエージェントをエンタープライズのアイデンティティ、可観測性、ガバナントツール、通知に接続するには、いくつかの順序づけられたセットアップステップが必要です。 これらのステップには、Agent 365 CLIのインストール、Azureの前提条件の検証、ブループリントの登録、Entraリソースの設定、OpenTelemetryエクスポーターの配線、Model Context Protocol(MCP)サーバーの接続、ローカルでのテストが含まれます。

スキルは選択した経路の必要な順序でこれらのステップを実行し、その結果のプロジェクトを検証します。

スキルの運用方法

各スキルは同じワークフローに従っています:

  1. 望む結果を述べてください。
  2. スキルがプロジェクトスタックと既存の構成を特定します。
  3. 認証モードなど、要求される値を提供します。
  4. コード、マニフェスト、設定の変更を確認しましょう。
  5. プロジェクトがまだビルドされ、統合が正常に動作しているかを確認してください。

利用可能なエージェント365スキル

a365-setup は入口です。 前提条件を検証した後、2つのルートのいずれかに誘導され、そのルートだけをたどります。

  • 標準的なエージェントです。 a365-setup は make-a365-agent に委譲します。 エージェントが自分のユーザーアカウントを必要としない場合にこのパスを使います。 標準エージェントはOBOまたはS2Sで認証されるため、サインイン済みユーザーの代わりに動作でき、またはユーザーなしで実行できます。
  • AIのチームメイト。 a365-setup エージェントが自分のユーザーアカウントを必要とする場合、 make-ai-teammateに委任します。 AIのチームメイトがそのユーザーアカウント(Agentic-User)として認証されます。 このルートにはFrontierプレビュープログラムが必要です。

パスと認証モードを選択するには、 エージェントの種類と認証モードを参照してください。

Skill Purpose
a365-setup Agent 365 CLIをインストールし、Azureの前提条件を検証し、エージェントスタックを検出します。 標準エージェントの場合、エージェントが OBO と S2S のどちらで認証するかを指定します。 次に、 make-a365-agent か make-ai-teammateに委任します。
make-a365-agent 独自のユーザーアカウントを必要としない標準エージェントをプロビジョニングします。 Microsoft Entraでエージェント ID ブループリントを登録し、そこからエージェント ID を作成し、エージェントに必要な Entra ID 権限(OBO 用の委任された権限または S2S 用のアプリケーション権限)を構成します。 さらに、オブザーバビリティやツールをアドオンとして提供します。
make-ai-teammate エージェントをAIチームメイトに変え、専用のユーザーアカウントを持つ。 エージェント識別設計図を登録し、そこからエージェント識別を作成し、その後ホスティングレイヤー、メッセージルーティング、通知を追加します。 a365-setup が先に実行されている必要があります。
instrument-observability OpenTelemetry と Agent 365 のトレース エクスポーターを組み込み、エージェント スパンが Microsoft Defender、Microsoft Purview、Microsoft 365 管理センターに届くようにします。 OBO、S2S、Agentic-Userをサポートしています。 a365-setup がまだ記録していなければ、エージェントの種類と認証モードを尋ねます。
a365-code-validator 既存のAgent 365統合の検証と診断を行い、計装、Microsoft Entraのアーティファクト、メッセージング、ツールアクセス、関連設定を含みます。 既定では読み取り専用です。 instrument-observabilityを使ってゼロから観測性を追加しましょう。
add-workiq-tools Mail、カレンダー、Wordを含むWork IQ MCPサーバーを接続し、エージェントがMicrosoft 365データを読み取って操作できるようにします。 権限の委譲モデルが必要で、認証モードがS2Sの場合は自動的にスキップされます。
purview-dlp-integration Microsoft Graph processContentを用いてエージェントのLLM呼び出し前にMicrosoft Purviewデータ損失防止(DLP)チェックを追加し、オプションで応答監査も可能です。 ガイド グラフ権限とDLPポリシーの設定。
test-local AIチームメイトエージェントをローカルで実行し、クラウド展開なしでインタラクティブテストのためにAgents Playgroundを開放します。 AIの味方ルートに当てはまります。

Important

make-ai-teammate エージェントに専用のユーザーアカウント、メールボックスやTeamsプレゼンスを付与します。 この機能はフロンティアプレビュープログラムに参加しているテナントのみが利用可能です。

通常、スキルを発動するには、そのスキルの名前を言うのではなく、結果を述べて発動します。 例えば、 このエージェントに観測可能性を加え て実行 instrument-observability。 コーディングアシスタントが内部 a365-code-validator 機能の公開を行った場合は、 このAgent 365統合の検証を依頼してください。この機能は内部で「Validate and Diagnose」とも呼ばれます。 可用性と呼び出しはアシスタントとインストールされているスキルパッケージに依存します。 各ステップで使用されたリクエストフレージングについては、「 Quickstart: Agent 365に既存エージェントを接続する」をご覧ください。

エージェントの種類と認証モード

スキルは標準エージェントとAIチームメイトの両方をセットアップします。 パスはエージェントが利用可能な認証モードを決定します。 認証モードは、Agent identity では実行モードと呼ばれ、Microsoft Graph や MCP サーバーなどのダウンストリーム サービスを呼び出す際にエージェントが誰として動作するかを決定します。

認証モード Path エージェントは~として動作します 次の場合に使用します。
OBO (代理) 標準エージェント サインイン済みユーザーで、委任されたアクセス許可を持つ エージェントはユーザーのカレンダーを読み込んだり、メールを送信したりするなど、ユーザーのコンテキストで動作します。
S2S (サービス間) 標準エージェント 独自のエージェントIDとアプリケーション権限を持つ エージェントは、スケジュールされたタスク、監視、バックグラウンド処理など、サインイン済みユーザーなしで動作します。
エージェントユーザー AI チームメイト 独自のユーザー アカウント エージェントは独自のメールボックス、Teams プレゼンス、またはその他の Microsoft 365 の各種ユーザー向け機能が必要です。 Frontierプレビュープログラムが必要です。

標準的なエージェントの場合、a365-setup はエージェントが OBO を使うか S2S を使うかを尋ね、後のスキルでその回答が再利用されます。 AIのチームメイトはいつもAgentic-User,を使うので、a365-setupは質問しません。 スキルは各エージェントごとに1つのモードを設定します。 エージェントが委任権限とアプリケーション権限の両方を必要とする場合は、Agent 365 CLI で a365 setup all --authmode both を実行します。 各モードが要求する役割については、Agent identity grantsを参照してください。

認証モードによって、スキルで設定される内容が変わります:

  • make-a365-agentは--authmode s2sまたはa365 setup allと共に--authmode oboを実行します。 OBO はエージェント ID に委任権限を与え、S2S はそれにアプリケーション権限を割り当てます。
  • instrument-observability すべてのモードで S2S ルート経由でアプリ専用トークンでテレメトリをエクスポートするため、登録エージェントインスタンスは観測権限や管理者の同意を必要としません。 OBOやAgentic-Userの場合、スキルはホスト接続のブループリント認証を再利用してエージェントがトークンを取得するように設定します。 S2Sでは、.NET、Node.js、Pythonエージェントのためにトークンを取得し更新するトークンサービスが追加されています。 S2S を使用して Agent 365 を有効にするを参照してください。
  • add-workiq-tools 委託されたユーザートークンが必要なため、OBO や Agentic-User では動作しますが、S2S では動作しません。 S2Sを選択すると、a365-setupは選択した機能からWork IQを削除します。
  • purview-dlp-integration エージェント型の委任認証をサポートします。 S2Sでは、クライアントシークレットのFederated Managed Identity(FMI)認証を使用する Node.js エージェントのみをサポートします。
  • test-local はAIチームメイトにのみ適用されます。

対応スタック

スキルは自動的にプロジェクトスタックを検出するため、手動でプロジェクトをマッピングする必要はありません。 これらはスキルが検出するスタックです。 SDKは他のフレームワークとも連携しています。

Language フレームワーク
.NET Microsoft Agent Framework, Semantic Kernel, Azure AI Foundry
Node.js LangChain、OpenAI Agents SDK、Claude Agent SDK、Semantic Kernel、Google ADK
Python Microsoft Agent Framework、LangChain、OpenAI Agents SDK、Claude Agent SDK、Semantic Kernel、Google ADK

安全性と再現性

スキルは、プロジェクトの既存の動作を変えずにセットアップの変更を適用するよう設計されています。 この動作は Agent 365のSDK検証チェックリストで確認してください。

  • 加法的かつ冪等。 スキルは既存のコードを削除したり再構成したりせず、スキルをやり直しても完成した作業が重複しません。
  • 国家意識。 スキルはすでに接続されているものを感知するため、完了した手順を繰り返すのではなくスキップします。
  • 手すりが設置されている。 スキルはプロジェクト外のファイルを改変せず、完成前にビルドが通過したことを確認します。

スキルを使う場合:

  • 既存のエージェントがいて、手作業で統合を書かずにオンボーディングしたい場合もあります。
  • 開発ワークフローにはすでにコーディングアシスタントが含まれています。
  • プロジェクト間で一貫性があり、繰り返し可能なオンボーディングが望ましいです。

手動セットアップは以下の時に使います:

  • あなたの環境は標準的ではなく、各ステップごとに個別のコントロールが必要です。
  • あなたの組織はコーディングアシスタントのワークフローを制限しています。
  • トラブルシューティングをして、各ステップを自分で実行したいのです。

手動の手順については、クイックスタートのセットアップ手順を使い ましょう:既存のエージェントをAgent 365に接続し、環境に合わせた同等の Agent 365のCLI コマンドを実行します。