> ## 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 助手或运行环境。
通常不需要。系统会基于应用已有的数据和接口能力生成智能体可理解的调用方式。
如果应用的数据结构或接口发生变化，可以在详情页点击 **「更新对接」**，让智能体拿到最新能力。
支持简体、繁体、粤语、英语、日语和韩语。