
Agent-Native: фреймворк для агентных приложений
Обзор BuilderIO/agent-native — open-source TypeScript-фреймворка, где агент и UI работают через единый слой действий. Возможности, сравнение, вердикт.
Agent-Native: фреймворк для агентных приложений от Builder.io
«Не выбирай между богатым UI и автономным агентом — каждое Agent-Native приложение включает и то, и другое.»
Репозиторий создан 12 марта 2026 года и к сентябрю 2026 набрал более 4 760 звёзд и 449 форков на GitHub. Проект активно развивается: последний коммит датирован 20 сентября 2026 года.
Что такое Agent-Native и для кого он
Agent-Native — это open-source TypeScript-фреймворк для построения агентов, которые сочетают автономную работу с целевым пользовательским интерфейсом. Иными словами, это не очередная обёртка над LLM-чатом, а полноценная архитектурная основа для приложений нового поколения.
Agent-Native позиционирует агентов как полноправных жителей приложения, а не прикрученных сбоку чат-ботов.
Для кого подойдёт:
- Full-stack TypeScript-разработчикам, строящим SaaS-продукты с AI
- Командам, которым нужно быстро получить production-ready агентное приложение
- Стартапам, желающим избежать vendor lock-in и держать весь код у себя
- Инди-разработчикам, экспериментирующим с агентными паттернами
Ключевая идея: единый слой действий
Agent-native приложения — это ПО, в котором люди и AI-агенты работают с одним продуктом через общие действия, данные, разрешения и контекст.
Принцип Agent UI Parity означает: всё, что может сделать UI, должен уметь и агент. Если можно заархивировать письмо, создать дашборд, запланировать встречу или отрендерить видео через интерфейс — агент должен выполнить то же действие через тот же механизм приложения.
graph TD
A[defineAction] --> B[UI Button / Hook]
A --> C[Agent Tool Loop]
A --> D[HTTP Endpoint]
A --> E[MCP Server]
A --> F[A2A Protocol]
A --> G[CLI]
B & C & D & E & F & G --> H[Единая валидация и разрешения]
Ключевые возможности
1. defineAction — центральный примитив
Центральный примитив — defineAction() из @agent-native/core. Вы объявляете Zod-схему, функцию run() и опциональные метаданные; фреймворк автоматически обнаруживает файлы в папке actions/ и открывает их везде, где они нужны продукту.
Поле ActionRunContext.caller сообщает бизнес-логике, пришёл ли вызов из UI, цикла агента, HTTP, MCP, A2A или CLI.
import { defineAction } from "@agent-native/core/action";
import { z } from "zod";
// Одно действие работает на всех поверхностях: UI, агент, HTTP, MCP, A2A, CLI
export default defineAction({
description: "Вернуть дружеское приветствие",
schema: z.object({
name: z.string().default("world").describe("Имя для приветствия"),
}),
http: { method: "GET" },
run: async ({ name }) => {
return { message: `Привет, ${name}!` };
},
});
React вызывает ту же функцию через useActionQuery("hello", { name: "Alex" }). Agent-Native также открывает её через HTTP, MCP, A2A и CLI.
2. Разделённое состояние и живая синхронизация
Агент и UI используют одну базу данных и одно состояние. Изменения с любой стороны отображаются мгновенно.
Agent-Native рассматривает состояние приложения как общий реал-тайм реестр между человеком и агентом: агент автоматически получает активный UI-контекст — текущий маршрут, сфокусированный элемент, выделенную строку таблицы, активный фильтр.
3. Реал-тайм мультиплеер с CRDT
Реал-тайм мультиплеер — люди и агенты одновременно работают в одном документе: CRDT-слияние, живое присутствие (курсоры, кольца выделения, кто на каком слайде), агент как полноправный соредактор.
4. Надёжность: typed actions вместо pixel-driven
В отличие от нестабильных computer-use инструментов, которые пытаются разбирать скриншоты и кликать по координатам, агенты Agent-Native выполняют типизированные действия напрямую. Это даёт детерминированную надёжность, отсутствие перехвата UI и мгновенную скорость выполнения.
5. Полный стек из коробки
Построен на TypeScript с Drizzle ORM и Nitro-сервером; поставляется с agent runtime, который включает чат, инструменты, навыки, память, задания, наблюдаемость и handoff в единый стек.
Для хранения данных: работает с лёгким PGlite, встроенным в память для разработки, и бесшовно подключается к управляемому PostgreSQL (Supabase, Neon, AWS RDS) в продакшне.
6. Широкая поддержка протоколов
Из коробки: A2A, MCP, MCP Apps, стандартный remote MCP OAuth, MCP-клиенты, HTTP/CLI, нативные чат-виджеты, адаптеры AgentChatRuntime, коннекторы OpenAI, AG-UI, Claude Agent SDK и Vercel AI SDK, а также deep links — всё висит на одной поверхности действий.
7. Готовые шаблоны приложений
Фреймворк включает production-ready шаблоны — полноценные SaaS-приложения (запись экрана, прототипирование дизайна, редактирование контента, генерация слайдов), демонстрирующие агентно-нативный паттерн: клонируемые, без скаффолдинга, весь код принадлежит разработчику.
Доступные примеры агентов включают: запись и анализ встреч и голосовых заметок; генерацию и доработку интерактивных дизайнов; создание и редактирование презентаций; анализ данных и построение дашбордов; планирование встреч и управление расписанием; приоритизацию почты и подготовку ответов; публикацию контента; создание визуальных планов с диаграммами и вайрфреймами.
8. Быстрый старт
# Полный интерактивный шаблон
npx @agent-native/core@latest create my-app
# Минималистичный чат-шелл
npx @agent-native/core@latest create my-app --template chat
# Только действия, без UI
npx @agent-native/core@latest create my-agent --headless
cd my-app
pnpm install
pnpm dev
--template chat. Он даёт рабочий агентно-нативный цикл из конца в конец и один пример действия, на основе которого легко добавить свои данные и UI.Тарифы и лицензия
Agent-Native выпущен Builder.io на GitHub как open-source проект, поощряющий вклад сообщества. Фреймворк полностью бесплатен.
| Составляющая | Детали |
|---|---|
| Лицензия | Open-source (GitHub) |
| Стоимость фреймворка | Бесплатно |
| База данных (dev) | PGlite — embedded, бесплатно |
| База данных (prod) | Любая SQL через Drizzle (Supabase, Neon, AWS RDS — по тарифам провайдера) |
| Хостинг | Любой Nitro-совместимый, включая serverless |
| LLM | Bring Your Own — стоимость по тарифам провайдера (OpenAI, Anthropic и др.) |
Плюсы и минусы
| ✅ Плюсы | ❌ Минусы |
|---|---|
Единый defineAction для UI, агента, HTTP, MCP, A2A, CLI | Только TypeScript — Python-команды не смогут его использовать |
| Реал-тайм синхронизация агента и UI из коробки | Проект молодой (с марта 2026), ещё есть открытые issues |
| Полный стек: auth, memory, jobs, observability | Требует знания Drizzle ORM, Nitro — порог входа выше среднего |
| Нет vendor lock-in — любая SQL БД и любой хостинг | Нет Python SDK и нет официальной облачной платформы |
| Production-ready шаблоны SaaS-приложений | Документация продолжает дополняться |
| Поддержка MCP, A2A, AG-UI, OpenAI, Claude, Vercel AI SDK | Небольшое сообщество по сравнению с LangChain/LangGraph |
| Детерминированное выполнение (typed actions, не pixel-driven) | Nightly-сборки — проект ещё не достиг стабильного v1.0 |
Сравнение с альтернативами
LangGraph — граф-ориентированный фреймворк LangChain для управления состоянием в многошаговых агентах: рабочие процессы моделируются как направленные графы с узлами и рёбрами, поддерживающие циклы, условную маршрутизацию и долгосрочное состояние. Vercel AI SDK обеспечивает наилучший опыт разработчика для React и Next.js-приложений с нативной поддержкой Edge, стриминг-ориентированной архитектурой и интеграцией с 25+ провайдерами.
| Параметр | Agent-Native | Mastra | Vercel AI SDK |
|---|---|---|---|
| Язык | TypeScript | TypeScript | TypeScript |
| UI + агент в одном стеке | ✅ Нативно | ⚠️ Нет встроенного UI | ⚠️ Streaming UI, без агент-UI parity |
| Единый слой действий | ✅ defineAction | ❌ Отдельно | ❌ Отдельно |
| Память агента | ✅ SQL-backed | ✅ Pluggable (Postgres, Upstash) | ❌ Нет first-class |
| MCP/A2A протоколы | ✅ Из коробки | ⚠️ Экспериментально | ✅ MCP (v6+) |
| Realtime multiplayer (CRDT) | ✅ Есть | ❌ Нет | ❌ Нет |
| Vendor lock-in | ❌ Нет | ❌ Нет | ⚠️ Vercel-ориентирован |
| Зрелость | 🟡 Молодой (2026) | 🟢 Растущий | 🟢 Зрелый (20M dl/мес) |
| Лицензия | Open-source | Apache 2.0 | MIT |
| GitHub звёзды | ~4 760 | ~20 000+ | ~30 000+ |
- Agent-Native — когда нужен полный агентно-нативный SaaS со встроенным UI-агент parity
- Mastra — когда нужны durable workflows и pluggable memory без требования к UI-интеграции
- Vercel AI SDK — когда нужен быстрый чат-стриминг поверх Next.js без сложной агентной оркестровки
Вердикт
Agent-Native от Builder.io предлагает принципиально новый взгляд на архитектуру агентных приложений. Фреймворк представляет собой естественную эволюцию разработки ПО в эпоху генеративного AI: убирая разрыв между изолированными чат-пузырями, он объединяет слой действий между кодом и моделями, позволяя строить приложения, где AI — активный, надёжный соавтор.
Agent-Native — open-source фреймворк для построения надёжных агентов, которые действуют внутри реальных приложений, а не просто общаются рядом с ними. Он предоставляет примитивы для production-grade агентного ПО: общие действия, SQL-состояние, идентичность, инструменты, навыки, задания, наблюдаемость и UI-поверхности, работающие вместе.
Кому подойдёт:
- TypeScript full-stack командам, строящим AI-first SaaS-продукты
- Разработчикам, которым критичен Agent UI Parity
- Проектам, требующим реал-тайм мультиплеера между агентом и пользователем
Кому пока не подойдёт:
- Python-командам (фреймворк только TypeScript)
- Проектам, требующим enterprise-сертификаций (SOC 2 и т.д.)
- Командам, которым нужна зрелая экосистема с многолетней историей
Рейтинг: 8 / 10
| Критерий | Оценка |
|---|---|
| Оригинальность архитектуры | ⭐⭐⭐⭐⭐ |
| Developer Experience | ⭐⭐⭐⭐ |
| Зрелость / стабильность | ⭐⭐⭐ |
| Документация | ⭐⭐⭐ |
| Экосистема и сообщество | ⭐⭐⭐ |
| Production-readiness | ⭐⭐⭐⭐ |