この記事では、IT 管理者が Microsoft Copilot を検出ソースとして Josys に連携し、AI エージェント画面でエージェントを可視化するための手順を説明します。この設定は、標準の Microsoft 365 連携を前提としています。Copilot Studio のエージェントは Josys がすでに同期している Microsoft 365 の ID データとは別に Power Platform 環境に保存されているため、標準連携に加えて追加の Microsoft 同意と Power Platform アプリケーションユーザーの設定が必要です。
概要
この記事では、IT 管理者が Microsoft Copilot を検出ソースとして Josys に連携し、AI エージェント画面でエージェントを可視化するための手順を説明します。
この設定は、標準の Microsoft 365 連携を前提としています。Copilot Studio のエージェントは Josys がすでに同期している Microsoft 365 の ID データとは別に Power Platform 環境に保存されているため、標準連携に加えて追加の Microsoft 同意と Power Platform アプリケーションユーザーの設定が必要です。
参考:AIエージェント機能について
想定読者
従業員の作成したAIエージェントを管理したいJosysのIT管理者
連携された後の画面サンプル
連携が完了すると、指定した Power Platform 環境内の Copilot Studio エージェントが Josys の AI エージェント画面に表示されるようになります。
前提条件
- Josysのスーパーアドミン権限をお持ちの方が連携をしてください。
- Josys での Microsoft 365 とのアプリ連携が完了している必要があります。
未完了の場合は、既存のヘルプセンター記事を先に参照してください - テナントレベルの管理者同意を付与できる Microsoft 365 管理者アカウントで連携してください。
- Copilot Studio エージェントが作成されている環境への Power Platform 管理者または環境管理者のアクセス権を保持している必要があります。
- 連携対象の Power Platform / Dataverse 環境が特定されていること(Copilot Studio は複数環境をサポートしているため、Josys が検出すべきエージェントを含む環境を事前に確認してください)
- Josys アプリケーションユーザーへのセキュリティロールの作成をしてください。
最小権限のカスタムロールには、bot・botcomponent・systemuserテーブルへの読み取りアクセスが必要です。システム管理者ロールは一時的なテスト目的のみで使用してください
手順
前提
Josys で Microsoft 365 のアプリ連携を完了させてください。
詳細はこちらのヘルプセンター記事を参照してください。
1.Microsoft Copilot 検出ソースの設定を開始する
- Josys の左メニューから、AIエージェントをクリックしてください。
- Josys の左メニューから、「連携>マスタ連携」をクリックしてください。
- AIエージェントタブを開いてください。
- Microsoft Copilotの「連携」ボタンをクリックしてください。
- 別ウィンドウでMicrosoftへのログイン画面が開きます。
- ログインすると、権限確認のページが開きます。
最下部にある承認ボタンをクリックしてください。
2.環境 URL(インスタンス URL)を取得する
- 同意が完了すると Josys の設定フローに戻り、テナント ID が自動入力されています。
- Copilot Studioにログインしてください。
- 右上の設定ボタンをクリックし、「Session Details」をクリックしてください。
- 「Power Platform 環境の詳細」セクションが表示されます。
「Instance URL」の値をコピーしてください。 - Josysに戻り、環境 URL フィールドに貼り付けてください。
- 右下の「送信」ボタンをクリックしてください。
- 完了した旨ポップアップが表示されたら完了です。
- ✅ 使用する値:インスタンス URL(例:
https://<environment>.crm7.dynamics.com/) - ❌ 使用しない値:Copilot Studio のホスト名(例:
web.powerva.microsoft.com) - ❌ 使用しない値:環境 ID(例:
Default-<tenant-guid>)
3.Power Platform 環境にアプリケーションユーザーを作成する
-
Microsoftが提供しているヘルプページのアプリケーション ユーザーの作成セクションを見ながら、アプリケーションユーザーを作成してください。
アプリケーション IDは、c87fae47-ccbe-408a-94ff-7633fec85801です。
Josys / AgentBuilderApp を検索して追加してください。 - 任意でビジネスユニットを選択してください。
- セキュリティロールを割り当て、アプリケーションユーザーを作成を完了してください。
| フィールド | 推奨値 |
|---|---|
| アプリ | 名前またはアプリケーション ID で選択した Josys / AgentBuilderApp |
| 名前 | 「Josys Agent Discovery Reader」など、識別しやすい名前 |
| ビジネスユニット | 既定のビジネスユニット(管理者から別途指定がある場合を除く) |
| セキュリティロール | Copilot 発見用のカスタム読み取り専用ロール(検証目的の場合のみ一時的にシステム管理者も可) |
4.セキュリティロールを割り当てる
検知に必要な権限は、bot・botcomponent・systemuser への読み取りです。
これらを付与したロールを割り当ててください。
5.Josys で連携を完了する
-
Josys の AI エージェント 画面に対象環境のエージェントが表示されます。
Copilot StudioのAI Agents内に登録されているエージェントが対象です。表示されない場合は右上の更新ボタンを実行し、ページをリロードしてください
- カーソルを合わせると、「詳細を見る」ボタンが表示されます。
クリックすると詳細が確認可能です。最終アクティブ日はCopilotStudio>Agents内の「Last modified」を取得しています。
よくある質問(FAQ)
この設定は誰が行いますか?
Josys 管理者が設定を開始します。Microsoft テナント管理者が同意を付与し、Power Platform 管理者または環境管理者がアプリケーションユーザーの作成とセキュリティロールの割り当てを行います。
通常の Microsoft 365 連携だけでは不十分ですか?
はい。通常の連携は出発点として必須ですが、エージェントの検出には追加の同意と Power Platform アプリケーションユーザーの設定が別途必要です。
テナント ID はなぜ自動入力されるのですか?
管理者の同意完了後に Microsoft がテナント識別子を返します。Josys はこれを使って検出ソースを正しい Microsoft テナントに関連付けます。
環境 URL とは何ですか?
エージェントが作成されている Power Platform 環境の Dataverse インスタンス URL です。Copilot Studio の「Session details」に「Instance url」として表示されます。
環境 ID を貼り付けてもよいですか?
いいえ。環境 ID と環境 URL は別の値です。https://<environment>.crm*.dynamics.com/ 形式の URL を貼り付けてください。
どのセキュリティロールを使用すべきですか?
本番環境では必要なテーブル権限を持つカスタム読み取り専用ロールを使用してください。システム管理者ロールを本番環境のデフォルトとして使用しないでください。
エージェントが表示されない場合は?
対象の Copilot Studio 環境・インスタンス URL・アプリケーションユーザー・割り当てられたロール、およびエージェントが別の Power Platform 環境に作成されていないかを確認してください。