> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 連接器

> 連接飛書、Notion 等平台，在對話中搜尋、讀取和整理你已授權的工作資料。

## 連接器能做什麼

連接器讓 superun 在對話中使用你已授權的外部資料。例如，讀取需求文件、整理會議記錄，或比較兩份資料，再用於需求梳理、諮詢與研發。

目前使用範圍是**查詢、讀取和整理資料**，暫不提供向外部平台寫入、更新或刪除內容的能力。

<Info>
  連接器用於你與 superun 的對話。技能庫中的飛書、釘釘等整合，則用於替你建立的應用程式加入登入、訊息等功能；兩者的用途和授權設定不同。
</Info>

## 可連接的平台

| 平台 | 連接的帳號或資料範圍 |
| - | - |
| 飛書 | 已授權的飛書工作資料 |
| 釘釘 | 所選組織中已授權的工作資料 |
| 企業微信 | 機器人獲准存取的工作資料 |
| Notion | 授權工作空間中允許存取的頁面 |
| GitHub | 授權允許存取的 GitHub 資源 |
| 金山文件 | 在 WPS 授權頁面允許存取的資料 |
| 騰訊文件 | 授權允許存取的線上文件和試算表 |

實際開放的平台和可讀取內容，以「我的連接器」頁面及平台授權範圍為準。

## 首次連接

<Steps>
  <Step title="開啟連接器">
    點擊頭像選單中的 **「我的連接器」**。也可以在首頁或專案對話的附件選單中選擇 **「使用連接器」**，進入管理面板。
  </Step>

  <Step title="選擇平台並授權">
    點擊目標平台的 **「連接」**，依頁面提示完成掃碼或網頁授權。首次使用可能先顯示「正在準備連接環境…」。

    飛書首次連接可能分為「建立飛書應用」和「授權飛書帳號」兩步，請依序完成，等待頁面自動進入下一步。
  </Step>

  <Step title="確認連接狀態">
    回到 superun，確認狀態為 **「已授權」**，且開關已開啟。連接屬於你的帳號，可在不同專案中重複使用，無需每個專案重新連接。
  </Step>
</Steps>

## 在對話中使用

在探索、諮詢或研發對話中，說明**使用哪個平台、讀取什麼資料、希望如何處理**。提供文件連結或明確的標題、時間範圍，有助於找到目標內容。

例如：

* 「讀取這個 Notion 需求文件，整理目標使用者、核心流程和待確認問題：文件連結。」
* 「在飛書中搜尋本週的專案會議記錄，彙整結論和待辦，並列出來源。」
* 「比較這兩份已授權的文件，指出需求差異，先不要修改專案程式碼。」

授權完成後可以回到原對話繼續請求，無需為連接器另開對話。需要最新內容時，請明確要求「重新讀取」，避免只根據之前的對話資料回答。

## 管理連接

| 操作 | 作用 |
| - | - |
| 開啟 | 允許在對話中使用該連接器，仍需授權有效 |
| 關閉 | 暫停使用，保留授權；此開關影響你的不同專案 |
| 重新授權 | 授權已失效或需要調整授權範圍時，依提示再次授權 |
| 解除連接 | 清理 superun 儲存的連接憑證；再次使用需重新連接 |

連接根據目前發起請求的使用者授權，不會因為協作加入專案就自動取得其他成員的外部帳號權限。

## 常見問題

| 遇到的情況 | 如何處理 |
| - | - |
| 授權視窗沒有開啟 | 依頁面提示點擊「繼續授權」或「開啟授權頁面」，並允許授權彈出視窗 |
| 一直顯示授權中 | 確認廠商頁面的步驟已完成；可重新開啟面板查看進度。關閉面板不等於取消授權；授權逾時後重新連接 |
| 已授權，但讀不到某份資料 | 檢查帳號、資料的授權範圍及該帳號的存取權限。連接成功不代表所有內容都可存取 |
| Notion 讀不到指定頁面 | 檢查授權時是否已選擇或允許存取目標頁面，需要時補充頁面存取範圍後重試 |
| 提示授權已失效 | 對相應平台重新授權，再於原對話重新發起讀取 |
| 傳回的資料不完整 | 依提示補充資料、調整範圍或補齊權限，再要求重新讀取；不要將部分結果視為完整資料 |

### 釘釘提示需管理員開通

請所選組織的管理員進入 **釘釘開發者平台 → 更多 → 基本資訊 → CLI 設定**，開啟「允許成員透過 CLI 存取個人資料」，並在「使用範圍管理」中將你的帳號加入可用範圍。完成後回到 superun 重新連接，授權時選擇相同組織。

### 企業微信已連接，但無法讀取既有文件

請本次連接的機器人建立者進入 **企業微信 → 工作台 → 智能機器人 → 對應機器人 → 編輯 → 可使用權限 → 文件**，為「搜尋與取得文件內容」完成授權；如需審批，請聯絡企業管理員。

權限顯示已授權後，在 superun 原對話重新請求讀取即可，無需先解除連接再連接。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.