整合疑難排解

如果整合無法連線、停止運作，或無法完成任務，請使用本指南檢查連線、帳戶存取權限，以及所選資源。

本頁涵蓋 Atoms 中常見的連線與授權問題。若要了解特定服務的設定、支援的操作，或你 app 內的設定，請先參閱 連線與管理整合 ，並選擇你的服務指南。

先從這些檢查開始

1. 確認失敗發生的位置。 智能體是在 Chat 中無法使用某項服務，還是該功能只在你的 app 中失敗？為 Chat 連線服務本身，並不代表你的 app 已正確設定。若是僅限 app 的失敗，請參閱 連線與管理整合 。
2. 開啟整合。 在你專案的 Chat 中，開啟訊息輸入框旁的選項選單，然後選擇 Connectors → Add connectors 。搜尋並選取該服務。檢查它是否已連線，或仍顯示 Connect 。有些服務會開啟自己的管理畫面。
3. 在服務本身中檢查存取權限。 確認你打算連線的帳戶可以開啟所涉及的確切檔案、儲存庫、行事曆、屬性或其他資源。
4. 在變更任何內容前先保存錯誤資訊。 記錄確切訊息、時間與時區、受影響的專案或 Chat，以及最後一次成功嘗試。請從螢幕截圖中遮蔽私人資訊。

開啟 Chat 輸入選項，選擇 Connectors (1)，再選擇 Add connectors (2) 以瀏覽可用的整合。

你也可以在 Settings → Connectors 中管理可用連線。選取你要檢查的整合。

請妥善保管憑證。切勿將密碼、登入代碼、API 金鑰、存取 Token 或其他機密資訊貼到 Chat 或支援請求中。僅在服務的登入流程或指定的安全設定欄位中輸入憑證。

找出你的問題

你找不到或無法開始某項整合

1. 使用 Add connectors 搜尋目錄。Chat 選單中的較短清單並不是完整目錄。
2. 如果 Atoms 表示此功能僅可在專案內使用，請開啟目標專案後再試一次。
3. 如果某個控制項已停用，請閱讀其說明。若需要不同角色或權限，請向專案或工作區擁有者尋求協助。不要為了繞過限制而中斷其他服務的連線。

檢查結果： 你可以開啟該服務的連線或管理畫面。如果仍未顯示，請查看 連線與管理整合 或聯絡支援以確認是否可用。不要假設可透過反覆嘗試登入來啟用缺少的服務。

授權無法完成

1. 選取一次 Connect ，並尋找該服務的登入視窗。如果你的瀏覽器回報彈出式視窗遭封鎖，請允許 Atoms 網站的彈出式視窗後再試一次。在 Chrome 中，請依照 允許特定網站彈出式視窗的說明 操作；你不需要為所有網站啟用。
2. 選擇你要使用的帳戶，並檢查所要求的存取權限。在關閉視窗前，完成該服務的授權流程。
3. 如果服務明確表示你的組織已封鎖此 app 或所要求的存取權限，請保存該訊息並聯絡你的管理員。不要繞過你組織的政策。
4. 返回 Atoms 並重新開啟整合以檢查其狀態。關閉登入視窗並不代表授權已成功。

在完成授權前，請檢查所要求的存取權限。授權某個帳戶本身，並不代表目標資源已連線。

如果授權流程包含組織或工作區選擇器，請確認選擇正確，並檢查所要求的權限。

檢查結果： 整合會顯示為已連線。在使用標準版面配置的 connector 詳細畫面中， Connect 會改為 Disconnect 和 Try it out 。其他服務則有自己的版面。如果仍顯示 Connect 或出現錯誤，請擷取該結果，並在重新嘗試一次後聯絡支援。

連線了錯誤的帳戶

如果整合的管理畫面顯示某個帳戶，請將其與擁有該資源或可存取該資源的帳戶進行比對。並非每個 connector 都會顯示已連線的帳戶，因此不要只以瀏覽器目前登入的帳戶作為 Atoms 正在使用哪個帳戶的證明。

請使用目標帳戶直接在服務中開啟該資源。如果該帳戶無法存取，請先向資源擁有者申請權限。如果連線使用了錯誤的帳戶，請依照該服務的帳戶切換說明操作，或 安全地重新連線 ，並在授權期間明確選擇正確的帳戶。

檢查結果： 小型且受支援的讀取請求會返回目標資源。如果你仍無法確認已連線的是哪個帳戶，請聯絡支援，而不是反覆中斷連線。

整合已連線，但智能體找不到你的資料

1. 檢查連線。 在 Connectors 中開啟整合詳細資料，並確認其已連線。若有顯示，請檢查所選帳戶或資源。
2. 檢查確切資源。 使用目標帳戶直接在服務中開啟它。確認其位置與存取權限，包括相關的正確組織、工作區、資料夾或屬性。
3. 讓請求更具體。 在 connector 支援的情況下，請指明服務名稱，並提供確切的資源名稱或連結。先要求一項受支援的讀取操作，而不是一次搜尋並變更多個資源。

例如，如果 connector 支援讀取文件：「使用 [service] 讀取 [document name or link] 並告訴我它的標題。不要變更它。」

檢查結果： 智能體會返回目標資源。如果直接存取可行，但智能體仍無法讀取，請檢查 connector 支援的能力與已授予的存取權限。只有在有授權問題證據時才重新連線。

智能體可以讀取資料，但無法變更資料

成功讀取並不代表 connector 支援所要求的變更，或具有執行該變更的權限。

1. 請參閱 連線與管理整合 或 connector 的 What you can do 清單（若有顯示）。確認所要求的操作受支援。
2. 檢查已連線的帳戶是否被允許對該確切資源進行該變更。僅向資源擁有者或管理員申請所需的存取權限。
3. 閱讀任何錯誤或確認請求。如果需要額外授權，請依照該服務記錄的流程操作。重新連線無法新增 connector 不支援的操作。

在重試寫入前： 檢查目標位置，確認第一次嘗試是否已建立或變更了某些內容。僅憑失敗回應不足以證明沒有發生任何變更。在你確認先前結果之前，不要重複付款、訊息、邀請或記錄建立。

檢查結果： 受支援的變更可在適當的測試資源上成功執行，且你已直接在服務中確認。對於付款或其他正式工作流程，請使用該服務特定的測試說明，而非真實交易。

先前可用的連線已停止運作

檢查自上次成功請求後有哪些變更：帳戶、其對資源的存取權限、組織的 app 政策，或連線的授權。

1. 在 Atoms 中重新開啟整合，並檢查它是否仍為已連線。
2. 嘗試直接在服務中開啟該資源。如果存取權限已被移除，請與資源擁有者或管理員處理。
3. 如果錯誤指出授權已過期、已被撤銷或無效，請依照 安全地重新連線 操作。如果錯誤與服務中斷、限制或不支援的操作有關，請先處理該原因。

檢查結果： 小型讀取請求再次可用。如果相同錯誤仍存在，請連同最後一次成功時間一併保存並聯絡支援。

結果已過時，或請求持續失敗

1. 將結果與服務本身進行比對。確認帳戶、資源、日期範圍、篩選條件，以及相關時區。請要求智能體擷取目前值，而不是依賴對話中較早的回答。
2. 若出現明確的逾時或服務不可用錯誤，請查看該服務的官方狀態頁或說明頁。如果錯誤提供重試時間，請等到該時間；在限制或中斷持續期間，不要反覆送出請求。
3. 保存任何尚未送出的文字，重新整理 Atoms，並再次檢查 connector 狀態。重新整理頁面與重新授權帳戶並不相同。
4. 重試一個小型讀取請求。在重試任何會變更外部資料的操作前，請先檢查目標位置是否已有先前結果。

檢查結果： 最新結果與服務中的目標資源一致。如果仍不正確，請將預期值與實際值連同時間戳記提供給支援。不要假設每項整合都以相同排程更新。

安全地重新連線

僅在授權無效或連結了錯誤帳戶時重新連線，而不是把它當成每次請求失敗時的第一步。

中斷連線前： 完成或暫停依賴此連線的任務，檢查任何待處理外部寫入的結果，並確認你可以使用所需權限再次登入。中斷連線會使該連線在重新連線前無法使用。請查看 連線與管理整合 以了解任何其他影響；不要假設中斷連線會還原先前變更或取消已送出的工作。

1. 開啟該服務的連線詳細資料。如果它有自己的帳戶管理畫面，請依照該整合的說明操作。
2. 在標準 connector 詳細畫面中，準備好後選取 Disconnect ，再選取 Connect 。不要假設中斷連線前一定會有額外確認。
3. 選擇你要使用的帳戶並完成授權。檢查所要求的權限。
4. 返回 Atoms 並確認已連線狀態。
5. 在恢復原始任務前，執行下方的復原檢查。

如果相同錯誤再次出現，請停止重新連線，並將錯誤與已完成的檢查一併提供給支援。

確認問題已解決

1. 要求執行一項受支援的唯讀操作，且該資源可由你直接驗證。如果你使用 Try it out ，請在送出前檢查建議的提示詞。
2. 將回應與服務本身進行比對。確認正確的資源、帳戶情境與要求的結果，而不只是已連線指示。
3. 如果你的任務需要變更，請使用適當的測試資源或該服務記錄的測試工作流程，並在目標位置驗證結果。

檢查連線狀態與所選資源。僅有已連線指示，並不代表預期資料可用或為最新。

確認組織與專案，然後開啟 Dashboard 以檢查資源而不進行變更。中斷連線不是此檢查的一部分。

如果檢查通過，請恢復你的任務。如果 Chat 可用，但功能在你的 app 內仍失敗，請參閱 連線與管理整合 或 建置與預覽疑難排解 。請檢查失敗發生的環境；Chat 請求成功並不能證明 app 已正確設定。

取得協助

如果問題仍持續，請使用 取得支援 並附上：

• 整合名稱與你的 Atoms 帳戶電子郵件。
• 受影響的專案或 Chat 連結，以及失敗是發生在 Chat 還是你的 app 中。若為 app，請指出受影響的環境。
• 目標服務帳戶與資源，僅使用調查所需的非機密識別資訊。
• 確切錯誤、日期、時間與時區；若已知，也請附上最後一次成功時間。
• 重現步驟、預期結果、實際結果，以及已嘗試的檢查。
• 你的瀏覽器與裝置，以及經遮蔽處理的螢幕截圖或簡短錄影（若有幫助）。

若為寫入失敗，請說明目標位置顯示的是已完成變更、沒有變更，或結果未知。請從所有附件中移除密碼、登入代碼、API 金鑰、Token，以及無關的私人資料。