DataStax Microsoft 365 Copilot コネクタ

DataStax Microsoft 365 Copilot コネクタを使用すると、organizationで DataStax Astra DB コレクション内のレコードにインデックスを作成できます。 DataStax データベースからコネクタとインデックスコンテンツを構成した後、ユーザーはMicrosoft 365 Copilot内のそれらの項目を検索できます。

この記事は、Microsoft 365 管理者または DataStax Copilot コネクタを構成、実行、監視するユーザーを対象とします。

機能

DataStax Astra DB コレクション内のインデックスレコード。
ユーザーが Copilot の DataStax の知識に基づいてアドバイスを求めるのを有効にします。たとえば、DataStax で映画レビューのコレクションにアクセスするようにコネクタを構成したとします。
- レビューテキストとあなたの興味に基づいて映画をお勧めします。
- 映画Paaのレビューテキストを要約します。
- 熱いディスカッションを生み出す映画を特定します。

制限事項

非ベクター DB のインデックスを作成しません。
Langflow にインデックスを付けません。
検索バーティカルはサポートされていません。

前提条件

organizationの Microsoft 365 テナントの検索管理者である必要があります。
DataStax データベースに接続するには、DataStax API エンドポイントとデータベース ID が必要です。
DataStax に接続し、Copilot コネクタが DataStax タスクを定期的に更新できるようにするには、読み取りアクセス許可を持つアプリケーショントークンが必要です。

作業の開始

1. 表示名を選択する

表示名は、Copilot の各引用文献を識別するために使用され、ユーザーが関連付けられているファイルまたは項目を簡単に認識するのに役立ちます。表示名は信頼されたコンテンツも示し、コンテンツソースフィルターとして使用されます。

既定値が提供されます。organization内のユーザーが認識する名前にカスタマイズできます。

2. DataStax API エンドポイントを追加する

DataStax データベースに接続するには、DataStax API エンドポイントが必要です。エンドポイントはデータベースの概要にあり、通常は次のとおりです: https://<your-database-id>-<region>.apps.astra.datastax.com。

3. DataStax データベース ID を追加する

DataStax データベースに接続するには、DataStax データベース ID が必要です。データベース ID は、データベースの概要にあります。

4. アプリケーショントークンを生成する

認証に DataStax アプリケーショントークン を使用するには、DataStax 管理者は、"読み取り専用ユーザー" を使用するなど、適切なユーザーロールを持つデータベースのアプリケーショントークンを生成する必要があります。

生成されたアプリケーショントークンをトークンの詳細からコピーします。これは通常、"AstraCS:.." で始まる長い文字列です。コネクタのセットアップに貼り付けます。 [ 承認] を選択し、同じトークンを使用してクロールのアクセス許可を認証します。

5. 限定対象ユーザーにロールアウトする

制限付きユーザーベースへの接続をデプロイします。広範な対象ユーザーに展開する前に、Copilot やその他の Search サーフェスで検証する必要がある場合は、その接続をデプロイします。詳細については、「コネクタの段階的ロールアウト」を参照してください。

この時点で、DataStax の接続を作成する準備ができました。 [ 作成] を 選択して、DataStax アカウントから接続とインデックス記事を発行します。

アクセス許可、スキーマ、クロール頻度などのその他の設定の場合、既定値は DataStax データで最適に動作するものに基づいて設定されます。

ユーザー	説明
アクセス許可	データソース内のコンテンツにアクセスできるユーザーのみ。
ID のマッピング	Microsoft Entra ID を使用してマップされたデータソース ID。

コンテンツ	説明
プロパティの管理	既定のプロパティとそのスキーマの詳細については、コンテンツに関するページを参照してください。

同期	説明
フルクロール	毎日実行されます。

カスタムセットアップ

カスタムセットアップでは、ユーザー、コンテンツ、同期の既定値を編集できます。

ユーザー

アクセス許可

DataStax Copilot コネクタでは、このデータソースへのアクセス権を持つすべてのユーザーまたは唯一のユーザーに表示される検索アクセス許可がサポートされています。 [ すべてのユーザー] を選択すると、すべてのユーザーの検索結果にインデックス付きデータが表示されます。 [このデータソースにアクセスできるユーザーのみ] を選択すると、インデックス付きデータが検索結果に表示されます。 Atlassian DataStax では、サイトレベルのグループとプロジェクトロールを含むプロジェクト権限スキームを使用してセキュリティアクセス許可が定義されます。タスクレベルのセキュリティは、タスクレベルのアクセス許可スキームを使用して定義することもできます。

ID のマッピング

データソース ID を Microsoft Entra ID にマップする既定の方法は、DataStax ユーザーの電子メール ID が、Microsoft Entra IDのユーザーのユーザープリンシパル名 (UPN) と同じであることを確認することです。既定のマッピングがorganizationに対して機能しない場合は、カスタムマッピング式を指定できます。詳細については、「 Azure AD 以外の ID をマップする」を参照してください。

organizationに最適なオプションを特定するには:

DataStax ユーザーの電子メール ID が Microsoft Entra ID の UPN と同じである場合は、Microsoft Entra ID オプションを選択します。
DataStax ユーザーの電子メール ID が、Microsoft Entra IDのユーザーの UPN および電子メールと異なる場合は、[非Microsoft Entra ID] オプションを選択します。

コンテンツ

プロパティの管理

DataStax データソースから使用可能なプロパティを表示するには、プロパティにスキーマを割り当てます (プロパティが検索可能、クエリ可能、取得可能、またはリファイン可能かどうかを定義する)、セマンティックラベルを変更し、プロパティにエイリアスを追加します。既定では、一部のプロパティが選択されています。

既定のプロパティ	Label	説明	Schema
コレクション	該当なし	コレクション名	クエリ、取得、検索。
コンテンツ	該当なし	コレクション内のレコード	検索。
IconUrl	IconUrl	レコードのアイコン URL	取り戻す。
Id	url	コレクション内のレコード ID	クエリ、取得。
Keyspace	該当なし	このタスクを作成したユーザー	クエリ、取得、検索。
タイトル	タイトル	コレクション名とレコード ID を組み合わせて作成されたタイトル	クエリ、取得、検索。

データのプレビュー

プレビュー結果ボタンを使用して、選択したプロパティとクエリフィルターのサンプル値を確認します。

同期

更新間隔は、データソースと DataStax Copilot コネクタインデックスの間でデータを同期する頻度を決定します。 DataStax グラフコネクタでは、更新間隔 ( フルクロール) のみがサポートされます。詳細については、「更新設定」を参照してください。

更新間隔の既定値を変更できます。

次の手順

接続を発行したら、管理センターの [コネクタ] セクションで状態を確認できます。更新と削除を行う方法については、「接続を監視する」をご覧ください。

問題がある場合、またはフィードバックを提供する場合は、「 Microsoft Graph サポート」を参照してください。

Last updated on 2025-04-19