人設
選擇並注入 Soul，定義 Hermes Agent 的角色、語氣、優先級與行為邊界。
摘要
Soul 決定一個 Hermes Agent 穩定的角色、語氣、優先級和行為邊界。
你可以在 Agent 的「人設」設置中選擇推薦 Soul，或上傳自己的 Markdown 人設文件，再將內容注入到該 Agent 的 SOUL.md。
同一個 Agent 同一時間只會有一個生效中的 Soul，修改後需要開啓新會話，讓新的規則被加載。
本頁覆蓋
- Soul 可以控制什麼
- 如何選擇並注入推薦 Soul
- 如何上傳自己的 Soul
- 如何確認新的人設已經生效
- 如何區分人設、用户畫像、記憶和技能
Soul 可以控制什麼
Soul 是 LightVela 寫入 Agent SOUL.md 的人設配置。
它定義 Agent 是誰、通常如何表達、優先處理什麼，以及應當遵守哪些行為邊界。
適合寫入 Soul 的是穩定規則，例如“先給結論”“不確定時明確説明”或“發送外部消息前先確認”。 不要把會變化的項目事實、一次性的臨時需求，或任意雲端文件編輯需求放進 Soul。
人設屬於 Agent，而不是某一個消息通道。 同一個 Agent 同時連接 Telegram 和 WhatsApp 時，兩個通道中的新會話都會使用同一個當前 Soul。
開始前準備
- 打開你想配置人設的 Hermes Agent。
- 確認該 Agent 已配置模型，並至少有一個可用於驗證結果的對話通道。
- 先想清楚 Agent 的角色、服務對象、語氣、優先級，以及哪些動作必須先確認。
一份簡短的説明通常已經足夠。 例如：“一名簡潔的研究助理，先給結論再給依據，明確不確定性，發送任何外部內容前先詢問。”
配置 Soul
打開人設
- 在 LightVela 控制台中打開 Agents。
- 選擇想要配置的 Hermes Agent。
- 打開該 Agent 設置中的 人設。
該設置只會影響當前選中的 Agent。 如果其他 Agent 需要不同的角色或語氣，請先切換到對應 Agent 再進行配置。
選擇 Soul
使用 隨機抽取人設 瀏覽可用的人設風格。 如果想根據你的溝通和行為偏好獲得建議，可以使用 答題測試人設。
在選擇前，先查看每張 Soul 卡片中的角色、語氣、行為説明和邊界。 優先選擇符合準備説明的人設，而不是隻按名稱或語氣挑選。
注入 Soul
- 選擇要使用的 Soul。
- 選擇 注入。
- 在人設區域確認注入結果。
- 回到已連接的對話通道併發送
/new。
注入成功後，LightVela 會把選中的 Soul 寫入當前 Agent 的 SOUL.md，並在替換已有內容前保留備份。
已經開始的會話可能仍保留舊的人設快照，所以 /new 會開啓一個讀取新 Soul 的會話。
上傳自己的 Soul
如果你已經準備好 Markdown 人設文件，而不是想從推薦卡片中選擇，可以使用上傳功能。
- 在 LightVela 控制台中選擇目標 Hermes Agent。
- 在 人設 中選擇 上傳人設文件。
- 選擇包含 Soul 內容的 Markdown 文件。
- 查看或編輯文件內容，然後選擇 注入。
- 如果 Agent 已經有人設，確認要覆蓋當前內容。
- 回到已連接的對話通道併發送
/new。
文件名不必是 soul.md，但必須使用 .md 擴展名、採用 UTF-8 編碼，並且不超過 20 KB。
LightVela 會在注入前展示文件內容，方便你作最後檢查或編輯。
覆蓋已有 Soul 時，LightVela 會先備份舊文件，再把上傳的內容寫入當前 Agent 的 SOUL.md。
只有選中 Agent 後才能上傳。
如果沒有選中 Agent，或 Agent 沙箱無法寫入而下載了推薦 Soul 的 soul.md 文件，該文件只是本地兜底副本。
下載文件本身不會更新任何 Agent。
將不同類型的上下文放在正確的位置
| 保存位置 | 適合保存什麼 | 示例 |
|---|---|---|
人設和 SOUL.md | 穩定的角色、語氣、優先級和行為邊界 | “明確説明不確定性，發送外部消息前先確認。” |
| 用户畫像 | 用户的身份、地點、語言和溝通偏好 | “默認使用中文，優先展示截止日期。” |
| 記憶 | 會變化的事實、決策和長期項目背景 | “當前項目將在週五發佈。” |
| 技能 | 可複用的能力和操作流程 | 網頁研究、文件整理或日報工作流 |
使用記憶管理查看記憶和用户畫像容量。 當 Agent 需要新能力而不是新行為規則時，請使用配置技能。 想進一步理解這些邊界，可以查看Hermes Agent 的性格從哪裏來。
驗證 Soul 是否生效
發送 /new 後，用能體現配置行為的問題測試 Agent。
你當前的角色、主要任務和默認語氣是什麼？當你不確定一個事實時，你會怎樣回覆？如果我讓你向外部服務發送一條消息，你會先做什麼？當 Agent 在新會話中持續遵守設定的角色、語氣和邊界時，新的 Soul 已經生效。 如果需要按消息通道查看完整示例，可以參考如何通過 SOUL.md 設定 IM Agent 的角色、性格與説話方式？。
常見問題排查
| 問題 | 可能原因 | 處理方式 |
|---|---|---|
| 回覆仍使用舊語氣 | 該會話在 Soul 修改前已經開始 | 發送 /new，然後在新會話中再次測試。 |
| 選擇的 Soul 不符合 Agent 的真實工作 | 只按風格選擇，沒有看角色和邊界 | 回到人設區域，查看卡片詳情並注入更符合説明的 Soul。 |
| Agent 忘記了某個項目事實 | 將變化的事實寫入人設，而不是記憶 | 將穩定規則保留在 SOUL.md，通過對話讓 Hermes 記住變化的事實。 |
| Agent 無法完成需要的任務 | 人設定義行為，不會新增能力 | 先檢查來源和權限，再安裝或配置合適的技能。 |
控制台下載了 soul.md，沒有完成注入 | 沒有選中 Agent，或 Agent 沙箱無法寫入 | 選擇正在運行的目標 Agent 後重試。下載的文件不會改變 Agent。只有控制台確認注入成功後再發送 /new。 |
| 無法上傳自己的 Soul | 沒有選中 Agent，或文件不是符合要求的 UTF-8 Markdown 文件 | 選擇目標 Agent，然後上傳不超過 20 KB 的 .md 文件。 |
常見問題
一個 Agent 可以同時有多個生效中的 Soul 嗎？
不可以。 一個 Agent 同一時間只能有一個當前 Soul。 如果確實需要完全不同的角色，建議創建不同 Agent，而不是反覆替換同一個 Agent 的人設。
我可以手動編輯雲端的 SOUL.md 嗎？
正常使用不需要直接操作雲端文件系統。 人設設置可以生成、上傳和注入 Soul，但它不是任意雲端文件的通用編輯器。
我可以上傳已有的 SOUL.md 嗎？
可以。 使用 上傳人設文件 選擇不超過 20 KB 的 UTF-8 Markdown 文件，查看或編輯後注入到已選中的 Agent。 如果 Agent 已經有人設，LightVela 會先請求確認並保留備份，再替換當前內容。
修改 Soul 會安裝新能力嗎？
不會。 Soul 會改變 Agent 的行為方式，技能才會增加具體能力和可複用操作流程。
新 Soul 會清除記憶或聊天記錄嗎？
不會。 注入 Soul 只會替換 Agent 當前的人設配置，不會刪除長期記憶或已有聊天記錄。