> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Agent 友好
> 讓 AI 應用通過技能或連接器使用此專案中的數據和功能。運營入口為「Agent 友好」，技能庫卡片名為「連接 AI 應用」。
## 這是什麼
把專案接到 WorkBuddy、豆包工作等常見 AI 應用後，可用對話查詢數據、使用專案功能（各應用 / 版本支持情況不同，以實際為準）。
生成接入能力後，可按目標應用支持情況，選擇 **技能** 或 **連接器** 兩種方式複製指令完成對接。
你通常不需要自己寫接口，也不需要單獨部署一套 MCP 服務。
本能力使用 **superun CLI** 操作運行中應用的數據和接口。它不同於用於同步源碼、預覽編譯和發布專案的 **蘇小強 CLI（`sxq`）**。詳見 [命令行工具](/zh-Hant/superun/cli/overview)。
***
## 兩個入口（名稱不同，能力相同）
產品裏有兩個入口，**顯示名稱不一樣**，打開的是同一套能力：
| 入口 | 你在界面上看到的名字 | 怎麼走 |
| - | - | - |
| **運營** | 側欄 **「Agent 友好」** | 專案頁 → **運營** → **Agent 友好** |
| **技能庫** | 卡片標題 **「連接 AI 應用」**（旁有 **Agent 友好** 標籤） | 專案頁 → **研發** → **技能庫** → **連接 AI 應用** |
技能庫介紹頁常見文案：
* 標題：**連接 AI 應用**
* 標籤：**Agent 友好**
* 副標題：讓 AI 應用通過技能或連接器使用此專案中的數據和功能
* 右上角可點 **「生成」** / **「使用」**（以產品內按鈕為準）
不要把兩個名字理解成兩套功能：只是運營側欄與技能庫卡片的叫法不同。
***
## 能力亮點（以產品介紹頁為準）
* **在常用應用裏對話**：用自然語言提需求，不必反覆敲技術命令。
* **使用現有專案能力**：接通後，AI 應用可查詢專案數據並使用已有功能。
* **兩種接入方式**：生成完成後，按目標應用支持情況選擇 **技能** 或 **連接器**。
* **沿用登入和權限**：只能訪問當前帳號有權看到的內容；重要操作需確認。
***
## 狀態說明
| 狀態 | 含義 | 頁面表現（示例） |
| - | - | - |
| 未對接 | 尚未生成接入能力 | 顯示 **生成** / **使用** 類按鈕 |
| 生成中 | 正在準備專案接入能力 | 如「生成中…」「正在準備專案接入能力」；完成後才顯示技能和連接器的複製指令 |
| 已對接 | 已可複製指引 | 展示技能 / 連接器等複製指令 |
***
## 接入流程
1. 從 **運營 → Agent 友好**，或 **技能庫 → 連接 AI 應用** 進入，點擊右上角 **生成**（或 **使用**）準備接入能力。
2. 生成完成後，按目標 AI 應用支持情況，選擇 **技能** 或 **連接器**。
3. 把給出的指令複製到目標 AI 應用，做一次測試查詢確認接通。
應用數據結構或接口變更後，可在配置 / 詳情中更新對接，讓外部助手拿到最新能力。
***
## 費用說明
* **生成與配置接入能力本身**不另收 superun 額外費用（以產品內說明為準）。
* AI 應用**實際調用**專案功能時消耗的算力，按用量從你的 superun 餘額扣除。
***
## 系統要求
* 外部 AI 助手側通常需要 Node 20+（用於安裝 superun CLI；以當前指引為準）。
* 助手需支持 Skill 和 / 或連接器（含 MCP，取決於你選的路徑）。
* superun 專案需已有可供調用的數據和接口能力。
***
## 常見問題
不是。運營側欄叫 **Agent 友好**，技能庫卡片標題叫 **連接 AI 應用**（並帶 Agent 友好標籤），打開的是同一能力。
不會按「公開給所有人」處理。訪問沿用當前登入與權限；請只把安裝指引交給你信任的 AI 助手或運行環境。
都是把專案能力交給外部 AI 使用；差別在對接形態。按目標應用支持情況，在生成完成後的面板裏二選一複製指令即可。
系統正在準備專案接入能力。生成完成後才會顯示技能和連接器的複製指令；請稍候或刷新後查看（以產品內為準）。