# 對話介面

## 助手同話題

### 助手

`助手` 係對所選模型做一啲個性化設定嚟使用模型，例如提示詞預設同參數預設等，透過呢啲設定令所選模型更符合你預期嘅工作。

`系統預設助手` 預設咗一個比較通用嘅參數（無提示詞），你可以直接使用或者去 [智能體頁面](/docs/zhong-wen-fan-ti/cherry-studio/preview/agents.md) 搵你需要嘅預設嚟用。

### 話題

`助手` 係 `話題` 嘅父集，單個助手下可以建立多個話題（即對話），所有 `話題` 共用 `助手` 嘅參數設定同預設詞（prompt）等模型設定。

<figure><img src="/files/1285c8f1c6f5faaf0773ba342ec194ab317a6c9c" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/e20805316d25e962a9d512c353f7b6575e2369be" alt=""><figcaption></figcaption></figure>

## 對話框內按鈕

<figure><img src="/files/29a92b29ed80dcc7e2203e9eec5c0d1c3716b566" alt=""><figcaption></figcaption></figure>

![](/files/5c2e2bc9e2c155d0a233baaa12b80f306af1becb) `新話題` 喺當前助手內建立一個新話題。

![](/files/3df1819be0487f6962695509373a05a502739e7b) `上載圖片或文件` 上載圖片需要模型支援，上載文件會自動解析成文字作為上下文提供俾模型。

![](/files/467879e0da41c946a234b8e9fdcacb949bb10ecc) `網絡搜尋` 須喺設定中配置網絡搜尋相關資訊，搜尋結果作為上下文返回俾大模型，詳見 [聯網模式](/docs/zhong-wen-fan-ti/pre-basic/websearch.md)。

![](/files/16b159a2f2a5ce36020e59765da3966041ed08c1) `知識庫` 開啟知識庫，詳見 [知識庫教學](/docs/zhong-wen-fan-ti/knowledge-base/knowledge-base.md)。

![](/files/bfc7c16a21eabe12902a0fff24b56848bc494fac) `MCP 伺服器` 開啟 MCP 伺服器功能，詳見 [MCP 使用教學](/docs/zhong-wen-fan-ti/advanced-basic/mcp.md)。

![](/files/3f4eaa43cc2c15ee877c517b8ff47096472d4db8) `生成圖片` 只有選擇嘅 **對話模型** 支援生圖時先會顯示。（非對話生圖模型請前往 [繪圖](/docs/zhong-wen-fan-ti/cherry-studio/preview/drawing.md)）

![](/files/bf75524daaaddf6160008cf13666e87f80e98bbc) `選擇模型` 對於接落嚟嘅對話，切換成指定嘅模型，保留上下文。

![](/files/0b83861b4a44723b108bc1b6c95761fdae09b085) `快捷短語` 需要先喺設定中預設常用短語，喺呢度調用，直接輸入，支援變量。

![](/files/d1f1d5669cf5c17f40b13c46471150eca3e7ec83) `清空消息` 刪除呢個話題下所有內容。

![](/files/d946e82bcaf07508045eb60fab8f1bd1b9fc9798) `展開` 令對話框變得更大，以便輸入長文。

![](/files/0eb3db48c3bfe6201132b6e562939fcbc8c426b1) `清除上下文` 喺唔刪除內容嘅情況下，截斷模型可獲得嘅上下文，即係話模型會「忘記」之前嘅對話內容。

![](/files/4677237aef00712506bdd853398933749acfa926) `預估 Token 數` 展示預估 Token 數，四個數據分別係 `當前上下文數` 、 `最大上下文數` （ ∞ 表示無限上下文）、 `當前輸入框內消息字數` 、 `預估 Token 數` 。

{% hint style="info" %}
呢個功能只用嚟預估 Token 數，實際 Token 數每個模型都唔一樣，請以模型提供商嘅數據為準。
{% endhint %}

![](/files/b906a539f5292a9d1f624b82950d4470d8af38cc) `翻譯` 將當前輸入框內內容翻譯成英文。

## 對話設定

<figure><img src="/files/5b4a8d8fcb74b6a8d825322ae7a98731b514e173" alt=""><figcaption></figcaption></figure>

### 模型設定

模型設定同助手設定入面嘅 `模型設定` 參數同步，詳見 [助手設定](#bian-ji-zhu-shou)。

{% hint style="info" %}
喺對話設定當中，只有該模型設定作用於當前助手，其餘設定作用於全局。例如：設定消息樣式為氣泡後，喺任何助手嘅任何話題下都係氣泡樣式。
{% endhint %}

### 消息設定

#### <mark style="color:blue;">**`消息分隔線`**</mark>:

使用分隔線將消息正文同操作欄隔開。

{% tabs %}
{% tab title="開啟時" %}

<figure><img src="/files/e09e40bb2b6a0c23c995b7943860778ae43fc1c0" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="關閉時" %}

<figure><img src="/files/b6768adc9d95630562b8f7b3996b19e75d661b33" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

#### <mark style="color:blue;">**`使用襯線字體`**</mark>：

字體樣式切換，宜家你亦可以透過 [自定義 css](/docs/zhong-wen-fan-ti/pre-basic/personalization-settings.md) 嚟更換字體。

#### <mark style="color:blue;">**`代碼顯示行號`**</mark>：

模型輸出代碼片段時顯示代碼塊行號。

{% tabs %}
{% tab title="關閉時" %}

<figure><img src="/files/3a65892b541ba4ce356ee03716f51fe00aef6d20" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="開啟時" %}

<figure><img src="/files/9ee10093766774cf846ba21c04662af99b996627" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

#### <mark style="color:blue;">**`代碼塊可摺疊`**</mark>：

打開後，當代碼片段中代碼較長時，會自動摺疊代碼塊。

#### <mark style="color:blue;">**`代碼塊可換行`**</mark>：

打開後，當代碼片段中單行代碼較長時（超出窗口），會自動換行。

#### <mark style="color:blue;">**`思考內容自動摺疊`**</mark>：

打開後，支援思考嘅模型喺思考完成後會自動摺疊思考過程。

#### <mark style="color:blue;">**`消息樣式`**</mark>：

可切換對話界面為氣泡樣式或列表樣式。

#### <mark style="color:blue;">**`代碼風格`**</mark>：

可切換代碼片段嘅顯示風格。

#### <mark style="color:blue;">**`數學公式引擎`**</mark>：

* KaTeX 渲染速度更快，因為佢係專門為性能優化設計嘅；
* MathJax 渲染較慢，但功能更全面，支援更多數學符號同命令。

#### <mark style="color:blue;">**`消息字體大小`**</mark>：

調整對話界面字體嘅大小。

### 輸入設定

#### <mark style="color:blue;">**`顯示預估 Token 數`**</mark>：

喺輸入框顯示輸入文字預估消耗嘅 Token 數（非實際上下文消耗嘅 Token，僅供參考）。

#### <mark style="color:blue;">**`長文本貼上為文件`**</mark>：

當從其他地方複製長段文本貼上到輸入框時會自動顯示為文件樣式，減少後續輸入內容時嘅干擾。

#### <mark style="color:blue;">**`Markdown 渲染輸入消息`**</mark>：

關閉時只渲染模型回覆嘅消息，不渲染發送嘅消息。

{% tabs %}
{% tab title="關閉時" %}

<figure><img src="/files/ffb6f9975fa02d252286036ddb299b81e5fe6eb3" alt="" width="563"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="開啟時" %}

<figure><img src="/files/d0971a9906ae64111c3699619ac86620040223a8" alt="" width="563"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

#### <mark style="color:blue;">**`快速敲擊3次空格翻譯`**</mark>：

喺對話界面輸入框輸入消息後，連敲三次空格可將輸入內容翻譯成英文。

{% hint style="warning" %}
注意：呢個操作會覆蓋原文。
{% endhint %}

#### <mark style="color:blue;">**`目標語言`**</mark>：

設定輸入框翻譯按鈕同快速敲擊3次空格翻譯嘅目標語言。

## 助手設定

喺助手界面選擇需要設定嘅<mark style="background-color:yellow;">助手名稱</mark>→喺<mark style="background-color:yellow;">右鍵選單中</mark>揀對應設定

### 編輯助手

{% hint style="info" %}
助手設定作用於呢個助手下嘅所有話題。
{% endhint %}

<figure><img src="/files/68e766a6dedcf31cbd4d1d0338619f89a205479e" alt=""><figcaption></figcaption></figure>

#### 提示詞設定

#### <mark style="color:blue;">**`名稱`**</mark>：

可自定義方便辨識嘅助手名稱。

#### <mark style="color:blue;">**`提示詞`**</mark>：

即係 prompt ，可以參照智能體頁面嘅提示詞寫法嚟編輯內容。

#### 模型設定

#### <mark style="color:blue;">**`預設模型`**</mark>：

可以為呢個助手固定一個預設模型，喺智能體頁面添加時或者複製助手時初始模型會係呢個模型。如果唔設定呢項，初始模型就會係全局初始模型（即 [預設助手模型](/docs/zhong-wen-fan-ti/pre-basic/settings/default-models.md#mo-ren-zhu-shou-mo-xing) )。

{% hint style="info" %}
助手嘅預設模型有兩種，一係 [全局預設對話模型](/docs/zhong-wen-fan-ti/pre-basic/settings/default-models.md#mo-ren-zhu-shou-mo-xing) ，另一係助手預設模型；助手預設模型嘅優先級高於全局預設對話模型。當唔設定助手預設模型時，助手預設模型=全局預設對話模型。
{% endhint %}

#### <mark style="color:blue;">**`自動重置模型`**</mark>：

打開時 - 當喺呢個話題下使用過程中切換其他模型使用時，再次新建話題會將新話題重置為助手嘅預設模型。當呢項關閉時，新建話題嘅模型會跟隨上一話題所使用嘅模型。

> 例如助手嘅預設模型係 gpt-3.5-turbo，我喺呢個助手下建立話題1，喺話題1嘅對話過程中切換咗 gpt-4o 使用，咁此時：
>
> 如果開啟咗自動重置：新建話題2時，話題2預設選擇嘅模型係 gpt-3.5-turbo；
>
> 如果未開啟自動重置：新建話題2時，話題2預設選擇嘅模型係 gpt-4o。

#### <mark style="color:blue;">**`溫度 (Temperature)`**</mark> ：

溫度參數控制模型生成文本嘅隨機性同創造性程度（預設值為 0.7）。具體表現為：

* 低溫度值 (0-0.3)：
  * 輸出更確定、更專注
  * 適合代碼生成、數據分析等需要準確性嘅場景
  * 傾向於選擇最可能嘅詞彙輸出
* 中等溫度值 (0.4-0.7)：
  * 平衡咗創造性同連貫性
  * 適合日常對話、一般性寫作
  * 推薦用於聊天機械人對話 (0.5 左右)
* 高溫度值 (0.8-1.0)：
  * 產生更具創造性同多樣性嘅輸出
  * 適合創意寫作、頭腦風暴等場景
  * 但可能降低文本嘅連貫性

#### <mark style="color:blue;">**`Top P（核採樣）`**</mark>：

預設值為 1，值越細，AI 生成嘅內容越單調，亦越容易理解；值越大，AI 回覆嘅詞彙範圍越大，越多樣化。

核採樣透過控制詞彙選擇嘅概率閾值嚟影響輸出：

* 較小值 (0.1-0.3)：
  * 只考慮最高概率嘅詞彙
  * 輸出更保守、更可控
  * 適合代碼註釋、技術文檔等場景
* 中等值 (0.4-0.6)：
  * 平衡詞彙多樣性同準確性
  * 適合一般對話同寫作任務
* 較大值 (0.7-1.0)：
  * 考慮更廣泛嘅詞彙選擇
  * 產生更豐富多樣嘅內容
  * 適合創意寫作等需要多樣化表達嘅場景

{% hint style="info" %}

* 呢兩個參數可以獨立使用或者組合使用
* 根據具體任務類型選擇合適嘅參數值
* 建議透過實驗搵出最適合特定應用場景嘅參數組合
* 以上內容僅供參考同了解概念，所給參數範圍未必適合所有模型，具體可參考模型相關文檔給出嘅參數建議。
  {% endhint %}

#### <mark style="color:blue;">**`上下文數量 (Context Window)`**</mark>

要保留喺上下文入面嘅消息數量，數值越大，上下文越長，消耗嘅 token 越多：

* 5-10：適合普通對話
* \>10：需要更長記憶嘅複雜任務（例如：按照寫作提綱分步生成長文嘅任務，需要確保生成嘅上下文邏輯連貫）
* > 注意：消息數越多，token 消耗越大

#### <mark style="color:blue;">**`開啟消息長度限制 (MaxToken)`**</mark>

單次回答最大 [Token](https://docs.cherry-ai.com/question-contact/knowledge#shen-me-shi-tokens) 數喺大語言模型中，max token（最大令牌數）係一個關鍵參數，佢直接影響模型生成回答嘅質量同長度。

> 例如：喺 CherryStudio 入面填好 key 後測試模型是否連通時，只需要知道模型是否有正確返回消息而唔需要特定內容，呢種情況下設定 MaxToken 為 1 就得。

多數模型嘅 MaxToken 上限為 32k Tokens，當然亦有 64k，甚至更多，具體需要去對應介紹頁面睇。

具體設定幾多取決於自己需要，當然亦可以參考以下建議。

{% hint style="success" %}
建議：

* 普通聊天：500-800
* 短文生成：800-2000
* 代碼生成：2000-3600
* 長文生成：4000 及以上（需要模型本身支援）
  {% endhint %}

{% hint style="warning" %}
一般情況下模型生成嘅回覆會被限制喺 MaxToken 範圍內，當然亦有可能會出現被截斷（例如寫長代碼時）或者表達唔完整等情況，特殊情況下亦需要根據實際情況靈活調整。
{% endhint %}

#### <mark style="color:blue;">**`流式輸出（Stream）`**</mark>

流式輸出係一種數據處理方式，佢允許數據以連續嘅流形式進行傳輸同處理，而唔係一次過發送所有數據。呢種方式令數據可以喺生成後即刻被處理同輸出，大大提高咗即時性同效率。

喺 CherryStudio 客戶端等類似環境下簡單嚟講就係打字機效果。

關閉後（非流）：模型生成完信息後成段一次性輸出（想像一下微信收到消息嘅感覺）；

打開時：逐字輸出，可以理解為大模型每生成一個字就即刻發送俾你，直到全部發送完。

{% hint style="info" %}
如果某啲特殊模型唔支援流式輸出，需要將呢個開關關閉，例如**剛開始**只支援非流嘅 o1-mini 等。
{% endhint %}

#### <mark style="color:blue;">**`自定義參數`**</mark>

喺請求體（body）中加入額外請求參數，例如 `presence_penalty` 等欄位，一般人一般情況下用唔著。

> 上面嘅 top-p、maxtokens、stream 等參數就係呢啲參數之一。

填法：參數名稱—參數類型（文字、數字等）—值，參考文件：[撳前往](https://openai.apifox.cn/doc-3222739)

{% hint style="info" %}
各個模型提供商都或多或少有自己獨有嘅參數，需要去提供商嘅文檔中搵使用方法
{% endhint %}

{% hint style="info" %}

* 自定義參數優先級高於內置參數。即係自定義參數如果同內置參數重複，咁自定義參數會覆蓋內置參數。

> 例如：自定義參數中設定 `model` 為 `gpt-4o` 之後，喺對話中無論揀邊個模型都使用嘅係 `gpt-4o` 模型。

* 使用 <kbd>參數名稱:undefined</kbd> 嘅設定可排除參數。
  {% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cherry-ai.com/docs/zhong-wen-fan-ti/cherry-studio/preview/chat.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.