> ## 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.
# Agent 友好
> 把你在 superun 上做的應用變成 AI 智慧體可以直接調用的工具。
## 這是什麼
「Agent 友好」可以讓你在 superun 上做的應用變成 AI 智慧體能直接調用的工具。
你不需要寫程式碼，也不需要部署 MCP 服務。複製一段指引給支援 Skill / MCP 的 AI 助手，它就能安裝 superun CLI 和 Skill，並以你的身份調用應用裡現成的資料和接口，用對話完成業務操作。
簡單理解：它會把你的 superun 應用包裝成 AI 智慧體的工具箱。
Agent 友好使用 **superun CLI** 操作執行中應用的資料和接口。它不同於用來同步原始碼、預覽編譯和發佈專案的**蘇小強 CLI（`sxq`）**。詳見[命令列工具](/superun/cli/overview)中的比較。
***
## 入口位置
你可以從兩個入口打開同一個面板：
1. 專案頁 → **「運營」** Tab → **「Agent 友好」** 面板。
2. 專案頁 → **「研發」** Tab → **「技能庫」** → **「Agent 友好」** 卡片。
***
## 狀態說明
| 狀態 | 含義 | 頁面表現 |
| --- | ------------------- | ------------------------------- |
| 未對接 | 還沒有生成 Agent 友好的 CLI | 詳情頁顯示 **「生成 Agent 友好的 CLI」** 按鈕 |
| 對接中 | 正在生成 | 顯示載入狀態與進度提示 |
| 已對接 | CLI 已生成 | 卡片顯示已啟用標記，詳情頁展示安裝命令與 Skill 下載連結 |
***
## 第一步：生成 CLI
在 Agent 友好面板中點擊 **「生成 Agent 友好的 CLI」**。
生成完成後，面板會出現兩個 Tab：
* **我是小白**：推薦給大多數使用者，複製一整段提示詞給 AI 助手即可。
* **我是高手**：直接展示命令，適合自己在終端機裡操作。
***
## 第二步：讓智慧體安裝 CLI 和 Skill
### 我是小白
1. 複製面板裡的一整段提示詞。
2. 貼給你的 AI 助手，例如支援 Skill / MCP 的智慧體。
3. 智慧體會按指引完成安裝、配置和探索命令。
完成後，你就可以在 AI 助手裡用自然語言驅動應用做事。
### 我是高手
如果你熟悉命令列，可以在 **「我是高手」** Tab 中複製命令並自行執行。
常見步驟包括：
1. 安裝 superun CLI。
2. 配置當前應用。
3. 下載並安裝 Skill。
***
## 第三步：用對話驅動應用
完成安裝後，回到你的 AI 助手，直接用自然語言下達指令，例如：
* 「幫我看下我的應用今天有多少新訂單」
* 「把昨天的銷量統計成一張表」
* 「在我的應用裡給 [user@example.com](mailto:user@example.com) 發一條通知」
智慧體會透過 superun CLI 以你的身份調用應用接口完成操作。
***
## 系統要求
* AI 助手側需要 Node 20+，用於安裝 superun CLI。
* AI 助手需支援 Skill / MCP。
* superun 專案需已有可供調用的資料和接口能力。
***
## 常見問題
不會。CLI 會以你的身份調用應用接口，相當於你本人在操作。請只把安裝指引交給你信任的 AI 助手或執行環境。
通常不需要。系統會基於應用已有的資料和接口能力生成智慧體可理解的調用方式。
如果應用的資料結構或接口發生變化，可以在詳情頁點擊 **「更新對接」**，讓智慧體拿到最新能力。
支援簡體、繁體、粵語、英語、日語和韓語。