建立一條故事線

故事線是做什麼用的

一個平常的智能體把一件事做好。一條故事線讓一個智能體與每個人執行一整套多步驟流程——教一門課、輔導一個計畫、把一份申請帶到一個決定——並記住每個個體在哪裡，跨工作階段、跨管道。如果你對這個概念還很陌生，先從故事線概念頁開始；本頁是實作指南。

故事線是一項 Pro 能力。一旦它為你的租戶開啟，你就會在 console 裡找到故事線編輯器。你也可以透過 API（/v1/storylines）建立故事線，這正是設定精靈或助理能為你生成一條故事線的方式。

一條故事線的形狀

一條故事線是一張圖。你畫出節點，並用出口把它們連起來。

每個節點是一個步驟。針對那一步你設定：

• 一個任務（task）——智能體在這裡應該做什麼（你可以放入 {dimension} 或 {blackboard.key}，它會被填入那個人當前的數值）；
• 它的知識、技能與工具——疊加在智能體的基礎組合之上，或者透過進階開關，只在這一步替換它們；
• 一句選填的開場白，智能體在進入這一步時說（留白則無聲切換）；
• 它是否為**入口（entry）步驟，以及它是否為終端（terminal，結束）**步驟。

智能體的身分與安全邊界在節點之間永不改變——只有任務、知識與工具會變。

一個步驟如何前進：出口條件

每一個從節點出去的出口都帶著一個條件。共有五種，選對很重要：

• 規則（Rule）——維度或已保存數值上的一個門檻，透過挑一個欄位、一個運算子和一個數字來建立（listening ≥ 70 and attempts ≥ 3）。有決定性、免費、不呼叫模型。把它用在必須可靠的決定上。
• 使用者選擇（User choice）——那個人點按的一個按鈕。適合「準備好繼續了嗎？」或依明確偏好分支。
• AI——一句描述模糊準則的話（「當學生能不經提示造出過去式句子時」），由模型判斷。你也寫下何時檢查它，這樣它就不會每一輪都被判斷。把它用在需要判斷的情況，而非用在你需要精確的關卡上。
• 回呼（Callback）——等待來自外部系統的一個訊號（見下文）。
• 前往故事線（Go to storyline）——跳到另一條故事線（依結果分支，或串接年級）。

當不止一個出口可能觸發時，它們由上而下求值——所以把有決定性的放在前面。

維度：隨人一同旅行的檔案

在故事線的設定底下，你為你的主題定義維度（dimensions）——以一門語言課程為例，listening、speaking、reading、writing，各為 0–100。這些會在人身上跨故事線累積（所以從一個年級帶到下一個年級），而每一個都可標記為對使用者可見，或只留給你自己看。維度以三種方式被寫入：AI 可以定期為它們評分、一條規則可以設定它們，或一個第三方回呼可以回報它們。

在維度旁邊，每一次註冊都有一塊黑板（blackboard）——一塊自由格式的交接筆記便條，從一個節點傳給下一個。當那個人移到一條新的故事線時它會重置。

引入第三方（回呼）

一個節點可以把一個人交接給一個外部系統，並依它回報回來的內容行動——一份評分後的測驗、一次 KYC 檢查、一個嵌入的小遊戲。有兩種形狀：

• 後端（Backend）——資料流出到一個工具，一個結果隱形地流回。
• 跳轉並等待（Redirect-and-wait）——對話顯示一個連結、鎖住，並在外部步驟完成時續接（就像付款視窗運作的方式）。若那個人取消或它逾時，那是一個你可以據以分支的、不同的結果。

console 為每個回呼給出一個 URL 和一個訊號名，交給第三方。結果以一個綁定那個人與那個步驟的短效 token 驗證，只套用一次（重複會被忽略），而它們回報的任何維度都會對照你的結構描述檢查——一個外部系統無法寫入一個你沒定義的欄位。把回呼寫入的任何東西當作資料，而非指令。

發佈、版本，以及變更一條上線中的故事線

一條故事線在你發佈（publish）之前一直是草稿（draft）。發佈時會先驗證圖——沒有缺漏的入口、沒有死路、沒有不可達之處、沒有懸空或未知的目標——若有任何錯誤便會擋下。發佈會凍結一個不可變的版本；任何已經進行到一半的人會被固定在他們開始時所用的版本上，因此一次變更絕不會打斷某個進行到一半的人。

當你刪除或變更目前有人正處於其上的節點時，你選擇他們會怎樣：把他們移到另一個節點（安全）、把他們送回起點，或清除他們的進度。後兩者會失去一個使用者的進度，因此 console 會要求你確認，並顯示有多少人受影響。

在它上線前試用

編輯器有兩種測試方式。**邏輯走查（logic walk-through）**在不呼叫模型的情況下追蹤圖（免費、即時），用來檢查可達性與條件。**實跑（live run）**則實際把訊息餵過模型（它會用掉你的額度，編輯器會這麼說），來感受真實的樣子。