整合疑難排解

本頁面涵蓋 Atoms 中常見的連線與授權問題。若要查看特定服務的設定、支援的操作，或你 app 內的設定方式，請先參閱 Connect and Manage Integrations 並選擇你的服務指南。

先進行這些檢查

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

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

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

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

找出你的問題

你看到的情況	從這裡開始
找不到某項服務，或其控制項無法使用	尋找或啟動整合
登入畫面無法開啟、遭到封鎖，或始終無法完成	完成授權
連線使用了不同的帳戶	檢查已連線的帳戶
已連線，但智能體找不到資源	檢查連線與資料存取權限
可以讀取，但建立或編輯失敗	檢查寫入權限與支援的操作
先前可用的連線失敗了	檢查變更了什麼
結果過舊、請求逾時，或錯誤重複發生	檢查請求與服務可用性

你找不到或無法啟動整合

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

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

授權無法完成

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

在完成授權前，先檢查所要求的存取權限。授權帳戶本身並不能證明目標資源已連線。

如果授權包含組織或工作區選擇器，請確認你選擇的是預期目標，並檢查所要求的權限。

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

已連線的是錯誤的帳戶

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

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

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

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

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

例如，如果 connector 支援讀取文件：「Use [service] to read [document name or link] and tell me its title. Do not change it.」

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

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

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

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

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

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

先前可用的連線現在停止運作

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

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

檢查結果： 一個小型讀取請求再次成功。如果相同錯誤仍然存在，請保存錯誤內容與上次成功時間，並聯絡支援。

結果過期或請求持續失敗

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

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

安全地重新連線

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

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

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

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

確認問題已解決

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

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

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

如果檢查通過，請恢復你的任務。如果 Chat 可正常運作，但功能在你的 app 內仍然失敗，請參閱 Connect and Manage Integrations 或 build and preview troubleshooting。請檢查失敗發生的環境；Chat 請求成功並不能證明 app 已正確設定。

取得協助

如果問題仍然存在，請使用 Get support 並附上：

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

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