1. Foundryエージェントの呼び出し
Microsoft Foundryで作成したAIエージェントは、WebアプリなどからAPI経由で呼び出すことができます。
エージェントがSharePointやOutlookなどのMicrosoft 365リソースにアクセスする場合、Microsoft Graph APIを利用できます。
エージェントを呼び出すAPI(本記事ではAPI①とする)と、エージェントがリソースを操作する際に呼び出すAPI(Graph API、本記事ではAPI②とする)は別物という点です。
2. Graph API(API②)への2つのアクセス方式
| 方式 | アクセス権限 |
|---|---|
| 委任されたアクセス許可(Delegated) | ユーザーの権限とアプリに付与されたアクセス許可の範囲 |
| アプリケーションのアクセス許可(Application) | アプリケーション自身に付与された権限の範囲 |
例えば、SharePointのファイルを読み取る場合、Delegatedではユーザー本人がアクセスできるファイルに限定されます。
一方、Applicationではユーザーの権限とは独立して、アプリケーションに許可された範囲でアクセスします。
3. Delegatedを実現するOBOフロー
OBO(On-Behalf-Of)とは、ユーザーの代理として別のAPIにアクセスするための認証フローです。
例えば、ユーザーAがWebアプリからFoundryエージェントを利用する場合、次のような流れになります。
- ユーザーAがWebアプリにサインインする。
- WebアプリがユーザーAのアクセストークンを取得し、エージェント側のバックエンドに渡す(ここで、API①が使われる)
- バックエンドがOBOフローを利用し、Graph API用のアクセストークンを取得する。
- 取得したトークンでGraph API(API②)にアクセスし、SharePointのファイルを読み取る。
OBOによって、ユーザーAの権限を引き継いだアクセスが可能になります。
ただし、WebアプリからFoundryエージェントをAPI(API①)で呼び出すだけでは、OBOは自動的に実行されません。
Foundryの対応する認証機能やバックエンド側での実装・設定が必要です。


コメント