Dropbox Microsoft 365 Copilot コネクタを使用すると、M365 のorganizationで、Microsoft Copilotと検索を使用して Dropbox 内の誰でもアクセスできるファイルにインデックスを付けることができます。
この記事は、Microsoft 365 管理者、または Dropbox Copilot コネクタを構成、実行、監視するユーザーを対象とします。
機能
- セマンティック検索の機能を使用して Dropbox ファイルにアクセスする
- organizationによって定義されたアクセス制御リスト (ACL) を保持する
- クロール頻度をカスタマイズする
- この接続とプラグインを使用してMicrosoft Copilot Studioからワークフローを作成する
制限事項
- フォルダー、コメント & 返信はインデックス作成できません
前提条件
Dropbox Copilot コネクタを作成する前に、次の作業を行う必要があります。
1. チーム管理者ユーザーを設定する
ビジネス向け Dropbox アカウントを作成し、チーム管理者ユーザーを設定しました。
2. Dropbox アプリを構成する
一意のアプリ名、アクティブ化されたスコープ アクセス、フル Dropbox のアクセス許可を使用して Dropbox アプリを構成しました。
アプリの作成に関する Dropbox のドキュメントを参照してください。
3. 直接 URL を追加する
Dropbox アプリ コンソールの [設定] タブの [OAuth 2] セクションの [リダイレクト URL] に、次のリンクを追加します。
M365 Enterprise の場合は、コピーして貼り付けます。 https://gcs.office.com/v1.0/admin/oauth/callback
M365 Government の場合は、コピーして貼り付けます。 https://gcsgcc.office.com/v1.0/admin/oauth/callback
4. API スコープを追加する
Dropbox アプリ コンソールの [アクセス許可] タブに移動し、次のアクセス許可を追加しました。
個々のスコープ:
files.metadata.read
files.content.read
sharing.read
file_requests.read
チーム スコープ:
team_info.read
team_data.member
team_data.governance.write
team_data.governance.read
team_data.content.read
files.team_metadata.read
members.read
groups.read
events.read
5. アプリ キーとアプリ シークレットを取得する
左側のナビゲーション ウィンドウから [設定] タブに移動して、このページからアプリ キーとアプリ シークレットを取得します。
設定
1. 表示名
ユーザーが Copilot 応答で関連付けられているファイルまたは項目を簡単に認識するのに役立つ表示名を選択します。
2. 認証の種類
Dropbox アプリ コンソールから取得したアプリ キーとアプリ シークレットを入力します。
3. 限定対象ユーザーへのロールアウト
ロールアウトを広範な対象ユーザーに展開する前に、Copilot やその他の検索サーフェスで検証する場合は、制限付きユーザー ベースにこの接続をデプロイします。
アクセス許可、データ包含ルール、スキーマ、クロール頻度などのその他の設定については、Dropbox のデータに最適な内容に基づいて既定値を設定します。 既定値の設定は次のとおりです。
Page | 設定 | 既定値 |
---|---|---|
ユーザー | アクセス許可 | Dropbox のすべてのユーザーがアクセスできるファイルは、Microsoft Search または Copilot から、テナント内のすべての Microsoft 365 ユーザーに表示されます。 |
コンテンツ | インデックス コンテンツ | 発行されたすべての投稿とページは、既定で選択されます。 |
コンテンツ | プロパティの管理 | 既定のプロパティとそのスキーマをチェックします。 |
同期 | 増分クロール | 頻度: 4 時間ごと |
同期 | フル クロール | 頻度: 毎日 |
これらの値のいずれかを編集する場合は、[ カスタム セットアップ] オプションを選択する必要があります。
カスタム セットアップ
カスタムセットアップは、設定の既定値を編集する管理者向けです。 [カスタム セットアップ] オプションをクリックすると、他の 3 つのタブ (ユーザー、コンテンツ、同期) が表示されます。
ユーザー
アクセス許可
Dropbox Copilot コネクタでは、このデータ ソース (推奨) または Everyone へのアクセス権を持つユーザーのみが表示できるデータがサポートされています。 [すべてのユーザー] を選択すると、すべてのユーザーの検索結果にインデックス付きデータが表示されます。
[このデータ ソースへのアクセス権を持つユーザーのみ] を選択した場合は、プロビジョニングされたユーザーがMicrosoft Entra IDか、AAD 以外のユーザーであるかをさらに選択する必要があります。
organizationに適したオプションを特定するには:
Dropbox ユーザーのメール ID が、Microsoft Entra IDのユーザーの UserPrincipalName (UPN) と同じである場合は、Microsoft Entra ID オプションを選択します。
Dropbox ユーザーのメール ID が、Microsoft Entra IDのユーザーの UserPrincipalName (UPN) と異なる場合は、AAD 以外のオプションを選択します。
重要
- id ソースの種類としてMicrosoft Entra IDを選択した場合、コネクタは Dropbox から直接取得したユーザーの電子メール ID を、Microsoft Entra IDから UPN プロパティにマップします。
- ID の種類に "非 AAD" を選択した場合は、ID のマッピング手順については、「Azure 以外の AD ID をマップする」を参照してください。 このオプションを使用して、メール ID から UPN へのマッピング正規表現を指定できます。
- アクセス許可を管理するユーザーまたはグループへのUpdatesは、フル クロールでのみ同期されます。 増分クロールでは、現在、アクセス許可に対する更新プログラムの処理はサポートされていません。
コンテンツ
プロパティの管理
ここでは、Dropbox データ ソースから使用可能なプロパティを追加または削除できます。 プロパティにスキーマを割り当てる (プロパティが 検索可能、クエリ可能、取得可能、またはリファイン可能かどうかを定義する)、セマンティック ラベルを変更し、プロパティにエイリアスを追加します。 既定で選択されるプロパティは次のとおりです。
Source プロパティ (ADO MD) | Label | 説明 | Schema |
---|---|---|---|
CreatedBy | 作成者 | 作成者のメール アドレス | クエリ、取得、検索 |
FileExtension | ファイル拡張子 | ファイル名拡張子 | クエリ、絞り込み、取得 |
IconUrl | IconUrl | アイコンの URL。 | 取り戻す |
LastModifiedBy | 最終更新日時 | このファイルを最後に変更したユーザーのメール アドレス。 | クエリ、取得、検索 |
LastModifiedTime | lastModifiedDateTime | ファイルを変更する最後のユーザー。 最後の変更を実行したユーザー。これはサインイン ユーザーである必要があります。 | クエリ、絞り込み、取得 |
名前 | ファイル名 | ファイル名 | クエリ、取得、検索 |
PreviewUrl | url | 共有ファイルの Web プレビューを表示するための URL。 | 取り戻す |
Size | ファイルのサイズ (バイト単位)。 |
同期
ここに存在するスケジュール オプションに基づいて、フル クロールと増分クロールを構成できます。 既定では、増分クロールは 4 時間ごとに設定され、フル クロールは毎日に設定されます。 必要に応じて、データ更新のニーズに合わせてこれらのスケジュールを調整できます。
トラブルシューティング
1. 必要なアクセス許可スコープがありません。 Dropbox アプリで必要なスコープが選択されていることを確認します。
必要なアクセス許可スコープがない場合は、Dropbox アプリ コンソールですべてのスコープを選択していることを確認します。
個々のスコープ:
files.metadata.read
files.content.read
sharing.read
file_requests.read
チーム スコープ:
team_info.read
team_data.member
team_data.governance.write
team_data.governance.read
team_data.content.read
files.team_metadata.read
members.read
groups.read
events.read
2. OAuth 2.0 フローに失敗しました。 資格情報を確認し、Dropbox アプリが正しい設定で構成されていることを確認します。
一般的な認証エラー。 Dropbox アプリ コンソールに戻るし、設定タブの OAuth2 が正しく構成されている場合にチェックします。
3. OAuth 2.0 フローに失敗しました。 このチーム アクセス トークンに関連付けられている Dropbox ユーザーがチーム管理者ロールを保持し、アクティブなユーザーであることを確認します。
一般的な認証エラー。 Dropbox アプリ コンソールに戻るし、作成者が管理者ロールを持ち、アカウントの状態がアクティブになっている場合にチェックします。
4. このセッションのセキュリティ資格情報の有効期限が切れています。 戻るし、アプリ キーとアプリ シークレットを使用してもう一度サインインします。
資格情報の有効期限が切れています。 Dropbox アプリ コンソールを更新し、設定タブから最新のアプリ キーとアプリ シークレットをコピーして認証します。
5. 無効な資格情報が検出されました。 資格情報を確認し、Dropbox アプリのアクセス許可スコープをチェックします。
一般的な資格情報エラー。 Dropbox アプリ コンソールに戻るし、[アクセス許可] タブのスコープが正しく構成されているかどうかをチェックします。