Miro Microsoft 365 Copilot コネクタを使用すると、ユーザーが Microsoft 365 エクスペリエンス内で直接 Miro コンテンツを検出、アクセス、使用できるように、organizationで Miro ボードのインデックスを作成できます。 この記事では、Miro コネクタをデプロイしてカスタマイズする手順について説明します。
Miro 構成情報については、「 コネクタ インジェスト用に Miro サービスを設定する」を参照してください。
前提条件
コネクタをデプロイする前に、次の前提条件を満たしていることを確認してください。
- Microsoft 365 管理者です。
- Miro サービスの構成手順を完了しました。
- Miro クライアント ID、 クライアント シークレット、 および会社 ID を記録しました。
- Miro ユーザー アカウントには、必要な管理者ロールがあります。
コネクタをデプロイする
organizationの Miro コネクタを追加するには:
- Microsoft 365 管理センターの左側のウィンドウで、[Copilot>Connectors] を選択します。
- [ ギャラリー ] タブを選択します。
- コネクタの一覧から [ Miro] を選択します。
表示名を設定する
表示名は、Copilot 応答の参照を識別するために使用されます。 表示名は、ユーザーが信頼されたコンテンツを認識し、コンテンツ ソース フィルターとして機能するのに役立ちます。
既定の Miro 表示名を使用するか、organizationのユーザーが認識する名前にカスタマイズできます。
会社 ID の設定
会社 ID (組織 ID) は、organizationの Miro アカウントの一意の識別子です。 Miro ダッシュボードで設定を表示すると、URL に表示されます。 コネクタを構成するときは、この識別子を使用します。
注:
接続を関連付けることができるのは、1 つの会社 ID のみです。 Miro ワークスペースに複数の会社 ID が含まれている場合は、それぞれに個別の接続を作成します。
認証の種類を選択する
コネクタは OAuth 2.0 認証を使用します。
Miro アプリの次の認証値が必要です。
- クライアント ID
- クライアント シークレット
これらの値を追加し、[承認] を選択 します。
詳細については、「 OAuth 2.0 と Miro の概要」を参照してください。
ロールアウト
広範にデプロイする前に、コネクタを限定された対象ユーザーにロールアウトできます。 制限付き対象ユーザーにロールアウトするには、[ロールアウト] の横にある [ 制限対象ユーザー] の横にあるトグルを選択し、ユーザーとグループを指定します。
[ 作成] を 選択して接続をデプロイします。 Miro Copilot コネクタは、コンテンツのインデックス作成をすぐに開始します。
次の表に、設定される既定値を示します。
| カテゴリ | 既定値 |
|---|---|
| ユーザー | アクセス許可: データ ソース内のコンテンツにアクセスできるユーザーのみ マップ ID: Microsoft Entra ID を使用してマップされたデータ ソース ID |
| コンテンツ | プロパティの管理: 既定のプロパティとスキーマが適用されます。 |
| 同期 | フル クロールの頻度: 毎日 |
これらの値をカスタマイズするには、[ カスタム セットアップ] を選択します。 詳細については、「設定の カスタマイズ」を参照してください。
接続を作成したら、Microsoft 365 管理センターの [コネクタ] セクションでその状態を確認できます。
設定のカスタマイズ (省略可能)
Miro コネクタ設定の既定値をカスタマイズできます。 設定をカスタマイズするには、管理センターのコネクタ ページで [ カスタム セットアップ] を選択します。
ユーザー設定をカスタマイズする
アクセス許可
Miro コネクタでは、次に示す検索アクセス許可がサポートされています。
- すべてのユーザー
- このデータ ソースにアクセスできるユーザーのみ
[ すべてのユーザー] を選択すると、すべてのユーザーの検索結果にインデックス付きデータが表示されます。 [このデータ ソースへのアクセス権を持つユーザーのみ] を選択すると、インデックス付きデータが検索結果に表示され、アクセス権を持つユーザーが表示されます。 organizationのニーズに基づいて適切なスコープを選択します。
ID のマッピング
既定の ID マッピングでは、Miro ユーザーの電子メール ID が、Microsoft Entra ユーザー プリンシパル名 (UPN) または電子メールと一致することを確認します。
既定のマッピングがorganizationに対して機能しない場合は、カスタム マッピング式を指定できます。 詳細については、「 Entra 以外の ID をマップする」を参照してください。
organizationに最適なオプションを特定するには:
- Miro ユーザーの電子メール ID が、Microsoft Entra IDのユーザーの UPN または電子メールと同じである場合は、Microsoft Entra ID オプションを選択します。
- Miro ユーザーの電子メール ID が、Microsoft Entra IDのユーザーの UPN および電子メールと異なる場合は、[非Microsoft Entra ID] オプションを選択します。
コンテンツ設定をカスタマイズする
プロパティの管理
Miro データ ソースから使用可能なプロパティを追加または削除するには、プロパティにスキーマを割り当て (プロパティが検索可能、クエリ可能、取得可能、または絞り込み可能かどうかを定義する)、セマンティック ラベルを変更してプロパティにエイリアスを追加します。 次の表は、コネクタが既定でインデックスを作成するプロパティの一覧です。
| プロパティ | セマンティック ラベル | 説明 | スキーマ属性 |
|---|---|---|---|
| Body | 該当なし | 該当なし | 検索 |
| CreatedAt | 作成日時 | アイテムが作成された日付と時刻 | クエリ、取得 |
| CreatedBy | 作成者 | アイテムを作成したユーザー | クエリ、取得、検索 |
| 説明 | 該当なし | 該当なし | クエリ、取得 |
| ID | 該当なし | 該当なし | クエリ、取得 |
| ModifiedAt | 最終更新日時 | アイテムが最後に変更された日付と時刻 | クエリ、取得 |
| ModifiedBy | 最終更新者 | 最後の変更を行ったユーザー | クエリ、取得、検索 |
| 名前 | タイトル | Copilot と検索に表示されるタイトル | クエリ、取得、検索 |
| チーム | 該当なし | 該当なし | クエリ、取得 |
| ViewLink | URL | データ ソース内のアイテムのターゲット URL | クエリ、取得 |
[ 結果のプレビュー ] を選択して、選択したプロパティとクエリ フィルターのサンプル値を確認します。
同期間隔をカスタマイズする
同期間隔は、Miro データ ソースとインデックスの間でデータを同期する頻度を決定します。 フル クロール更新間隔のみがサポートされます。 必要に応じて既定値を調整できます。
詳細については、「 同期設定のガイドライン」を参照してください。