Agent-Native es un framework de código abierto en TypeScript que permite a una interfaz y a su agente de IA compartir las mismas funciones y datos.
Resuelve un problema práctico al añadir agentes a una aplicación: mantener sus herramientas alineadas con lo que hace el producto. Si cambiar la fecha de una reunión funciona de una manera en el chat y de otra en el calendario, tienes dos comportamientos que mantener.
La propuesta de Builder.io reúne esas operaciones en una capa de acciones compartidas. La interfaz y el agente se convierten en dos formas de trabajar con la misma aplicación.
¿Qué es Agent-Native?
Agent-Native es un framework para crear aplicaciones con un agente integrado y una interfaz visual donde las personas pueden revisar y editar su trabajo.
El repositorio incluye puntos de partida para calendarios, correo, presentaciones, analítica y contenido. La idea que los conecta es la continuidad: puedes trabajar desde la interfaz, delegar una tarea al agente y revisar el resultado en el mismo entorno.
Piensa en un calendario editorial. Seleccionas tres borradores y pides: «Pásalos a la próxima semana, manteniendo el orden».
Una aplicación construida con este enfoque podría pasar al agente los identificadores de los borradores seleccionados, permitirle invocar la acción de programación y mostrar las nuevas fechas en el calendario. Es un ejemplo ilustrativo, no una prueba realizada para este artículo.
El framework aporta la estructura. Tú implementas las reglas de programación y decides qué cambios necesitan aprobación.
¿Cómo funciona Agent-Native?
Funciona mediante acciones compartidas: defines una operación con su esquema de entrada y su implementación, y la invocas desde las interfaces que admite el framework.
La guía oficial de acciones comienza con este ejemplo:
// actions/hello.ts
import { defineAction } from "@agent-native/core/action";
import { z } from "zod";
export default defineAction({
description: "Say hello from the local agent.",
schema: z.object({
name: z.string().default("world"),
}),
http: { method: "GET" },
readOnly: true,
run: async ({ name }) => {
return { message: `Hello, ${name}!` };
},
});
El saludo es deliberadamente sencillo. Lo importante es el contrato: una descripción que el agente puede utilizar, entradas estructuradas y una única implementación.
El framework permite invocar las acciones desde la interfaz, las herramientas del agente, HTTP, MCP y la línea de comandos, según los permisos de exposición definidos. Esas vías comparten la validación y los controles de acceso. El agente utiliza llamadas a herramientas, o tool calling, para solicitar las operaciones.
En una aplicación real, la acción podría actualizar una reserva o guardar una diapositiva editada. La ventaja para el desarrollo es tener un único lugar donde mantener el comportamiento de esa operación.
¿Cómo sabe el agente qué has seleccionado?
La aplicación proporciona al agente el estado relevante de navegación y selección.
Esto requiere trabajo de integración. Tu interfaz registra contexto útil, como la vista actual y los identificadores de los elementos seleccionados; después, el agente puede recuperar los datos correspondientes. La guía de contexto explica cómo conectar esas piezas.
Así una petición como «resume esto» puede resultar útil. El desarrollador establece a qué se refiere «esto».
Los datos también se comparten. La interfaz y el agente acceden a las mismas tablas de PostgreSQL mediante la capa de acciones. La sincronización refleja los cambios en la interfaz: el resultado puede aparecer como un registro actualizado, listo para revisarlo y seguir editándolo.
¿Cómo instalar Agent-Native?
El punto de partida documentado consiste en crear una aplicación independiente a partir de la plantilla Chat.
Al momento de preparar esta nota, el 20 de septiembre de 2026, la guía de inicio exige Node.js 22.22 o posterior, pnpm y una conexión a un LLM. Estos son sus comandos:
npx --yes @agent-native/core@latest create my-app --standalone --template chat
cd my-app
corepack enable
pnpm install
pnpm dev
La plantilla incluye una interfaz en el navegador, autenticación, conversaciones persistentes, contexto de la aplicación y una acción de ejemplo.
La guía permite conectar el agente a través de Builder.io, utilizar claves de proveedores compatibles o recurrir a un modelo local con Ollama.
Estas instrucciones proceden de la documentación. No hemos ejecutado la aplicación generada ni medido su rendimiento para este artículo.
¿Agent-Native es gratis?
El framework tiene licencia MIT, pero esa licencia no elimina los costes de inferencia ni de alojamiento.
El coste de tu aplicación dependerá del modelo elegido y de la infraestructura que utilices. La posibilidad de conectar un modelo local es una opción de despliegue; también requiere recursos para ejecutarlo.
¿Cómo controlar los permisos de un agente de IA?
Debes definir qué acciones puede invocar el agente, quién está autorizado a ejecutarlas y cuáles necesitan aprobación humana.
La distinción importa: que una entrada sea válida no significa que la operación solicitada sea apropiada.
Según la documentación de autorización, consultada el 20 de septiembre de 2026, las acciones están disponibles para el agente por defecto y la aprobación humana está desactivada por defecto. Puedes exigir aprobación para llamadas con consecuencias y añadir controles de autorización que se apliquen en las distintas vías de ejecución.
La exposición a agentes públicos es una decisión separada y explícita. Que el agente pueda invocar una acción no la convierte automáticamente en un endpoint público anónimo.
En el calendario editorial, consultar las fechas de publicación y modificarlas pueden requerir permisos distintos. Compartir la implementación facilita centralizar esas reglas; tienes que definirlas igualmente.
¿Cuándo conviene usar Agent-Native?
Conviene evaluarlo cuando tu producto necesita operaciones ejecutadas por un agente y una interfaz donde las personas puedan revisar y continuar el trabajo.
Empezaría con una aplicación pequeña y una operación útil disponible por ambas vías. Comprueba que los cambios manuales llegan al agente, que sus cambios aparecen en la interfaz y que los permisos se respetan en ambos casos.
También supone adoptar una estructura de infraestructura. La capa de datos documentada utiliza PostgreSQL y Drizzle. PGlite sirve para desarrollo local; los despliegues compartidos necesitan PostgreSQL persistente. Al 20 de septiembre de 2026, el aprovisionamiento de bases de datos gestionadas por Builder.io sigue figurando como una función prevista, todavía no disponible. La guía de base de datos detalla estas condiciones.
Si ya tienes un producto, la pregunta es cómo encajan sus operaciones y sus reglas de autorización en esa estructura.
En nuestro análisis de Project Solara exploramos cómo los agentes podrían cambiar las aplicaciones. Agent-Native ofrece una arquitectura concreta para examinar: personas y agentes trabajando mediante funciones compartidas, con una interfaz que mantiene visibles los resultados.
Eso lo convierte en un candidato útil para un prototipo acotado. Adoptarlo en producción requiere probar los flujos, los fallos posibles y las condiciones de despliegue relevantes para tu aplicación.