Miro Microsoft 365 Copilot を使用すると、organizationで Miro からボードのインデックスを作成できます。 コネクタを構成した後、ユーザーは Microsoft 365 Copilot および任意の Microsoft Search クライアントの Miro からこれらのボードを検索できます。
この記事は、Microsoft 365 管理者、または Miro Copilot コネクタを構成、実行、監視するユーザーを対象とします。
機能
- セマンティック検索の機能を使用して Copilot のボードにアクセスします。
- クロール頻度をカスタマイズします。
- Microsoft Copilot Studioからの接続のデータ ソースを使用してエージェントを作成します。
制限事項
- ボード上の付箋、図形、フレーム、テキスト、埋め込みドキュメント内のコンテンツのみがインデックス付けされます。 他のオブジェクトの種類のコンテンツは含まれません。 詳細については、「 開発者向けの Miro ドキュメント」を参照してください。
- コメントや返信のインデックスを作成しません。
前提条件
1. Miro アカウントの開発者チームを作成する
既存の Miro アカウントを作成または使用して Miro にアクセスし、 リンク をクリックして、アクティブな Miro アカウントの開発者チームを作成します。 organizationが Enterprise プラン上にある場合は、エンタープライズ開発者チームに移動します。 詳細については、「 開発者チームの作成」を参照してください。
2. Miro でアプリを作成する
Miro にサインインし、[アプリ] で新しいアプリ を作成します。
3. アプリにアクセス許可を追加する
アプリの構成で作成したアプリに boards:read Read boards you have access to プランを追加する
4. アプリにリダイレクト URL を追加する
アプリの作成ページで、[OAuth2.0 のリダイレクト URL] フィールドに次のリンクを追加します。
M365 Enterprise の場合は、コピーして貼り付けます。
https://gcs.office.com/v1.0/admin/oauth/callbackM365 Government の場合は、コピーして貼り付けます。
https://gcsgcc.office.com/v1.0/admin/oauth/callback
5. アプリをインストールし、資格情報を記録する
[ アプリのインストール] をクリックして OAuth トークンを取得 し、アプリの資格情報から Client ID と Client secret を記録します。
作業の開始
1. 表示名を構成する
表示名は、Copilot の各引用文献を識別するために使用され、ユーザーが関連付けられているファイルまたは項目を簡単に認識するのに役立ちます。 表示名は信頼されたコンテンツも示し、 コンテンツ ソース フィルターとして使用されます。 このフィールドには既定値が指定されます。organization内のユーザーが認識する名前にカスタマイズできます。
2. 会社 ID を追加する
会社 ID (組織 ID とも呼ばれます) は、organizationの Miro アカウントの一意の識別子です。 Miro ダッシュボードを開き、右上隅でプロファイルをクリックし、[設定] を選択し、アドレス バーの URL を確認して、会社 ID が表示されます。
注:
接続で関連付けることができる会社 ID は 1 つだけです。 Miro ワークスペースに複数の会社 ID がある場合は、別の接続を作成します。
3. 認証の種類を指定する
Miro アプリから取得したクライアント ID とクライアント シークレットを入力します。 詳細については、「 OAuth 2.0 と Miro の概要」を参照してください。
4. 限定対象ユーザーにロールアウトする
ロールアウトを広範な対象ユーザーに展開する前に、Copilot やその他の検索サーフェスで検証する場合は、この接続を制限されたユーザー ベースにデプロイします。 詳細については、「 Microsoft 365 Copilot コネクタの段階的ロールアウト」を参照してください。
Miro の接続を作成するには、[ 作成 ] を選択して、Miro アカウントから接続とインデックス ボードを発行します。
アクセス許可、スキーマ、クロール頻度などのその他の設定では、Miro データで最適に動作するものに基づいて既定値が設定されます。
| ユーザー | Description |
|---|---|
| アクセス許可 | データ ソース内のコンテンツにアクセスできるユーザーのみ。 |
| ID のマッピング | Microsoft Entra ID を使用してマップされたデータ ソース ID。 |
| コンテンツ | 説明 |
|---|---|
| プロパティの管理 | 既定のプロパティとそのスキーマをチェックします。 |
| 同期 | 説明 |
|---|---|
| フル クロール | 頻度: 毎日 |
カスタム セットアップ
カスタム セットアップでは、ユーザー、コンテンツ、同期の既定値を編集できます。
ユーザー
アクセス許可
Miro Copilot コネクタは、このデータ ソースへのアクセス権を持つすべてのユーザーまたは唯一のユーザーに表示される検索アクセス許可をサポートします。 [ すべてのユーザー] を選択すると、すべてのユーザーの検索結果にインデックス付きデータが表示されます。 [このデータ ソースへのアクセス権を持つユーザーのみ] を選択すると、インデックス付きデータが検索結果に表示され、アクセス権を持つユーザーが表示されます。
ID のマッピング
Microsoft Entra ID を使用してデータ ソース ID をマッピングする既定の方法は、Miro ユーザーの電子メール ID が、Microsoft Entraのユーザーのユーザー プリンシパル名 (UPN) または電子メールと同じであることを確認することです。 既定のマッピングがorganizationに対して機能しない場合は、カスタム マッピング式を指定できます。 詳細については、「 Azure AD 以外の ID をマップする」を参照してください。
organizationに最適なオプションを特定するには:
- Miro ユーザーの電子メール ID がユーザーの UPN または電子メールと同じ場合は、[Microsoft Entra ID] オプションMicrosoft Entra選択します。
- Miro ユーザーの電子メール ID がユーザーの UPN および電子メールとMicrosoft Entra ID で異なる場合は、[Microsoft Entra以外の ID] オプションを選択します。
コンテンツ
プロパティの管理
Miro データ ソースから使用可能なプロパティを追加または削除するには、プロパティにスキーマを割り当て (プロパティが検索可能、クエリ可能、取得可能、または絞り込み可能かどうかを定義する)、セマンティック ラベルを変更してプロパティにエイリアスを追加します。 既定では、一部のプロパティが選択されています。
| Source プロパティ | Label | 説明 | Schema |
|---|---|---|---|
| Body | 該当なし | 該当なし | 検索 |
| CreatedAt | 作成日時 | データ ソースでアイテムが作成された日付と時刻 | クエリ、取得。 |
| CreatedBy | 作成者 | アイテムを作成したユーザー | クエリ、取得、検索。 |
| 説明 | 該当なし | 該当なし | クエリ、取得。 |
| ID | 該当なし | 該当なし | クエリ、取得。 |
| ModifiedAt | 最終更新日時 | データ ソースでアイテムが最後に変更された日時 | クエリ、取得。 |
| ModifiedBy | 最終更新者 | 最後の変更を行ったユーザー | クエリ、取得、検索。 |
| 名前 | タイトル | Copilot やその他の検索エクスペリエンスに表示するアイテムのタイトル | クエリ、取得、検索。 |
| チーム | 該当なし | 該当なし | クエリ、取得。 |
| ViewLink | url | データソース内のアイテムのターゲット URL | クエリ、取得。 |
データのプレビュー
プレビュー 結果 をクリックして、選択したプロパティとクエリ フィルターのサンプル値を確認します。
同期
更新間隔は、データ ソースと Miro Copilot コネクタ インデックスの間でデータを同期する頻度を決定します。 フル クロール更新間隔のみがサポートされます。 詳細については、「 更新設定」を参照してください。
更新間隔の既定値を変更できます。
トラブルシューティング
一般的なエラーとその解決方法を次に示します。
- 必要なアクセス許可スコープがありません。 Miro アプリで必要なスコープが選択されていることを確認します。
必要なアクセス許可スコープがありません。 アプリ構成のアクセス許可フィールドで boards:read Read boards you have access to が選択されていることを確認します。
- OAuth 2.0 フローに失敗しました。 資格情報を確認し、Miro アプリが正しい設定で構成されていることを確認します。
これは一般的な認証エラーです。 Miro アプリに戻るし、[設定] の OAuth2 が正しく構成されていることを確認します。
- OAuth 2.0 フローに失敗しました。 このチーム アクセス トークンに関連付けられている Miro ユーザーがチーム管理者ロールを保持し、アクティブなユーザーであることを確認します。
これは一般的な認証エラーです。 Miro アプリ コンソールに戻るし、作成者が管理者ロールを持ち、アカウントの状態がアクティブであることを確認します。
- このセッションのセキュリティ資格情報の有効期限が切れています。 戻るし、アプリ キーとアプリ シークレットを使用してもう一度サインインします。
資格情報の有効期限が切れています。 Miro アプリを更新し、[設定] タブから最新のクライアント ID とクライアント シークレットをコピーして認証します。
- 無効な資格情報が検出されました。 資格情報を確認し、Miro アプリのアクセス許可スコープをチェックします。
これは一般的な資格情報エラーです。 Miro アプリに戻るし、[アクセス許可] のスコープが正しく構成されていることを確認します。
次の手順
接続を発行したら、管理センターの [コネクタ] セクションで状態を確認できます。 詳細については、「 コネクタの管理」を参照してください。
問題がある場合、またはフィードバックを提供する場合は、「 Microsoft Graph サポート」を参照してください。