共用方式為


針對 ServiceNow Knowledge Copilot 連接器的問題進行疑難排解

ServiceNow Knowledge Microsoft 365 Copilot 連接器可讓組織將 ServiceNow 知識庫文章編製索引至 Microsoft 365 Copilot 和搜尋體驗。 本文提供部署 ServiceNow Knowledge 連接器時可能遇到的常見錯誤疑難排解資訊。

若要驗證 ServiceNow 組態資訊以協助疑難排解錯誤,請參閱 設定 連接器擷取的 ServiceNow 服務

  1. 判斷搜尋文章的使用者是否具有存取 ServiceNow 知識文章所需的權限。 使用 ServiceNow 中的 使用者準則診斷 工具。

  2. 判斷使用者是否正確對應至 Microsoft Entra 身分識別。 對應問題會在「錯誤」標籤上顯示為2006錯誤。檢查使用者對應公式,並視需要進行更新。

    對應身分錯誤的螢幕擷取畫面。

  3. 判斷任何使用者準則中的進階指令碼是否授與文章的存取權。 目前不支援進階指令碼。

    1. 如果在知識庫層級的任何使用者準則中Cannot Read設定進階腳本,則知識庫中的所有文章都會在索引資料中加上拒絕存取戳記。

    2. 如果在文章層級的任何使用者準則中 Cannot Read 設定進階指令碼,則文章會在索引資料中加上拒絕存取戳記。

  4. 判斷知識庫層級是否存在空準則 - Cannot ReadCannot Contribute。 判斷文章層級是否存在空準則 - Cannot Read。 空白準則是具有空白欄位的使用者準則。 如果存在空白條件,則在索引資料中,文章會以拒絕存取戳記。

  5. 如果您無法識別根本原因,請連絡 Copilot 連接器支援小組 並提供下列詳細資料:

    1. 租用戶識別碼
    2. 連線識別碼
    3. 文章系統編號
    4. 知識庫系統 ID
    5. 對於知識庫,請收集:
      1. 使用者準則清單sys_id kb_uc_can_read_mtom (誰可以讀取知識庫) 表格中可用
      2. 使用者準則清單sys_id無法讀取知識庫) 表格中的kb_uc_cannot_read_mtom (中可用
      3. 使用者準則清單sys_id無法貢獻知識庫) 表格中的kb_uc_cannot_contribute_mtom (中可用
      4. kb_uc_can_contribute_mtom中可用的使用者條件清單sys_id
    6. 此外,對於在步驟 3 中收集sys_id項目,請共用:
      1. 文章can_read_user_criteria欄位中sys_id的使用者條件清單
      2. 文章cannot_read_user_criteria欄位中sys_id的使用者標準清單

由於已啟用單一登入的 ServiceNow 執行個體而無法登入

如果您的組織使用 ServiceNow 的單一登入 (SSO) ,您可能會無法使用服務帳戶登入。 您可以新增至 ServiceNow 執行個體 URL 來 login.do 顯示使用者名稱和密碼型驗證。 例如,https://<your-organization-domain>.service-now.com./login.do

無法與 ServiceNow 執行個體連線

連線狀態下的禁止或未經授權的回應可能由於下列原因:

  1. 帳號密碼不正確: 如果您使用基本驗證,您提供的認證可能不正確。 再次檢查認證。

    如果您使用 OAuth2.0,請確認帳戶密碼正確且未重設。 ServiceNow Knowledge Microsoft Graph 連接器會使用代表服務帳戶擷取的存取權杖進行編目。 存取權杖每 12 小時重新整理一次。 如果您變更密碼,您可能需要重新驗證連線。

  2. 表格存取權限: 檢查服務帳戶是否具有必要 條件中提及之資料表的必要存取權。 檢查服務帳戶是否具有資料行中所有資料表的 「讀取」存取權

  3. ServiceNow 執行個體位於防火牆後方: 如果 ServiceNow Knowledge 連接器位於網路防火牆後方,則可能無法連線到您的 ServiceNow 執行個體。 您必須允許存取連接器服務。 下表列出每個區域連接器服務的公用 IP 位址範圍。 將 IP 位址新增至您的網路允許清單。

    環境 地區 Range
    北美 52.250.92.252/30, 52.224.250.216/30
    歐洲 20.54.41.208/30, 51.105.159.88/30
    亞太地區 52.139.188.212/30, 20.43.146.44/30

變更知識文章的 URL

ServiceNow Knowledge Copilot 連接器AccessUrl會以 格式<instance_url>/kb_view.do?sys_kb_id<sysId>計算sys_id屬性。 它會在後端系統檢視中開啟知識文章。 使用下列步驟將文章重新導向至其他網址:

  1. 在 Microsoft 365 系統管理中心,在 [連接器] 索引標籤上,編輯針對 ServiceNow Knowledge 連線設定的結果類型。

    屏幕截圖顯示了單擊以編輯結果類型的位置

  2. [編輯結果類型 ] 對話方塊中,選取結果版面配置區段旁的 [編輯 ]。

    螢幕截圖顯示如何編輯結果佈局

  3. 尋找包含 with 和 AccessUrl values 的shortDescription文字屬性的 items 區塊。

    屏幕截圖顯示瞭如何在結果類型中查找項目塊

  4. 若要變更目的地 URL,請編輯 AccessUrl 項目區塊中文字屬性的部分。 例如,如果您想要將 ServiceNow Knowledge 文章重新導向至 https://contoso.service-now.com/sp,其中 sp 是服務 URL 入口網站前置詞,請遵循下列步驟。

    原始價值 新值
    "[{shortdescription}]({AccessUrl})" "[{shortdescription}](https://contoso.service-now.com/sp?id=kb_article_view&sysparm_article={number})"

    知識文章編號屬性在哪裡 number 。 建立連線時,請在「內容」索引標籤的結構描述區段中將其標示為 擷取

  5. 完成檢閱結果類型更新,然後選取 [提交]。 等待一兩分鐘,讓變更生效。 您的搜尋結果現在應該會重新導向到正確的 URL。

權限問題Only people with access to this data source

如果您看到 ServiceNow 與 Microsoft 搜尋或 Copilot 之間的使用者準則驗證差異,請將系統屬性設定 glide.knowman.block_access_with_no_user_criteriano

當您完成 OAuth 程序時,會出現 [成功登出] 視窗

當您完成 OAuth 程序時,可能會出現 「成功登出」 視窗,而不會提示輸入 ServiceNow 認證。

根據預設,ServiceNow 會嘗試透過單一登入 (SSO) 瀏覽器驗證,使用 Microsoft 365 系統管理員認證進行連線。 此預設設定可能會導致連線失敗。 因此,會出現 「登出成功」 視窗。

螢幕截圖顯示「登出成功」視窗

若要解決此問題,請遵循下列步驟:

  1. 開啟私人瀏覽器視窗,並使用您的 ServiceNow 認證登入。

  2. 在新的索引標籤中,登入 Microsoft 365 系統管理中心。 此步驟允許 ServiceNow SSO 登出並視需要切換認證。

  3. 請再次嘗試 OAuth 組態。 應出現以下窗口以授權連接:

    螢幕擷取畫面顯示「Oauth 設定」視窗

    如果您有問題或想要提供意見反應,請連絡 Microsoft Graph |支持

缺少對某些表的存取權

如果沒有正確的存取權限,編目器可能無法索引所有內容,也可能無法準確授與許可權。 您必須是 ServiceNow 管理員才能針對此問題進行疑難排解。

使用下列步驟,使用 REST API 總管來驗證資料表許可權:

  1. 模擬您在 ServiceNow 執行個體中建立的編目帳戶。

    請確定帳戶具有下列角色: rest_api_explorerweb_service_admin

  2. 移至 System Web Services>REST REST>API 瀏覽器

  3. 選取錯誤訊息中提及的其中一個表格。

    顯示「REST API 總管」頁面的螢幕擷取畫面。

  4. 設定 sysparm_limit10 (以限制測試) 的結果。

    顯示「sysparm_light」欄位的螢幕擷取畫面。

  5. 選擇 [傳送]。

  6. 檢閱回應:

    • 如果您收到 403 Status Code 以及錯誤訊息,指出您無權存取資料表,請參閱 授與資料表存取權 以提供資料表層級存取權。
    • 如果您收到 200 Status Code 但回應內文包含空白結果 (例如,沒有欄位) 、列存取權存在,但缺少欄位層級存取權。 若要授與欄位層級存取權,請參閱 授與欄位層級存取權

    顯示 回應 區段的螢幕擷取畫面。

    如果您在下拉式清單中沒有看到表格名稱,則可能表示無法存取表格本身。

    或者,您可以使用瀏覽器來驗證存取:

    1. 開啟無 瀏覽器視窗。
    2. 輸入下列 URL (以正確的值取代預留位置) : https://<instance-url>/api/now/table/<table_name>?sysparm_limit=10
    3. 出現提示時,請使用編目帳戶的認證登入。
    4. 檢閱回應。 如果沒有回應或出現錯誤,則該帳戶沒有必要的存取權。