Miro Microsoft 365 Copilot 可讓您的組織從 Miro 索引面板。 設定連接器之後，使用者可以在 Microsoft 365 Copilot 和任何 Microsoft 搜尋用戶端中從 Miro 搜尋這些面板。
本文適用於 Microsoft 365 系統管理員或設定、執行和監視 Miro Copilot 連接器的任何人。
功能
- 使用語意搜尋的強大功能存取 Copilot 中的面板。
- 自定義您的編目頻率。
- 使用 Microsoft Copilot Studio 連線的資料來源建立代理程式。
限制
- 只有白板上的自黏便箋、形狀、框架、文字和內嵌文件中的內容才會建立索引。 不包括其他物件類型中的內容。 如需詳細資訊，請參閱 適用於開發人員的 Miro 文件。
- 不索引註解或回覆。
必要條件
1. 為您的 Miro 帳戶創建開發團隊
建立或使用現有的 Miro 帳戶來存取 Miro，然後按一下 連結 ，為您的作用中 Miro 帳戶建立開發人員團隊。 如果您的組織採用 Enterprise 方案，請前往 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/callback對於 M365 政府版，複製並貼上：
https://gcsgcc.office.com/v1.0/admin/oauth/callback
5. 安裝您的應用程式並記錄憑證
按一下 [安裝應用程式並取得 OAuth權杖 ]，並記錄 Client ID 應用程式認證中的 和 Client secret 。
快速入門
1.配置顯示名稱
顯示名稱用於識別 Copilot 中的每個引文，以幫助使用者輕鬆識別關聯的檔案或項目。 顯示名稱也表示受信任的內容，並用作 內容來源篩選器。 會針對此欄位提供預設值;您可以將其自訂為組織中使用者可辨識的名稱。
2. 新增公司ID
公司 ID (也稱為組織 ID) 是您組織 Miro 帳戶的唯一識別碼。 您可以透過開啟 Miro 儀表板，按一下右上角的個人資料，選擇設定，然後檢查網址列中的 URL，其中將顯示公司 ID，從而找到它。
注意事項
您只能在連線中關聯一個公司 ID。 如果您的 Miro 工作區中有多個公司 ID，請建立單獨的連線。
3. 提供驗證類型
輸入您從 Miro 應用程式取得的用戶端 ID 和用戶端密碼。 如需詳細資訊，請參閱開始使用 OAuth 2.0 和 Miro。
4. 向有限的受眾推出
如果您想要在 Copilot 和其他搜尋介面中驗證此連線，請先將此連線部署至有限的使用者群，再將推出範圍擴大到更廣泛的物件。 如需詳細資訊，請參閱 Microsoft 365 Copilot 連接器的分段推出。
若要建立 Miro 的連線，請選擇 Create （ 建立 ） 以從您的 Miro 帳戶發佈您的連線和索引面板。
對於其他設定，例如 存取權限、 結構描述和 編目頻率，預設值是根據最適合 Miro 資料的設定來設定的。
| 使用者 | 描述 |
|---|---|
| 存取權限 | 只有具有資料來源中內容存取權的人員。 |
| 對應身分識別 | 使用 Microsoft Entra ID 對應的資料來源身分識別。 |
| 內容 | 描述 |
|---|---|
| 管理屬性 | 檢查預設屬性及其結構描述。 |
| 同步處理 | 描述 |
|---|---|
| 完整爬蟲 | 頻率：每天 |
自訂設定
在自訂設定中，您可以編輯使用者、內容和同步的任何預設值。
使用者
存取權限
Miro Copilot 連接器支援對 所有人 或僅有權 存取此資料來源的人員可見的搜尋權限。 如果您選擇 [所有人]，則索引資料會顯示在所有使用者的搜尋結果中。 如果您選擇 [ 僅具有此資料來源存取權的人員]，則索引資料會顯示在有權存取該資料來源的使用者的搜尋結果中。
對應身分
將資料來源身分識別與Microsoft Entra識別碼對應的預設方法是驗證 Miro 使用者的電子郵件識別碼是否與使用者主體名稱 (UPN) 或 Microsoft Entra 中使用者的電子郵件相同。 如果預設對應不適用於您的組織，您可以提供自訂對應公式。 如需詳細資訊，請參閱 對應您的非 Azure AD 身分識別。
若要確定哪個選項最適合您的組織：
- 如果 Miro 使用者的電子郵件識別碼與使用者的 UPN 或 Microsoft Entra ID 中的電子郵件相同，請選擇 Microsoft Entra ID 選項。
- 如果 Miro 使用者的電子郵件 ID 與 Microsoft Entra ID 中的使用者 UPN 和電子郵件不同，請選擇 Microsoft Entra ID 選項。
內容
管理屬性
若要在 Miro 資料來源中新增或移除可用屬性，請將結構描述指派給屬性 (定義屬性是否可搜尋、可查詢、可擷取或可精簡) ，並變更語意標籤並為屬性新增別名。 依預設會選取某些內容。
| 來源屬性 | 標籤 | 描述 | Schema |
|---|---|---|---|
| 內文 | NA | NA | 搜尋 |
| 建立時間 | 建立日期時間 | 在資料來源中建立項目的日期和時間 | 查詢、檢索。 |
| CreatedBy | 建立者 | 建立項目的使用者 | 查詢、檢索、搜尋。 |
| 描述 | NA | NA | 查詢、檢索。 |
| 識別碼 | NA | NA | 查詢、檢索。 |
| 修改時間 | 上次修改日期時間 | 上次在資料來源中修改項目的日期和時間 | 查詢、檢索。 |
| ModifiedBy | 上次修改者 | 進行最後修改的使用者 | 查詢、檢索、搜尋。 |
| Name | 標題 | 您想要在 Copilot 和其他搜尋體驗中顯示的專案標題 | 查詢、檢索、搜尋。 |
| 小組 | NA | NA | 查詢、檢索。 |
| 檢視連結 | 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 支援。