Microsoft 365 Copilot 用於人員資料的連接器，允許組織將外部系統（包括 BambooHR）的資料索引至 Microsoft 365。 BambooHR Microsoft 365 Copilot 連接器允許組織將 BambooHR 的個人檔案索引至 Microsoft Graph，使其能跨越 Microsoft 365 體驗，包括 Microsoft 365 Copilot 與 Microsoft Search。
本指南適合 Microsoft 365 管理員或負責設定、管理及監控 BambooHR Copilot 連接器的人士。
以下影片概述了 BambooHR 連接器。
功能
- 完整的個人資料索引會自動同步來自 BambooHR 的重要員工資訊，包括姓名、聯絡方式、職稱、部門、聘用日期及組織階層。
- 強化版 Microsoft 365 Copilot 體驗讓您的終端使用者能根據 BambooHR 個人資料向同事提出自然語言問題，並獲得智慧回應。 在 Copilot 中使用 語意搜尋 ，幫助使用者根據關鍵字、技能、部門、地點及組織關係找到相關同事。
- 即時資料同步讓員工資訊保持即時，預設每15分鐘進行增量同步，並每日完全同步。
- 無縫的 Microsoft 365 整合使個人檔案資料在 Microsoft 365 體驗中可被發現，提升協作與組織認知度。
- 自動身份映射能智慧地將 BambooHR 設定檔與 Microsoft Entra ID 使用者匹配，實現跨平台的準確身份關聯。
欲了解更多資訊，請參閱 Microsoft 365 Copilot 連接器以了解人員資料。
注意事項
當你向 Copilot 詢問某人時，引用會顯示為 office.com ，而非 BambooHR，因為 Microsoft 365 中的個人資料資訊可能來自多個來源。 例如，職稱可能來自 BambooHR，而名稱和其他細節則可能來自 Microsoft Entra 或其他連網系統。
限制
- 資料索引範圍聚焦於核心員工資料，以優化 Microsoft 365 體驗與 Copilot。 請假、文件、福利、訓練、資產、筆記、緊急狀況、入職、離職及自訂資產均不在目前的索引範圍內。
- 存取權限允許連接器索引 Microsoft 租戶中所有使用者都能存取的個人檔案資料，確保員工資訊在 Microsoft 365 體驗與 Copilot 中廣泛可被發現。 未來更新中將提供細緻的使用者層級權限控制。
- 身份映射要求 BambooHR 中的工作電子郵件地址與 UPN) (UserPrincipalName 或 Microsoft Entra 中的電子郵件地址相符，才能成功對應個人檔案映射。 這確保了系統間的身份關聯性。
- 架構設定使用預先定義的員工設定檔屬性，並針對 Microsoft 365 與 Copilot 整合進行優化。 完整的索引屬性列表，請參閱 結構映射表。
- Active Employee Focus 會自動篩選只包含在職員工，確保您的 Microsoft 365 目錄和 Copilot 反映目前的組織架構。
注意事項
BambooHR 將沒有填補聘 (或原始聘用日期) 員工視為非活躍，這些檔案不被納入索引。
必要條件
登入 BambooHR 開發者入口網站 ，並使用你現有的 BambooHR 開發者帳號憑證登入，或如果沒有開發者帳號，請建立新的。 請注意，開發者入口網站與你的主 BambooHR 實例是分開的，專門用於建立和管理與 BambooHR 整合的 API 應用程式。
在開發者入口網站中，提供一個獨特的應用程式名稱，例如「Microsoft 365 Copilot connector」或你組織的名稱) ，建立一個新的 BambooHR 應用程式 (。
在應用程式細節區塊，新增 Microsoft 365 在驗證時用來與 BambooHR 通訊的重定向網址。 複製並貼上這個精確網址：
https://gcs.office.com/v1.0/admin/oauth/callback
在應用程式範圍區塊中，選擇允許連接器存取 BambooHR 特定員工資料所需的權限。 選擇以下唯讀權限的示波器，以確保連接器能取得必要的設定檔資訊：
類別 所需的範圍 宣告 電子郵件
openid雇員 雇員
員工：聯絡人
員工：識別
員工：工作
員工：管理層
員工：姓名
employee_directory
sensitive_employee：protected_info雜項 欄位
offline_access
public.user報表 報 
請前往 應用程式憑證 區塊取得應用程式用戶端 ID 和應用程式用戶端秘密。 這些憑證將在設定時用來驗證 Microsoft 365 連接器與您的 BambooHR 應用程式的關聯。
快速入門
新增 BambooHR Microsoft 365 Copilot 連接器。
1. 選擇顯示名稱
選擇顯示名稱，例如「BambooHR 個人檔案」，幫助使用者輕鬆辨識 Copilot 回應中的相關設定檔。
2. 新增實例網址
輸入你的 BambooHR 實例網址，例如， https://contoso.bamboohr.com/
3. 選擇認證類型
從驗證類型列表中選擇 OAuth 2.0，並從您的 BambooHR 開發者入口輸入客戶端 ID 與客戶端秘密。 當你點擊 授權時，必須用包含員工資料的 BambooHR 實例管理員憑證登入，並同意所需權限。
至於其他設定，例如存取權限、資料包含規則、架構、爬取頻率等，我們會根據 BambooHR 中資料的最佳設定設定預設值。 預設值設定如下。
| 頁面 | 設定 | 預設值 |
|---|---|---|
| 使用者 | 存取權限 注意：透過 BambooHR Copilot 連接器取得的所有資料，對你 Microsoft 租戶中的所有人都是可見的。 然而，我們並沒有改變系統的行為，例如尊重存取限制。 如果使用者被阻擋查看其他使用者的個人資料資料，該個人資料 (包括 BambooHR Copilot 資料) 不會被分享或儲存在被封鎖使用者的視圖中。 未來在實施使用者層級權限控制時，存取受限資料將納入更新中。 |
所有個人檔案對任何人開放。 |
| 對應身分識別 | 資料來源身份是使用 Microsoft Entra ID 映射的。 | |
| 同步處理 | 增量爬行 | 頻率：每15分鐘一次。 |
| 同步處理 | 全程爬行 | 頻率：每天。 |
| 模式性質 | 描述 | Microsoft 365 使用者設定檔架構中的屬性 |
|---|---|---|
| 名字 | 員工的名字 | >名字優先 |
| 姓氏 | 員工姓氏 | 名字->最後 |
| 名稱 | 員工全名 | names-displayName> |
| 電子郵件 | 員工的工作電子郵件地址 | 電子郵件地址>[type='work'] 注意：Email 會被轉換成終端使用者的 Microsoft Entra objectId，並用於內部處理。 |
| 出生日期 | 員工出生日期 | 紀念日->日期[type='birthday'] |
| 職缺資訊部門 | 例如員工的工作部門，人力資源 | 職位->細節->公司->部門 |
| 職缺資訊部門 | 例如，北美洲的員工職務分工 | 職位->細節->連>-師 |
| 員工編號 | 員工編號 | 職位->詳細->員工ID |
| 員工 Eeid | BambooHR 員工識別碼 | webAccounts-userID> 注意：員工的 EEID 也會在內部定期檢查 BambooHR 中某員工的更新。 |
| 就業狀況 | 員工身份，例如全職、承包商等。 | 職位->詳細->員工類型 |
| 原始聘用日期 | 員工入職日期 | 紀念日日期>[type='originalHireDate'] |
| 聘用日期 | 員工入職日期 注意：當原始聘用日期為空時，我們會索引聘用日期 |
紀念日日期>[type='originalHireDate'] |
| 職務資訊 職稱 | 員工職稱，例如資深人力資源管理員 | 職位->詳細->工作標題 |
| 主管識別碼 | 員工經理識別碼 | positions-manager-userID>> 注意：主管 ID 用於尋找主管的電子郵件，然後將其轉換為經理的 Microsoft Entra objectId，供內部處理。 |
| 行動電話 | 員工的工作用手機 | 電話號碼> (類型=行動) |
| 公司電話 | 員工的工作電話 | 電話號碼> (類型=工作) |
| 職缺資訊 地點 | 員工辦公室所在地 | 職位->職位詳細->公司詳細>-辦公室 |
| 狀態 | 例如員工狀態，是現役或非在職 | 不適用 注意：內部用於過濾非活躍員工，確保他們被排除在 BambooHR 資料檢索之外。 |
自訂設定
在自訂設定中，你可以編輯使用者、內容和同步的任何預設值。
使用者
BambooHR Copilot 連接器只支援所有人都能看到的資料。 這表示所有使用者的搜尋結果中都會顯示索引資料。 BambooHR Copilot 連接器僅支援透過檢查 BambooHR 個人資料的電子郵件地址是否與 UPN) (UserPrincipalName 相同，或是 Microsoft Entra ID 中使用者的電子郵件，來映射你的資料來源身份與 Microsoft Entra ID。
內容
BambooHR Copilot 連接器不支援新增屬性或移除此標籤中的現有屬性。在這個分頁裡，有一個名為 annotationSerialized 的屬性，涵蓋了前面提到的所有預設屬性。
同步處理
刷新間隔決定了你的資料在資料來源與 BambooHR Copilot 連接器索引之間同步的頻率。 刷新間隔有兩種類型——完整爬行和增量爬行。 更多資訊請參閱 刷新設定。
後續步驟
發布連線後，您可以在管理中心的連接器區查看狀態。 想了解如何進行更新與刪除，請參閱 「管理你的連接器」。
如果你有問題或想提供回饋，請參考 Microsoft Graph 支援。