LightVela

如何通過 SOUL.md 設定 IM Agent 的角色、性格與説話方式？

一個 IM Agent 是否像“同一個人”，不只取決於它接入了 Telegram 還是 WhatsApp。 穩定的角色、語氣、行為邊界和長期上下文共同決定了它在不同消息場景中的表現。

在 Hermes Agent 的運行環境中，SOUL.md 是承載 Agent 人設的核心文件。 LightVela 通過「人設」能力生成並注入 Soul，用户不需要直接操作雲端文件系統，也可以完成這套配置。

通過 SOUL.md 設定 IM Agent 的角色、性格與説話方式

摘要

IM Agent 是否像「同一個人」，取決於人設而不是它接入了哪個通道：SOUL.md 承載角色、語氣、優先級、行為方式與邊界，是 Hermes 運行環境中的人設核心文件。 在 LightVela 上你不需要直接操作雲端文件系統——管理台 Agent 設置頁的「人設」區域提供「隨機抽取人設」與「答題測試人設」兩種入口，查看人設卡的角色、語氣與行為説明後點擊「注入人設」即可生效。寫人設時要寫可判斷的原則而不是具體事實：「先給結論」「不確定時明確説明」「發送外部消息前先確認」屬於人設規則，而項目名、端口這類事實屬於長期記憶。注入後必須用一輪真實對話驗證語氣與邊界是否符合預期。

適合誰

這篇指南適合希望把 IM Agent 配置成固定角色的用户，例如個人助理、研究夥伴、學習陪練或日常客户溝通助手。 如果你還沒有選擇消息通道，可以先從如何將 AI Agent 接入即時通信平台開始。

先理解三類上下文

SOUL.md：Agent 是誰，以及它如何做事

SOUL.md 適合保存穩定的人設規則，包括角色、語氣、優先級、行為方式和邊界。 例如“先給結論”“不確定時明確説明”“發送外部消息前先確認”都屬於人設或行為規則。

用户畫像：你是誰，以及你希望怎樣被對待

用户畫像適合保存語言、時區、身份背景和溝通偏好。 例如“我在新加坡”“默認使用中文”“我希望先看到截止時間”通常不應該寫成 Agent 的角色定義。

長期記憶：你們已經確認過什麼

長期記憶適合保存項目狀態、已經做出的決定和可複用的共同背景。 它會隨着持續對話逐步積累，也可以在記憶管理中查看和調整容量。

把三者混在一起，會讓 Agent 的身份、用户偏好和臨時項目背景互相污染。 把它們分開，才能讓人格保持穩定，同時讓對話繼續適應真實的用户和工作。

前置條件

  • 一個已經運行中的 LightVela Hermes Agent。 如果你還沒有創建 Agent，可以先查看快速開始。

  • 一個已配置的模型和至少一個可用的對話通道。

  • 一份簡短的人設説明。 先明確它服務誰、主要任務是什麼、默認用什麼語氣，以及哪些事情必須先徵得確認。

操作步驟 / 核心説明

1. 用五個問題寫出人設目標

在選擇 Soul 之前，先回答下面五個問題：

  • 它是誰？

  • 它主要幫助誰？

  • 它默認如何表達？

  • 它遇到不確定信息時怎麼處理？

  • 哪些外部操作必須先獲得確認？

可以把答案整理成下面這樣的規劃模板：

Role: 一名面向個人項目的研究助理
Audience: 希望快速得到可靠結論的用户
Voice: 簡潔、專業、友好，先給結論再給依據
Behavior: 主動拆解問題，標出不確定內容，必要時只問一個關鍵問題
Boundaries: 不擅自發送外部消息、修改文件或執行高風險操作

這段模板是幫助你選擇和校準人設的工作説明，不代表 LightVela 提供一個讓用户直接編輯任意雲端文件的通用文件編輯器。

2. 在 Agent 設置中打開「人設」

進入 LightVela 管理台，打開目標 Hermes Agent 的設置頁面，再選擇「人設」。 國際站的「人設」區域支持「隨機抽取人設」和「答題測試人設」兩種入口。

隨機抽取適合先探索不同的角色風格。 答題測試適合根據你對溝通方式和行為特點的偏好，尋找更接近的 Soul。

查看人設卡的角色、語氣和行為説明，再選擇符合規劃模板的卡片。

3. 將選中的 Soul 注入 SOUL.md

選中人設後點擊「注入人設」。 LightVela 會把選中的 Soul 寫入當前 Hermes Agent 的 SOUL.md，並在覆蓋已有文件前保留備份。

同一時間只有一個人設處於當前生效狀態。 如果需要切換角色，請先確認新卡片的行為邊界，再執行重新注入。

人設注入成功後，回到你使用的 IM 通道，發送：

/new

Hermes Agent 會在新會話開始時讀取新的 SOUL.md。 這一步很重要，因為已經開始的會話可能仍然持有舊的人設快照。

4. 用對話補充用户偏好和長期事實

不要把所有信息都塞進 SOUL.md。 穩定的人設應保持簡潔，用户偏好和項目事實交給用户畫像與長期記憶處理。

例如，你可以直接告訴 Hermes：

請記住：我在新加坡時區，工作日早上 8:00 需要一份簡短計劃，先列截止時間。

或者：

請忘記我之前要求的週五晚間提醒，之後不要再按這個偏好安排任務。

Hermes 會在對話中處理記住和忘記的請求。 你可以在記憶管理頁面查看 Memory 和 User Profile 的內容與容量。

5. 只為真實工作安裝技能

人設決定 Agent 怎樣工作，但不會自動增加外部能力。 如果你希望它瀏覽網頁、整理資料、查詢信息或執行其他具體任務，請根據實際需要安裝技能，並先確認技能來源和權限。

可以從配置技能開始。 技能和人設應該互相配合，而不是用一個高風險技能來彌補不清晰的人設邊界。

驗證人設是否生效

開啓新會話後，不要只測試一句自我介紹。 至少測試下面四類問題：

你現在的角色、主要任務和默認語氣是什麼？
當你不確定一個事實時，你會怎樣回覆？
如果我讓你向外部服務發送一條消息，你會先做什麼？
請把這段材料整理成結論、依據和待確認問題。

檢查它是否保持了角色、語氣和安全邊界，也檢查它是否能夠繼續使用用户畫像和長期記憶中的相關背景。 如果表現不穩定，先縮短人設規則，再重新選擇或注入 Soul，不要一次加入大量互相沖突的指令。

常見問題

我需要手動編輯雲端的 SOUL.md 嗎？

通常不需要。 LightVela 的「人設」入口會生成並注入 Soul，普通使用不需要直接操作雲端文件系統。

修改 SOUL.md 會改變所有消息通道嗎？

會影響同一個 Hermes Agent 的 Agent 級行為。 如果該 Agent 同時連接了 Telegram 和 WhatsApp，兩個通道都會在新會話中使用這套人設，但每個通道仍然有自己的授權、消息格式和能力限制。

SOUL.md 可以替代記憶嗎？

不能。 SOUL.md 應該描述穩定的身份和行為規則，記憶應該保存會變化的事實、項目背景和共同經歷。

我可以讓同一個 Agent 同時擁有多個當前人格嗎？

當前一個 Agent 同一時間只有一個當前生效的人設。 如果需要完全不同的角色，建議創建不同的 Agent，而不是在同一個 Agent 中頻繁覆蓋 Soul。

什麼時候需要發送 /new？

每次注入新的人設後，都建議在 IM 通道中發送 /new 開啓新會話。 這樣可以明確讓新的人設在會話初始化時加載。

下一步

如何在 WhatsApp 中配置一個具有獨立人格的 Hermes Agent？

如何通過 Skill 把 IM Agent 變成客服、社群助手或 AI 伴侶？

本頁目錄

摘要適合誰先理解三類上下文SOUL.md：Agent 是誰，以及它如何做事用户畫像：你是誰，以及你希望怎樣被對待長期記憶：你們已經確認過什麼前置條件操作步驟 / 核心説明1. 用五個問題寫出人設目標2. 在 Agent 設置中打開「人設」3. 將選中的 Soul 注入 SOUL.md4. 用對話補充用户偏好和長期事實5. 只為真實工作安裝技能驗證人設是否生效常見問題我需要手動編輯雲端的 SOUL.md 嗎？修改 SOUL.md 會改變所有消息通道嗎？SOUL.md 可以替代記憶嗎？我可以讓同一個 Agent 同時擁有多個當前人格嗎？什麼時候需要發送 /new？下一步