この記事では、Agent 365 SDKに関するよくある質問に答えます。何をし、何をしないのか、いつ必要とされるのか、利用可能な機能、アイデンティティの仕組み、そして統合の検証方法についてです。
範囲と位置
Agent 365 SDKでエージェントをビルドできますか?
No. SDKはエージェント構築フレームワークではありません。 選択したフレームワークでエージェントを構築し、Agent 365 SDKを使ってAgent 365に取り込みます。 Agent 365 SDKの使用時をご覧ください。
SDKは言語モデル呼び出しを行ったり、手順をオーケストレーションしたりしますか?
No. エージェントは引き続き独自のモデルコールを行い、オーケストレーションはフレームワークやランタイム内に留まります。 Agent 365 SDKとエージェントエコシステムをご覧ください。
SDKは私のエージェントをホストしているのか、それともデプロイしているのか?
No. あなたのエージェントは今日どこへでも走ります。 「 Agent 365 SDKはどう違うのか?」をご覧ください。
SDKはエージェントのツール呼び出しを実行しますか?
No. SDKはモデルコンテキストプロトコル(MCP)サーバーを管理するレジスタです。実行は実行時間内に留まります。 Agent 365 SDKとエージェントエコシステムをご覧ください。
SDKは私のエージェントフレームワークに代わるのでしょうか?
No. モデル、フレームワークまたはランタイム、そしてホストは保持してください。 SDKはそれらと並行して動作し、アイデンティティ、観察可能性、ツール、通知を追加します。 レイヤーごとの境界については、 Agent 365 SDKの概要をご覧ください。
Agent 365 SDKはMicrosoft 365 エージェント SDKとどう違うのでしょうか?
Microsoft 365 エージェント SDKは、チャネル接続や会話状態を扱う会話型エージェントを構築します。 Agent 365 SDKは、すでに構築したエージェントを拡張します。 二人は協力して働いています。 Agent 365 SDKの概要をご覧ください。
SDKはどの言語をサポートしていますか?
Python、JavaScript、.NETです。 Agent 365のSDKパッケージを参照してください。
積分メカニズムの選択
SDKは必要ですか?
必ずしもそうではありません。 組み込みの統合やレジストリ同期がすでにエージェントに必要な機能を提供しているなら、SDKは不要かもしれません。 「 統合オプションを選ぶ」をご覧ください。
組み込みの統合はいつ十分でしょうか?
プラットフォームパスがすでにシナリオに必要なAgent 365機能を提供している場合。 Copilot StudioやAzure AI Foundryはこのカテゴリに該当しますが、サポートはエージェントの構築、認証、ホスティングの方法に依存します。 コードを所有またはデプロイすること自体がSDKを必要としません。 Compare Agent 365の統合メカニズムを参照してください。
レジストリ同期とSDK連携の違いは何ですか?
レジストリ同期は、Google Vertex AIやAmazon Bedrockなどの接続されたエージェントプラットフォームから、プラットフォームレベルの構成を通じてエージェントをAgent 365に引き寄せます。 SDK統合はエージェントSDKやフレームワークで構築したエージェント用で、コードレベルでのコントロールを可能にします。 Compare Agent 365の統合メカニズムを参照してください。
私のエージェントはAzureの外で動いています。 SDKはまだ使えますか?
Yes. SDKはエージェントの実行先を変えません。 Azure、AWS、Google Cloud、またはオンプレミスでホストされているエージェントと連携します。 Agent 365 エージェント開発ライフサイクルを参照してください。
能力
4つの機能すべてを採用しなければならないのでしょうか?
いいえ、でも前提条件はあります。 エージェント識別設計図は、アイデンティティ、ツール、通知機能の基盤であり、通知にはさらにエージェントのユーザーアカウントが必要です。これはFrontierプレビュープログラムに参加するテナントのみが利用可能です。 Observabilityは標準的なMicrosoft Entraアプリ登録でも動作します。 それ以外は、どの順番でも能力を追加してください。 「 通知確認」を参照してください。
どの能力から始めるべきでしょうか?
アイデンティティ。 登録はエージェント365でエージェントを見えるものにするので、そこから始めましょう。 次に、運用上の可視性が必要なときにオブザーバビリティを追加しましょう。 可観測性については「エージェントと計器の登録」を参照してください。
私のテレメトリーはどこに行くのでしょうか?
エージェントのスパンはMicrosoft Defender、Microsoft Purview、Microsoft 365 管理センターに存在します。
テレメトリが消えたように見える原因は2つありますが、取り込みはHTTP 200を返します。
テナント内のユーザーにMicrosoft 365 E7またはMicrosoft Agent 365のライセンスが割り当てられていない場合、そのリクエスト全体が打ち切られます。
ルートに有効なinvoke_agentスパンがない場合、そのスパンは高度な狩猟Defenderクエリ可能ですが、3つのサーフェスには現れません。
データが表示される 場所 や 制限・ドロップ条件を確認してください。
Work IQ とは
Work IQは、Mail、カレンダー、Word、SharePoint、TeamsなどのMicrosoft 365ワークロードを管理者管理下のエージェントに公開する、管理されたMCPサーバーのセットです。 Work IQ MCPはプレビュー段階で、Microsoft 365 Copilotライセンスが必要です。 詳細は 検証ツールを参照してください。
どの通知ソースがサポートされていますか?
Teams、Outlook、Wordのコメント、メール。 通知にはエージェントのユーザーアカウントが必要で、これはFrontierプレビュープログラムに参加しているテナントのみが利用可能です。 通知 の種類 と 通知の確認を参照してください。
Identity
エージェントは独自のアイデンティティが必要ですか?
すべてのAgent 365統合にはアイデンティティモデルが必要ですが、それが必ずしもエージェントに独自のユーザーアカウントを与えることを意味するわけではありません。 エージェントはS2SをエージェントIDとして、OBOでサインインしたユーザーの代理として行動し、Agentic-User 自身のMicrosoft Entraユーザーアカウントを通じて行動することができます。 エージェントの作業内容、権限、必要なMicrosoft 365リソースに合致するモードを選択します。 エージェント の識別性を参照してください。
エージェント・アイデンティティ・ブループリントとエージェント・アイデンティティの違いは何ですか?
ブループリントは、ある種のエージェントの認証情報と宣言された権限を保持する再利用可能なテンプレートです。 エージェントのアイデンティティとは、個々のエージェントが認証するアカウントのことです。 一つの設計図で多くのエージェントのアイデンティティを作成できます。 Identity Objects および S2S、Blueprint derived agent identity を参照してください。
私のエージェントの資格情報はどこに保存されていますか?
設計図に、エージェントの身分に載っているわけじゃない。 破損した設計図は、そこから生成されるすべてのエージェントに影響を与えるため、設計図の数をセキュリティ境界の決定とみなしてください。 エージェント の識別性を参照してください。
設計図は何枚作ればいいですか?
必要なだけ資格と許可の境界線を分けておきましょう。 設計図の認証情報や継承権限を安全に共有できるグループオンリーエージェントのアイデンティティ。 「 アイデンティティ基盤 」および 「S2S、ブループリント由来エージェント・アイデンティティ」を参照してください。
どのアクセス許可モデルを使用する必要がありますか?
サービス間作業のアプリケーション権限、エージェントが自身の権限で動作する場合。 エージェントがサインインしたユーザーの権限やコンテキストを操作する、代理業務用の委任権限。 エージェント の識別性を参照してください。
私のエージェントはMicrosoft 365ライセンスが必要ですか?
エージェントのユーザーアカウントを持ち、Teams、Exchange、SharePointなどのサービスが必要な場合のみです。 独自のユーザーアカウントを持つエージェントは、Frontierプレビュープログラム内のテナントのみが利用可能です。 テナントレベルのライセンスは他の機能にも適用されます。テレメトリは、テナント内の少なくとも1人のユーザーがMicrosoft 365 E7またはMicrosoft Agent 365のライセンスを割り当てていない限り終了し、Work IQ MCPはMicrosoft 365 Copilotライセンスが必要です。 エージェント のユーザーアカウント、 Verify idid、 Verify observability、 Verify ツールを参照してください。
なぜ私の代理人の郵便受けがまだ使えないのですか?
リソースプロビジョニングはライセンス割り当てを遅らせることがあります。 予想されるタイミングについては Agent 365 SDK検証チェックリスト をご覧ください。
スポンサーって何?
エージェントの目的とライフサイクルに責任を持つビジネス代表者。 エージェント ID とエージェント ID ブループリントごとに少なくとも 1 つのスポンサーが必要です。 セキュリティチームは、インシデント時に責任ある担当者に連絡を取るためにスポンサーを利用します。 ス ポンサー と 本人確認をご覧ください。
セットアップとスキル
エージェント365のスキルとは何ですか?
GitHub Copilot CLIのようなコーディングアシスタントに統合ステップを代行してもらう方法もあります。 エージェント 365スキルを参照してください。
instructions.md セットアップのワークフローに代わったものは何ですか?
Agent 365 Skillsがそのワークフローに代わりました。 代わりにスキルを使いましょう。
もしコーディングアシスタントが内部のValidate and Diagnose機能を公開しているなら、Agent 365の統合を検証するよう依頼できます。内部では a365-code-validatorとも呼ばれています。
利用可能状況はアシスタントとインストールされているSkillsパッケージによって異なります。 エージェント 365スキルを参照してください。
スキルを使う必要がありますか?
No. 各ステップを手動で行うこともできます。 スキルは標準的なセットアップと繰り返し可能なオンボーディングに適しています。手動セットアップは非標準的な環境やトラブルシューティングに適しています。 スキル を使うタイミングを確認してください。
同じスキルを複数回使っても安全ですか?
Yes. スキルは加算的かつ冪元的なので、完了したステップは重複せずスキップされます。 安全性 と再現性を参照してください。
あるスキルがステップを飛ばしたように見えた。 それは問題ですか?
通常はそうではありません。 スキルはすでに設定済みの作業をスキップします。 確認したいなら、そのスキルをもう一度実行し、結果を明確に述べてください。 安全性 と再現性を参照してください。
クラウドにデプロイする前にテストしてもいいですか?
AIチームメイトルートでは、はい。
test-localスキルは、エージェントを地元のテストハーネスであるAgents Playgroundと並行して煙のテストを行うことです。
Agents Playgroundはエージェントメッセージングエンドポイントを介して接続するため、標準エージェントには適用されません。
エージェント・プレイグラウンドの「7つのスキル」と「テストエージェント」を参照してください。
Validation
統合がうまくいったかどうか、どうやって確認すればいいですか?
Agent 365のSDK検証チェックリストを進めてください。
私のエージェントは統合後に違う行動をします。 問題が発生しましたか?
SDKはエージェントの一部を置き換えるのではなく、拡張するものです。 デプロイ前に動作の変化があれば調査してください。生成コード、依存関係の競合、設定、SDKの互換性などが原因として考えられます。 まずは 既存の行動を確認することから始めましょう。