Asana Microsoft 365 Copilot 連接器可讓您的組織為 Asana 工作編製索引。 在您從 Asana 工作區設定連接器和索引內容之後,用戶可以在 [搜尋] 和 [Microsoft 365 Copilot] 中搜尋這些專案Microsoft。
本文適用於Microsoft 365 名系統管理員或設定、執行及監視 Asana Copilot 連接器的任何人。
功能
- 索引工作。
- 讓使用者在 Copilot 中詢問與專案追蹤和工作資訊相關的問題。 例如:
- 識別尚未在所有專案中指派的工作。
- 識別專案中任何逾期的任務。
- 摘要說明接下來兩周的工作。
- 在 Copilot 中使用語意搜尋 ,讓用戶能夠根據關鍵詞、個人喜好設定和社交連線來尋找相關內容。
限制
- 連接器不會為批注編製索引。
- 連接器不會為自定義欄位編製索引。
必要條件
- 您必須是組織Microsoft 365 租使用者的搜尋管理員。
- 若要連線到您的 Asana 工作區,您需要 Asana URL。 URL 通常如下:
https://app.asana.com。 - 若要連線到 Asana 並允許 Copilot 連接器定期更新 Asana 工作,您需要具有讀取許可權的服務帳戶。 服務帳戶必須具有 管理員 角色。
快速入門
選擇顯示名稱
顯示名稱可用來識別 Copilot 中的每個引文,以協助使用者輕鬆辨識相關聯的檔案或專案。 顯示名稱也會表示受信任的內容,並做為 內容來源篩選條件。
提供預設值;您可以將它自定義為組織中用戶可辨識的名稱。
新增 Asana URL
若要連線到您的 Asana 工作區,您需要 Asana URL。 URL 通常如下: https://app.asana.com。
選擇驗證類型
若要使用 Asana OAuth 進行驗證,Asana 系統管理員必須在 Asana 開發人員控制台中建立應用程式。
使用下表中的資訊來完成 OAuth 用戶端建立表單。
| 欄位 | 描述 | 建議值 |
|---|---|---|
| 應用程式名稱 | 識別您需要 OAuth 存取之應用程式的唯一值。 | Microsoft 搜尋 |
| 哪一個最能描述應用程式的用途? | 描述應用程式的用途。 | 從 Asana 取得數據以建立報表。 |
| 重新導向URL | 授權伺服器重新導向的必要回呼 URL。 | 針對 Microsoft 365 企業版:https://gcs.office.com/v1.0/admin/oauth/callback針對 Microsoft 365 政府: https://gcsgcc.office.com/v1.0/admin/oauth/callback |
| 管理散發 | 選擇要散發的工作區。 | 新增連接器可以存取的特定工作區,或選取 [任何工作區]。 |
從您建立的 Asana 應用程式中的 [OAuth] 索引標籤複製用戶端識別碼和客戶端密碼,並將它們貼到連接器設定中。 選擇 [授權],並使用相同的 Asana 系統管理員帳戶認證來驗證編目許可權。
注意事項
您必須在彈出視窗中授權存取 Asana 應用程式。 請確定您的瀏覽器允許彈出視窗,或在彈出視窗遭到封鎖時授與存取權。
向有限的物件推出
如果您想要在 Copilot 和其他搜尋介面中驗證連線,請先將連線部署至有限的使用者基底,再將它推出給更廣泛的物件。 如需詳細資訊,請參閱 連接器的分段推出。
此時,您已準備好建立 Asana 的連線。 選擇 [建立 ] 以從您的 Asana 帳戶發佈連線和索引發行項。
對於其他設定,例如 訪問許可權、 架構和 編目頻率,預設值是根據最適合 Asana 資料的值來設定。
| 使用者 | 描述 |
|---|---|
| 訪問許可權 | 只有具有數據源內容存取權的人員。 |
| 對應身分識別 | 使用 Microsoft Entra標識碼對應的數據源身分識別。 |
| 內容 | 描述 |
|---|---|
| 管理屬性 | 如需默認屬性及其架構的相關信息,請參閱 內容。 |
| 同步處理 | 描述 |
|---|---|
| 累加編目 | 每隔 15 分鐘執行一次。 |
| 完整編目 | 每天執行一次。 |
如果您想要編輯其中任何一個值,請選擇 [自訂設定 ] 選項。
自訂設定
在自訂設定中,您可以編輯使用者、內容和同步處理的任何預設值。
使用者
訪問許可權
Asana Copilot 連接器支援 所有人 或 只有具有此數據源存取權的人員可以看見的搜尋許可權。 如果您選擇 [ 所有人],已編製索引的數據會出現在所有使用者的搜尋結果中。 如果您選擇 [僅限可存取此數據源的人員],則已編製索引的數據會出現在具有此數據源存取權之使用者的搜尋結果中。 在 Atlassian Asana 中,安全性許可權是使用包含網站層級群組和專案角色的專案許可權配置來定義。 您也可以使用工作層級許可權配置來定義工作層級安全性。
對應身分識別
將數據源身分識別與 Microsoft Entra ID 對應的預設方法,是確認 Asana 使用者的電子郵件識別碼與 Microsoft Entra ID 中使用者的 UPN (UPN) 使用者主體名稱相同。 如果預設對應不適用於您的組織,您可以提供自定義對應公式。 如需詳細資訊,請參閱 對應您的非 Azure AD 身分識別。
若要識別哪一個選項最適合您的組織:
- 如果 Asana 使用者的電子郵件識別碼與 Microsoft Entra ID 中的 UPN 相同,請選擇 [Microsoft Entra ID] 選項。
- 如果 Asana 使用者的電子郵件識別碼與 Microsoft Entra ID 中使用者的 UPN 和電子郵件不同,請選擇 [非 Microsoft Entra ID] 選項。
內容
管理屬性
若要從您的 Asana 新增或移除可用的屬性,請將架構指派給屬性 (定義屬性是否可搜尋、可查詢、可擷取或可精簡) 、變更語意標籤,以及將別名新增至 屬性。 默認會編製下列屬性的索引。
| 默認屬性 | 標籤 | 描述 | Schema |
|---|---|---|---|
| Assignee | 不適用 | 應完成這項工作的人員 | 查詢、擷取、搜尋 |
| 已完成 | 不適用 | 文章的主體 | 查詢、擷取 |
| CompletedAt | 不適用 | 工作完成的日期和時間 | 查詢、擷取 |
| CreatedAt | 建立日期時間 | 建立工作的日期和時間 | 查詢、擷取 |
| CreateBy | 建立者 | 建立這項工作的人員 | 查詢、擷取、搜尋 |
| DueOn | 不適用 | 當此工作應該完成時 | 查詢、擷取 |
| Gid | 不適用 | 此工作的全域標識碼 | 查詢、擷取 |
| ModifiedAt | 上次修改日期時間 | 修改工作的日期和時間 | 查詢、擷取 |
| Name | 標題 | 工作名稱 | 查詢、擷取、搜尋 |
| 附註 | 不適用 | 工作的描述 | 搜尋 |
| ProjectIds | 不適用 | 項目標識碼 | 不適用 |
| ProjectNames | 不適用 | 專案名稱 | 查詢、擷取 |
| 標記 | 標記 | 指派給此工作的標籤 | 查詢、擷取 |
| TaskUrl | URL | 工作的連結 | 查詢、擷取、搜尋 |
| WorkspaceName | 不適用 | 工作區名稱 | 查詢、擷取、搜尋 |
預覽數據
使用 [預覽結果] 按鈕來驗證所選屬性和查詢篩選的範例值。
同步處理
重新整理間隔會決定數據源與 Asana Copilot 連接器索引之間同步處理數據的頻率。 重新整理間隔有兩種類型 : 完整編目和累加編目。 如需詳細資訊,請參閱 重新整理設定。
您可以變更重新整理間隔的預設值。
後續步驟
發佈連線之後,您可以在系統管理中心的[連接器] 區段中檢閱狀態。 若要瞭解如何進行更新和刪除,請參閱 管理您的連接器。
如果您有問題或想要提供意見反應,請參閱 Microsoft Graph 支援。