DataStax Microsoft 365 Copilot 連接器可讓您的組織為 DataStax Astra DB 集合中的記錄編制索引。 從 DataStax 資料庫設定連接器和索引內容之後,用戶可以在 Microsoft 365 Copilot 中搜尋這些專案。
本文適用於Microsoft 365 名系統管理員或設定、執行及監視 DataStax Copilot 連接器的任何人。
功能
- DataStax Astra DB 集合中的索引記錄。
- 讓用戶根據 Copilot 中 DataStax 的知識來尋求建議。 例如,您已設定連接器來存取 DataStax 中的電影評論集合:
- 根據檢閱文字和您的興趣來推薦電影。
- 摘要說明電影 Paa 的檢閱文字。
- 識別產生熱討論的影片。
限制
- 不會為非向量資料庫編製索引。
- 不會為 Langflow 編製索引。
- 不支援垂直搜尋。
必要條件
- 您必須是組織Microsoft 365 租使用者的搜尋管理員。
- 若要連線到 DataStax 資料庫,您需要 DataStax API 端點和資料庫識別碼。
- 若要連線到 DataStax 並允許 Copilot 連接器定期更新 DataStax 工作,您需要具有讀取許可權的應用程式令牌。
快速入門
1.選擇顯示名稱
顯示名稱可用來識別 Copilot 中的每個引文,以協助使用者輕鬆辨識相關聯的檔案或專案。 顯示名稱也會表示受信任的內容,並做為 內容來源篩選條件。
提供預設值;您可以將它自定義為組織中用戶可辨識的名稱。
2.新增 DataStax API 端點
若要連線到 DataStax 資料庫,您需要 DataStax API 端點。 您可以在資料庫概觀中找到端點,通常如下所示: https://<your-database-id>-<region>.apps.astra.datastax.com。
3.新增 DataStax 資料庫標識符
若要連線到 DataStax 資料庫,您需要 DataStax 資料庫識別碼。 您可以在資料庫的概觀中找到資料庫識別碼。
4.產生應用程式令牌
若要使用 DataStax 應用程式令牌 進行驗證,DataStax 系統管理員必須為具有適當使用者角色的資料庫產生應用程式令牌,例如使用「只讀使用者」。
從令牌詳細數據複製產生的應用程式令牌,這通常是開頭為 “AstraCS:...” 的長字符串並將它貼到連接器設定中。 選擇 [授權],並使用相同的令牌來驗證編目許可權。
5.向有限的物件推出
如果您想要在 Copilot 和其他搜尋介面中驗證連線,請先將連線部署至有限的使用者基底,再將它推出給更廣泛的物件。 如需詳細資訊,請參閱 連接器的分段推出。
此時,您已準備好建立 DataStax 的連線。 選擇 [建立 ] 以從您的 DataStax 帳戶發佈連線和索引發行項。
對於其他設定,例如 訪問許可權、 架構和 編目頻率,預設值是根據最適合 DataStax 數據的值來設定。
| 使用者 | 描述 |
|---|---|
| 訪問許可權 | 只有具有數據源中內容存取權的人員。 |
| 對應身分識別 | 使用 Microsoft Entra標識碼對應的數據源身分識別。 |
| 內容 | 描述 |
|---|---|
| 管理屬性 | 如需默認屬性及其架構的相關信息,請參閱 內容。 |
| 同步處理 | 描述 |
|---|---|
| 完整編目 | 每天執行一次。 |
自訂設定
在自訂設定中,您可以編輯使用者、內容和同步處理的任何預設值。
使用者
訪問許可權
DataStax Copilot 連接器支援 「所有人 」或 「僅限具有此數據源存取權的人員」可看見的搜尋許可權。 如果您選擇 [ 所有人],已編製索引的數據會出現在所有使用者的搜尋結果中。 如果您選擇 [僅限可存取此數據源的人員],則已編製索引的數據會出現在具有此數據源存取權之使用者的搜尋結果中。 在 Atlassian DataStax 中,安全性許可權是使用包含網站層級群組和專案角色的專案許可權配置來定義。 您也可以使用工作層級許可權配置來定義工作層級安全性。
對應身分識別
將數據源身分識別與 Microsoft Entra ID 對應的預設方法是確認 DataStax 使用者的電子郵件識別碼與 Microsoft Entra ID 中使用者的 UPN) (用戶主體名稱相同。 如果預設對應不適用於您的組織,您可以提供自定義對應公式。 如需詳細資訊,請參閱 對應您的非 Azure AD 身分識別。
若要識別哪一個選項最適合您的組織:
- 如果 DataStax 使用者的電子郵件識別碼與 Microsoft Entra ID 中的 UPN 相同,請選擇 [Microsoft Entra ID] 選項。
- 如果 DataStax 使用者的電子郵件識別碼與 Microsoft Entra ID 中使用者的 UPN 和電子郵件不同,請選擇 [非 Microsoft Entra ID] 選項。
內容
管理屬性
若要檢視 DataStax 數據源中的可用屬性,請將架構指派給屬性 (定義屬性是否可搜尋、可查詢、可擷取或可精簡) 、變更語意標籤,並在 屬性中新增別名。 默認會選取某些屬性。
| 默認屬性 | 標籤 | 描述 | Schema |
|---|---|---|---|
| 集合 | 不適用 | 集合名稱 | 查詢、擷取、搜尋。 |
| 內容 | 不適用 | 集合中的記錄 | 搜尋。 |
| IconUrl | IconUrl | 記錄的圖示 URL | 取回。 |
| 識別碼 | URL | 集合中的記錄標識碼 | 查詢、擷取。 |
| Keyspace | 不適用 | 建立這項工作的人員 | 查詢、擷取、搜尋。 |
| 標題 | 標題 | 結合集合名稱和記錄標識碼所建立的標題 | 查詢、擷取、搜尋。 |
預覽數據
使用 [預覽結果] 按鈕來驗證所選屬性和查詢篩選的範例值。
同步處理
重新整理間隔會決定數據源與 DataStax Copilot 連接器索引之間同步處理數據的頻率。 DataStax 圖形連接器僅支援重新整理間隔 - 完整編目。 如需詳細資訊,請參閱 重新整理設定。
您可以變更重新整理間隔的預設值。
後續步驟
發佈連線之後,您可以在系統管理中心的[連接器] 區段中檢閱狀態。 若要瞭解如何進行更新和刪除,請參閱 管理您的連接器。
如果您有問題或想要提供意見反應,請參閱 Microsoft Graph 支援。