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

コメント