logo
開發者文件
搜尋
身分提示

身分提示

身分提示(Persona)定義這個智慧體是誰、服務什麼、用什麼口徑和語言回答。它是 LoopAgent 裡唯一可自由編輯的提示詞欄位,有專門的全螢幕編輯器,支援草稿、版本、@ 引用和變數。

開啟編輯器

設定頁 → 系統提示詞面板 → 身分提示,雙擊預覽區或點編輯進入全螢幕編輯器。編輯器裡:

  • 輸入 @ 喚出資源引用選單;
  • 輸入 / 喚出變數選單;
  • 右上角歷史圖示打開版本面板。

草稿、儲存、版本

三個概念要分清:

  • 草稿:編輯時自動儲存到伺服端,只有你自己看得到,對任何對話(含偵錯聊天)都不可見。關閉編輯器會保留草稿。
  • 儲存:點儲存後,內容寫入偵錯版並追加一條版本快照,偵錯聊天立即讀到。
  • 版本:用於歷史查看、Diff 比對和恢復,最多保留 100 條。

恢復歷史版本不是一鍵回滾:恢復只是把某個舊版本的內容灌回編輯器成草稿,必須再點儲存才真正生效。只恢復不儲存、關掉頁面,等於沒改。

為什麼客戶看不到我的改動

身分提示同樣遵守儲存與發布規則:

  • 在編輯器裡儲存只更新偵錯版,偵錯聊天能立刻驗證;
  • 線上渠道用的是發布版。改完身分提示後,必須發布這個 LoopAgent,客戶才會生效。

身分提示的草稿、儲存(偵錯版)、發布(線上版)關係

@ 引用與 / 變數

身分提示可以直接引用這個智慧體上已啟用的資源,用可點擊的「膠囊」表示,而不用硬寫 ID:

  • @ 可引用:技能、工作流程、工具(含轉接真人客服、採集表單、關鍵事件等內建工具)、MCP、知識庫、資料表、程式碼等,只會列出當前智慧體已啟用的資源
  • / 可插入:系統變數、使用者屬性、自訂變數。

膠囊變紅說明該資源對當前智慧體已不可用(被解綁 / 刪除 / 關閉,或來自複製、匯入時帶來的其它智慧體的殘留)。點掉紅色膠囊上的刪除圖示即可,或去對應模組重新啟用該資源。

使用要點

  • 主智慧體與子智慧體共享同一份身分提示,一次編輯同時影響兩者。
  • 允許留空:引擎沒有預置人設,留空表示不額外注入身分段,智慧體照常執行。空白不是配置錯誤。
  • 編輯器頭部會即時顯示整段的 Token 數,可用於評估上下文佔用。
  • 謹慎引用每輪都在變的變數(如線上時長、訊息條數):會讓身分提示每輪都變化,拖慢回應、增加成本。