AI 助理

AI 助理用於以自然語言完成常見維運操作，例如查詢玩家、修改血量、執行備份與檢視日誌。所有工具呼叫均受權限與開關控制，並寫入稽核記錄。

設定模型

在「AI 設定」中填寫模型服務位址、API Key 與模型名稱。支援相容 OpenAI Chat Completions 協定的服務。

儲存後可在對話頁面直接提問。模型無法使用時，面板會顯示具體的連線錯誤，不會靜默失敗。

工具開關

AI 的能力由工具定義決定。每個工具包含：

• 工具 ID 與用途說明。
• 所需權限。
• 預設開關狀態。
• 目前是否可用，以及不可用的原因。

預設開啟的工具涵蓋日常查詢與玩家操作，包括玩家清單、玩家操作、文件檢索與工具清單。涉及指令執行、檔案寫入與通用 API 呼叫的工具預設關閉，需要使用者手動開啟。

工具關閉後，AI 仍然可以看到它的定義與用途，但呼叫會被拒絕，並收到明確原因。此時助理應當提示使用者前往「AI 設定 → 工具」開啟，而不是改用其他方式嘗試。

工具清單

在對話中可以直接要求助理列出目前工具，或使用「工具清單」工具檢視：

• 全部工具的 ID、描述與所需權限。
• 是否開啟、是否預設開啟。
• 不可用時給出原因。
• 目前帳號是否具備所需權限。

審批

高風險工具呼叫可設定為人工審批或自動審批：

• 人工審批：呼叫前在對話中顯示審批卡片，由使用者決定是否執行。
• 自動審批：由模型判斷呼叫是否符合使用者意圖，並給出放行或拒絕的理由。
• 拒絕理由：無論哪種方式，拒絕都會附帶明確原因，助理據此調整方案。

審批記錄可在稽核日誌中查詢。

權限模型

面板帳號分為三檔：

角色	說明
超級管理員	全部功能與面板設定
管理員	實例與玩家管理，受實例授權限制
一般使用者	唯讀或依授權的操作

實例級權限包括檔案、控制台、實例控制與資源管理。外掛介面另有單獨權限：玩家檢視、玩家管理、背包編輯、世界管理與控制台。

AI 工具呼叫使用對話發起者本人的權限，不會取得超出該帳號的能力。

安全說明

• 面板自身目錄與監聽連接埠對 AI 工具不可見、不可操作。
• 指令執行類工具在受限工作區內執行。
• 所有寫入操作均記錄操作者、參數與結果。
• 建議僅為可信帳號開啟高風險工具。

常見問題

助理說沒有某個能力

先查看工具清單確認該工具的開關與權限。若為預設關閉，請手動開啟；若缺少權限，請由管理員在帳號權限中授權。

呼叫一直等待

檢查模型服務位址與網路連線，以及 API Key 是否有效。長任務可能觸發逾時，可在設定中調整。

審批被自動拒絕

查看拒絕理由。若理由與預期不符，可改為人工審批，或調整提問方式後重試。