使用手冊
HiZex Herald 使用手冊
這份手冊給三種人：在主控台撰寫與審核訊息的承辦人與主管、設計劇本與 pattern 的企劃人員、以及要把系統接上 Herald 的工程師。每一頁的步驟都對應主控台實際的畫面與欄位。
主控台長什麼樣
Herald
儀表板訊息審核劇本與 Pattern知識庫受眾與群組報表單位設定AI 設定記憶稽核紀錄
儀表板單位 ▾
本月 LINE 配額（本單位）1,640 / 4,000預留 380 · 月底預測 86%
本月送出3,912LINE 1,640 · Email 1,180 · Web push 92
封鎖率1.8%警戒線 5%
待審核3
即將送出
| 時間 | 訊息 | 預估則數 |
|---|---|---|
| 今天 17:30 | 迎新演唱會 開放報名 | 1,190 |
| 明天 08:30 | 本週活動彙整（週期） | 412 |
整合狀態
| 共用 AI core | 已連線 |
| HiZex Avatar | 已設定 |
| LINE adapter | 正常 |
左側是主選單，頂端顯示目前所在的單位（可切換）。「單位」區的功能屬於承辦人日常；「管理」區的功能需要單位 admin 或系統管理員。
| 選單 | 路徑 | 做什麼 | 需要的角色 |
|---|---|---|---|
| 儀表板 | / | 配額、本月送出、封鎖率、待審核、即將送出、整合狀態 | viewer 以上 |
| 訊息 | /messages | 訊息列表（依狀態篩選）、新增訊息三步驟、單筆詳情與 dry-run | composer |
| 審核 | /approvals | 待我審核的佇列 | approver |
| 劇本與 Pattern | /scenarios | 劇本列表、視覺化編輯器、pattern 精靈 | composer |
| 知識庫 | /knowledge | 知識集、來源、版本、發布／回滾、試搜尋 | composer（發布需 approver） |
| 受眾與群組 | /unit#groups | 群組與子群組、成員 | composer |
| 報表 | /patterns | pattern instance 的報表 | viewer 以上 |
| 單位設定 | /unit | 成員與角色、群組、配額與審核規則 | 單位 admin |
| AI 設定 | /ai | LLM provider、測試連線、用量 | 單位 admin |
| 記憶 | /memory | 查看、撤銷、遺忘某人的記憶 | 單位 admin |
| 稽核紀錄 | /audit | append-only 稽核查詢 | approver 以上 |
章節
訊息
對話
劇本編輯器
節點種類、連線規則、測試對話、發佈。
Pattern 精靈
活動報名、問卷、回條三種精靈。
知識庫
知識集、來源、版本、發布、回滾、試搜尋。
記憶
查看某人的記憶事實、撤銷、全部遺忘。
AI 設定
LLM provider、金鑰、測試連線、用量。
營運
整合
幾個名詞
- 單位 unit
- 誰在說話。決定可用分類、受眾維度、配額、審核規則。
- 分類 category
- 每則訊息屬於一個分類；分類帶同意範圍、管道計畫、彙整方式、審核規則、是否固定層。
- 受眾 audience
- 查詢條件，不是名單；送出時才解析。
- dry-run
- 只回數字：人數、各管道、排除原因、配額估算、違規。從不列名單。
- 劇本 scenario
- 對話的圖：節點（原語）+ 邊；由 trigger 進入。
- pattern
- 由精靈產生的劇本 + 回應 schema + 報表，例如活動報名、問卷、回條。