> ## 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.

# superun 通用智能体

> 在项目对话中一句话搭建内置智能体的应用，支持流式问答、多会话、云端文件、长期记忆与后端动作。

## 这是什么

「superun 通用智能体」可以让你在自己搭建的应用里内置一个会聊天、会干活的智能体：你的用户在应用中提问，智能体实时流式回答；它还能阅读你上传的资料、记住每个用户的偏好、生成 Excel / Word / PPT / PDF 文档，甚至执行查订单、发退款这样的真实业务动作。

你不需要写代码。在项目对话中把需求说清楚，superun 会自动完成智能体创建、后端接入和聊天界面搭建；之后的调整同样用对话完成。

典型场景：

* **知识库问答**：上传产品手册、规章制度等资料，智能体只依据资料回答并注明出处；资料里没有的问题会明确说「知识库中没有」，不会瞎编。
* **智能客服**：基于公司知识库回答咨询，还能查订单、办退款、转人工；承诺的事都经过系统校验。
* **办公助理**：记住每位员工做过的事，读写 Excel / PPT / Word / PDF，如「把这组数据整理成周报」「上周我都做了什么？」。
* **个人助理**：跨会话的长期记忆，今天聊到的偏好和进行中的项目，下周开新会话它还记得。

***

## 第一步：描述你要的智能体

在项目对话中直接说，例如：

```text theme={null}
帮我搭建一个智能问答应用：用户提问后智能体流式回答，支持多个会话。
智能体的角色是「母婴产品选购顾问」，语气亲切专业。
```

角色描述越具体，回答质量越好：它是谁、擅长什么、什么语气、遇到不会的问题怎么办。

***

## 第二步：superun 自动搭建

superun 会自动完成三件事：

1. **创建智能体**：按你的描述设定角色与能力。
2. **接入后端服务**：会话管理、断线续传等都已内置。
3. **搭好聊天界面**：之后可以随时让它调整样式。

***

## 第三步：验证效果

搭建完成后发一条消息试试：

* 回答实时流式呈现，思考时有运行指示。
* 刷新页面、关闭标签页、网络中断都会自动恢复，回到页面时对话接着上次继续，内容不会丢。
* 每个会话独立保存，随时可以回来继续聊。

搭好之后想调整，通常只需要说三类话：**改角色**（「把智能体的角色改成……」）、**改界面**（「把聊天窗口改成暗色主题」）、**加能力**（见下方「能力扩展」）。

***

## 能力扩展

智能体默认就带一套预置工具，开箱即用、无需开启：

* **运行代码与命令**：在独立的运行环境里执行代码、处理数据，例如现场算出一份统计结果。
* **读写文件**：读取、编写、修改工作区里的文件，云端文件和办公文档产出都建立在它之上。
* **检索资料**：按文件名和文本内容在资料里快速查找，知识库问答靠它精准定位出处。
* **联网搜索与读取网页**：搜索互联网、抓取指定网页内容，例如「回答时可以联网查最新信息」。

在此基础上，以下能力按需开启：想要哪个，在项目对话中说一句即可。

### 多会话

像常见的 AI 聊天产品一样，左侧有会话列表，可以新建、切换、重命名、删除会话。对话里说「给聊天加上多会话侧边栏，支持新建和删除会话」即可。

### 云端文件

**上传**：让智能体基于你给的文档回答，产品手册、合同、报告都可以，对话里说「支持上传 PDF / Word 资料，让智能体根据资料内容回答问题」。

**下载**：智能体生成的文件（报表、文档等）会出现在会话的文件列表中，点击即可下载。

<Warning>
  上传的云端文件**文件名请使用英文字母和数字**（如 `product-manual.pdf`），使用中文文件名会导致上传失败。文件内容是中文没有任何问题。
</Warning>

<Note>
  智能体刚生成的文件需要几秒钟才会出现在文件列表中；如果列表暂时是空的，稍等片刻再刷新即可。
</Note>

### 办公文档产出

说「让智能体支持生成 Excel 报表和 PPT」后，智能体可以直接产出办公文件，例如「把这组销售数据整理成 Excel 报表」「按这个大纲生成一份 PPT」「把这次对话的结论输出成 PDF」。

### 长期记忆

默认情况下每个会话是独立的；说「给智能体加上长期记忆，让它记住每个用户的偏好和进行中的事项」后，智能体能跨会话记住用户，今天说过的偏好、进行中的事项，下周开新会话它依然记得。

记忆的范围可以按需设计：每人一份私人记忆、团队共享一份记忆、或全体用户共用一份知识，都可以在描述需求时说明。

### 真实业务动作

让智能体不止会「说」，还会「做」：查数据库、调用外部接口、写入业务数据。例如「智能体要能查订单状态（从我的订单表查），还要能发起退款，退款前必须校验订单是否符合退款条件」。

* **关掉页面也能完成**：用户发起动作后即使关闭了标签页，动作依然会执行完，结果不会丢。
* **敏感动作在服务端校验**：退款金额、操作资格等规则由后端把关，智能体无法越权。

### 对话中的确认与选择

需要用户做决定时，智能体可以在回答中直接给出按钮、表单或确认框，用户点选后对话继续，适合退款确认、多选一、填写信息等场景。例如「退款前让智能体弹出确认按钮，用户点击确认后才执行」。

### 连接外部系统

智能体可以接入你指定的外部服务：查询内部系统、调用第三方平台接口、读取在线数据源等。例如「让智能体能查询我们内部工单系统的工单状态」。

### 多用户与数据隔离

上线给多人使用前，建议开启用户登录：每个用户只能看到自己的会话和文件，数据天然隔离。对话里说「开启用户登录，每个用户只能看到自己的会话」即可。

***

## 使用须知

* **云端文件名用英文**：上传文件请使用英文字母和数字命名，中文文件名会导致上传失败。
* **产出文件有几秒延迟**：刚生成的文件稍等片刻才会出现在下载列表中。
* **中断不用担心**：刷新、断网、关页面都会自动恢复，无需任何处理。
* **会话数据在你自己的项目里**：对话记录保存在你项目的数据库中，由你完全掌控。
* **回答质量取决于角色设定和资料**：遇到答非所问，优先调整角色描述，或上传资料并要求「只依据资料回答，找不到就明确说没有」。

***

## 常见问题

<AccordionGroup>
  <Accordion title="需要自己写代码吗？">
    不需要。在项目对话中描述需求即可，superun 会完成全部搭建；之后的调整同样用对话完成。
  </Accordion>

  <Accordion title="怎么计费？">
    按实际算力从 superun 余额扣除。
  </Accordion>

  <Accordion title="用户回答看到一半刷新了页面，会丢内容吗？">
    不会。回到页面后对话自动恢复，回答会接着上次的进度继续显示。
  </Accordion>

  <Accordion title="上传文件总是失败？">
    最常见的原因是文件名包含中文。把文件重命名为英文（如 `manual.pdf`）再上传即可。
  </Accordion>

  <Accordion title="智能体生成的文件在哪里下载？">
    在对应会话的文件列表中。刚生成的文件有几秒延迟，列表为空时稍等片刻再刷新。
  </Accordion>

  <Accordion title="智能体乱答、编造内容怎么办？">
    上传资料建立知识库，并在角色设定中要求「只依据资料回答，资料里没有就明确说不知道」；也可以让回答附上出处，方便核对。
  </Accordion>

  <Accordion title="一个应用里能有多个不同角色的智能体吗？">
    可以。直接说「再加一个 XX 角色的智能体」，每个智能体有独立的角色设定，会话互不干扰。
  </Accordion>
</AccordionGroup>