> ## 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 服务。

<Note>
  本能力使用 **superun CLI** 操作运行中应用的数据和接口。它不同于用于同步源码、预览编译和发布项目的 **苏小强 CLI（`sxq`）**。详见 [命令行工具](/superun/cli/overview)。
</Note>

***

## 两个入口（名称不同，能力相同）

产品里有两个入口，**显示名称不一样**，打开的是同一套能力：

| 入口 | 你在界面上看到的名字 | 怎么走 |
| - | - | - |
| **运营** | 侧栏 **「Agent 友好」** | 项目页 → **运营** → **Agent 友好** |
| **技能库** | 卡片标题 **「连接 AI 应用」** | 项目页 → **研发** → **技能库** → **连接 AI 应用** |

技能库介绍页常见文案：

* 标题：**连接 AI 应用**
* 标签：**Agent 友好**
* 副标题：让 AI 应用通过技能或连接器使用此项目中的数据和功能
* 右上角可点 **「生成」** / **「使用」**（以产品内按钮为准）

不要把两个名字理解成两套功能：只是运营侧栏与技能库卡片的叫法不同。

***

## 能力亮点（以产品介绍页为准）

* **在常用应用里对话**：用自然语言提需求，不必反复敲技术命令。
* **使用现有项目能力**：接通后，AI 应用可查询项目数据并使用已有功能。
* **两种接入方式**：生成完成后，按目标应用支持情况选择 **技能** 或 **连接器**。
* **沿用登录和权限**：只能访问当前账号有权看到的内容；重要操作需确认。

***

## 状态说明

| 状态 | 含义 | 页面表现（示例） |
| - | - | - |
| 未对接 | 尚未生成接入能力 | 显示 **生成** / **使用** 类按钮 |
| 生成中 | 正在准备项目接入能力 | 如「生成中…」「正在准备项目接入能力」；完成后才显示技能和连接器的复制指令 |
| 已对接 | 已可复制指引 | 展示技能 / 连接器等复制指令 |

***

## 接入流程

1. 从 **运营 → Agent 友好**，或 **技能库 → 连接 AI 应用** 进入，点击右上角 **生成**（或 **使用**）准备接入能力。
2. 生成完成后，按目标 AI 应用支持情况，选择 **技能** 或 **连接器**。
3. 把给出的指令复制到目标 AI 应用，做一次测试查询确认接通。

应用数据结构或接口变更后，可在配置 / 详情中更新对接，让外部助手拿到最新能力。

***

## 发布项目专家或插件

你也可以在 **发布到 AI 平台 → WorkBuddy 专家** 中导出当前项目的专家包，上传 WorkBuddy 开放平台并提交审核，让其他用户安装后使用自己的项目账号授权访问。

查看 [WorkBuddy 项目专家上传教程](/superun/third-party-apps/workbuddy/publish-project-expert)，了解下载、上传、补充分类和提交审核的完整步骤。

如果使用 Qoder，在 **发布到 AI 平台 → Qoder 插件** 中导出插件包，再按 [Qoder 项目插件上传教程](/superun/third-party-apps/qoder/publish-project-plugin) 手动上传图标、填写发布信息和提交审核。

***

## 费用说明

* **生成与配置接入能力本身**不另收 superun 额外费用（以产品内说明为准）。
* AI 应用**实际调用**项目功能时消耗的算力，按用量从你的 superun 余额扣除。

***

## 系统要求

* 外部 AI 助手侧通常需要 Node 20+（用于安装 superun CLI；以当前指引为准）。
* 助手需支持 Skill 和 / 或连接器（含 MCP，取决于你选的路径）。
* superun 项目需已有可供调用的数据和接口能力。

***

## 常见问题

<AccordionGroup>
  <Accordion title="「Agent 友好」和「连接 AI 应用」是不是两个功能？">
    不是。运营侧栏叫 **Agent 友好**，技能库卡片标题叫 **连接 AI 应用**（并带 Agent 友好标签），打开的是同一能力。
  </Accordion>

  <Accordion title="会不会让别人也能访问我的应用？">
    不会按「公开给所有人」处理。访问沿用当前登录与权限；请只把安装指引交给你信任的 AI 助手或运行环境。
  </Accordion>

  <Accordion title="技能和连接器有什么区别？">
    都是把项目能力交给外部 AI 使用；差别在对接形态。按目标应用支持情况，在生成完成后的面板里二选一复制指令即可。
  </Accordion>

  <Accordion title="为什么一直显示「生成中」？">
    系统正在准备项目接入能力。生成完成后才会显示技能和连接器的复制指令；请稍候或刷新后查看（以产品内为准）。
  </Accordion>
</AccordionGroup>