BuilderIO/agent-native

A framework for building agentic apps

這是什麼

Agent-Native 是 BuilderIO 推出的開源 TypeScript 框架，主張把 agent 做成真正的應用，而不是只停留在聊天框。它的核心抽象是 shared actions：同一個 capability 只定義一次，agent 可以把它當工具呼叫，React UI 也能從程式碼直接呼叫；同一層 action 還可透過 HTTP、MCP、A2A 與 CLI 暴露。這讓 agent 的自主工作、使用者介面、驗證、權限與實作邏輯都走同一條路徑。README 特別強調，agent 並不是「點擊 UI」來操作，而是透過共享 action layer 工作；UI 則負責把 agent 能做什麼、產出什麼，以及哪些結果需要檢視、編輯、批准或分享，變成使用者熟悉的操作環境。

為什麼上榜

這個專案會受到注意，關鍵在於它切中 agentic app 從 demo 走向產品化時的痛點：工具、資料、權限、狀態與介面不能各做各的。它目前有 5,186 stars，今日新增 98 stars，以 TypeScript、React 與 AI agent 為主軸，對前端與全端開發者都很容易產生想像。和只提供聊天元件或工具呼叫封裝的框架相比，Agent-Native 更像是在定義一套「agent 與 UI 共用能力」的應用架構：agent 取得相關 UI state，例如目前頁面、選取紀錄或 active view；agent 做出的工作會出現在 UI，UI 做出的變更也能被 agent 使用。這種雙向共享，是它和一般 agent wrapper 最不一樣的地方。

適合誰，可以拿來做什麼

它最適合想把 AI agent 嵌進產品的人：例如內部營運工具、知識工作平台、資料分析、內容生產、簡報與設計輔助等。README 列出的範例 app 包含 Clips、Design、Slides、Analytics、Calendar、Mail、Assets、Content 與 Plans，顯示它不是只為單一聊天場景設計，而是面向多種 工作流型應用。如果你已經有 SQL 資料庫、LLM、工具與基礎設施，Agent-Native 的定位是把這些組成一個有狀態、有權限、有 UI 的 agent workspace。上手門檻偏向 TypeScript／React 開發者；README 提到生產環境使用 PostgreSQL，本地開發可用 PGlite，代表它比較像應用框架，而不是單檔腳本。

上手

README 提供的 quick start 很直接，可用 npx 建立 standalone chat template：

npx --yes @agent-native/core@latest create my-agent --standalone --template chat

接著可參考 getting started guide。README 中的 action 範例使用 defineAction 與 zod 定義 schema，並可設定 HTTP method；同一個 hello action 會被 agent 當工具接收，React 端則用 useActionQuery("hello", { name: "Alex" }) 呼叫。也就是說，真正要理解的不是安裝指令，而是 一次定義、多端共用 的開發模型。

README 重點摘要

• Agent-Native 的核心是 shared actions：agent、UI、HTTP、MCP、A2A、CLI 都能共用同一份 capability。
• 框架內建 agent chat、authentication and permissions、skills and memory、automations、agent teams 與 PostgreSQL backend 等應用級功能。
• agent 不透過點擊 UI 工作，而是透過共享 action layer；這有助於維持驗證、權限與實作的一致性。
• README 展示多個開源 agent app 範例，涵蓋會議／螢幕紀錄、設計、簡報、資料分析、行事曆、郵件與內容工作流。
• 授權為 MIT；專案強調可自帶 LLM、SQL database、tools 與 infrastructure，建出的東西仍由使用者掌握。