事項管理指南

GIIP 內部 Agent Worker（GIIP CSN 47 等）處理事項的建立、檢視、狀態管理操作員指南。

🔧 前往事項管理 →

📋 概述

事項管理功能表是用於注册 GIIP 平台內部 Agent Worker 處理的作業並追蹤其進度的操作工具。按 CSN（客戶/服務號）分離管理事項，每項事項經歷狀態轉換：PENDING → READY → IN_PROGRESS → REVIEW → DONE。

🎯 各頁面角色

頁面	路徑	主要操作
列表	/admin/giip-issues	檢視事項列表、篩選（Active/Done）、切換項目
詳情	/admin/giip-issues/[isn]	檢視事項內容、更新狀態、添加評論、Dispatch
建立	/admin/giip-issues/new	注册新事項（標題、內容、狀態、目標伺服器）
編輯	/admin/giip-issues/[isn]/edit	編輯現有事 stored 的標題、內容、狀態

🛠️ 主要工作流程

1. 註冊新事項

1. 選擇項目 (CSN) — 先從頂部導航選擇 CSN。
2. 點擊新建事項按鈕。
3. 輸入標題、內容、初始狀態（PENDING/READY），必要時選擇目標伺服器（lssn）。
4. 如果需要 Agent Readiness，確認檢查清單後提交。

2. 管理事項狀態

• READY: 等待 Agent 處理。MinAgeMinutes ≥ 60 後可轉換為 IN_PROGRESS。
• IN_PROGRESS: Agent 正在處理中。
• REVIEW: Agent 已完成處理，等待驗證。
• DONE: 處理完成。

3. 添加評論

在詳情頁下方可以記錄事項進展、判斷依據、工作結果為評論。

🔗 相關指南

關於事項管理的 API 集成和最終用戶用法，請參閱：

📘 事項管理 API 參考 → 👤 事項管理最終用戶指南 →

💡 注意事項

• 如果未先選擇 CSN，事 stored 列表將不會顯示。
• 寫頁面（new/edit）需要最低級別 70（管理員）權限。
• 狀態轉換必須遵循正確順序（PENDING → READY → IN_PROGRESS → REVIEW → DONE）。

故障排除

症狀	原因	解決方案
事項列表為空	未選擇 CSN	先從頂部導航選擇項目。
狀態轉換失敗	無效的狀態轉換	確認順序：PENDING→READY、READY→IN_PROGRESS、IN_PROGRESS→REVIEW、REVIEW→DONE。
Agent Readiness 檢查失敗	目標伺服器上沒有符合條件的 Agent	確認目標伺服器（lssn），或臨時停用 PENDING/READY 狀態下的 Agent Readiness 要求。

---

角色: product 功能（登入後內部操作員 — 不對外公開） 版本: 1.0 最後更新: 2026-08-17 源文件: giipv3/public/help/giip-issue.zh-TW.md