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

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