AI Builder

AI Builder 是客戶擴充套件 ObjectOS 的主要方式。開啟 Console，用自然語言與助手對話，它就會為你構建 後設資料——包、物件、欄位、動作、流程。每一次 變更都會先進入人機協作（HITL）審批列表，然後才會 正式生效。

30 秒快速體驗

You: I need to track customer support tickets.
     Each ticket has a subject, description, priority (low/medium/high/urgent),
     status (new/open/pending/resolved/closed), and assignee.

AI:  I'll create that for you. Here's the plan:
     • Create package `com.you.support` (v0.1.0)
     • Create object `support_ticket` with 5 fields
     • Add a kanban view grouped by status
     • Add 3 permission sets: agent, manager, viewer

     Approve? [Yes] [Modify] [Cancel]

You: [Yes]

AI:  ✓ Package created
     ✓ Object created with 5 fields and 12 indexes
     ✓ Kanban view registered
     ✓ Permission sets created
     Done. Try it: /support_ticket

現在你就擁有了一個可用的工單應用——REST 端點、Console 檢視、 審計日誌條目、許可權檢查點，一應俱全。沒有編輯任何 檔案，也沒有發生重啟。

AI 能做什麼

助手可以訪問一組內建的後設資料工具，它們都 帶有名稱空間，並依據 @objectstack/spec 進行校驗：

此外，每一個宣告的 *.action.ts 都會物化為動作工具—— 命名為 action_<name>——因此一旦某個動作存在於包中， AI 就可以像呼叫任何內建工具一樣呼叫它。

在執行時檢視完整的工具目錄：GET /api/v1/ai/tools。

人機協作審批

會變更後設資料的工具呼叫會路由進一個待處理動作 佇列。審批操作員在點選批准之前，會看到所提議 變更的差異（diff）。

所需許可權：

預設情況下，只有 Setup Administrator 的成員才擁有 ai:approve。 你可以在許可權集中進行更細粒度的拆分——例如 “產品負責人可以在 com.acme.crm 中批准，其他人都不行。”

該佇列可審計：每一次批准/拒絕都會記錄到 sys_audit_log，並附帶發起對話的 id。

對話與上下文

每一次聊天都是一條 ai_conversations 記錄。平臺會跟蹤：

• 活動包（Active package）——由 set_active_package 設定。新建的物件/ 欄位會落到這裡。
• 技能（Skills）——當前上下文中可用的工具子集 （例如在 support_ticket 詳情頁內，AI 可能啟用了 support_ticket 範圍的技能）。
• 知識（Knowledge）——附加到該對話的 RAG 主題 + 索引。

POST /api/v1/ai/assistant/chat
{
  "messages": [{ "role": "user", "content": "Add a tags field to support_ticket" }],
  "context":  { "objectName": "support_ticket", "recordId": "tkt_123" }
}

平臺會為當前活動應用解析出預設的 Agent， 根據上下文過濾技能集，然後讓 LLM 選擇要呼叫哪個工具。 你無需把 agent 預先繫結到特定的 UI 上——agent 會 根據後設資料自動掛載。

你可以請求什麼

經過驗證的模式，附帶一行提示詞：

如果 AI 無法完成，它會明確告知——併為你指出 手動操作的途徑（通常是一個 30 行的 *.ts 檔案，或一個 Console 表單）。

即時預覽

每次變更獲批後，Console 會就地重新渲染受影響的檢視。 無需重新載入。核心快取會使被改動的包失效； 後續請求將使用新的後設資料。

回滾

待處理動作記錄會保留變更前的狀態。如果某次變更出錯， 拒絕所有在途的條目，然後請 AI：

You: Roll back the last 3 changes to support_ticket.
AI:  Found 3 mutations from conversation conv_abc (3 minutes ago).
     Restoring 'support_ticket' to its state at 13:42:11.
     Approve? [Yes]

對於規模更大的回滾，請使用 os diff 對比你上一個已知良好的產物，並應用反向 diff。

當前的限制

• 資料訪問遵循操作員自身的許可權。 助手以登入使用者的身份執行，因此它只能讀取或寫入 該使用者本就有許可權操作的記錄。大多數團隊會讓 助手專注於後設資料，並讓它查詢——而非變更—— 客戶資料。
• 跨包變更需要顯式確認。 請求 AI 修改系統包（sys_*）會返回拒絕 訊息——平臺在原則上拒絕這類操作。
• 長時間執行的多步驟計劃（例如“從零構建一個完整的 HR 應用”） 是可行的，但最好拆分成一系列較小的 對話來完成，每次落地一兩個物件。

超越構建期 AI

同樣的 AI 底層能力也為你的終端使用者驅動執行時 agent—— 支援助手、銷售副駕、內部問答機器人——它們構建於 同一套 Agent → Skill → Tool 架構之上。參見 Agents。

下一步去哪裡

• Agents —— 基於你的資料構建的終端使用者助手
• Data Model —— AI 實際生成的內容
• Actions —— AI 作為執行時工具暴露的單元
• AI Service —— 提供商配置（OpenAI / Anthropic / Doubao / …）