Fonaments Tècnics

Conceptes Bàsics

Asset Core és un motor espacial-transactional determinista que tracta l’estat del món com una sèrie de transformacions atòmiques i reproduïbles. Quan els agents basats en LLM executen trucades d’eines—des d’afegir articles a un contenidor fins a moure entitats a través d’una graella—cada mutació es registra en un registre de compromisos només d’append que serveix com a única font de veritat.

Aquesta arquitectura garanteix que:

• La mateixa seqüència d’esdeveniments sempre produeix el mateix estat final (determinisme)
• Qualsevol punt en el temps es pot reconstruir reproduint el registre de commits (reproducció)
• L’estat intern i les notificacions externes mai divergeixen (consistència)
• Totes les operacions són atòmiques i transaccionals (fiabilitat)

Tipus de contenidors

Els agents operen en entorns amb diferents estructures espacials. Asset Core proporciona tipus de contenidors de primera classe per a cadascun, modelant els contenidors com a objectes tipats espacialment on cadascun representa un tipus distint d’espai adreçable. El sistema actualment suporta:

Contenidors 0-Dimensionals

• Balances: Agregats escalar sense coordenades espacials. S’utilitzen per a moneda, recursos o qualsevol quantitat que no ocupi espai.
• Slots: Posicions discretes i numerades (1, 2, …, N) sense relacions geomètriques. S’utilitzen per a slots d’equipament, llistes ordenades o posicions semàntiques.

Gres de Discreció (1D/2D)

• 1D Grids (ℤ): Reixetes lineals amb posicions seqüencials. Suporten la col·locació de formes, les col·lisions i les restriccions espacials al llarg d’un únic eix.
• Gresols 2D (ℤ²): Reixetes bidimensionals (amplada × altura) amb semàntica geomètrica completa. Suporten formes de múltiples cel·les, rotació, adjacència i detecció de col·lisions.

Espais Contínuos (1D/2D)

• 1D Continu (ℝ): Coordenades de punt fix al llarg d’una línia per a rails, ascensors i robòtica d’eix únic.
• 2D Continu (ℝ²): Col·locacions de punts fixos x/y amb rotació per a cèl·lules de treball de robots i comprovacions de col·lisió mètriques.

Full de ruta: Dimensions Superiors

Gresos Discrets 3D (ℤ³): Reixetes volumètriques amb profunditat, que s’estenen les semàntiques 2D a tres dimensions.

Continuous 3D (ℝ³): Volums continus amb integració de física, col·lisió basada en mètriques i transformacions suaus.

Operacions Universals

Tots els contenidors comparteixen un conjunt comú d’operacions que funcionen de manera coherent a través dels espais dimensionals:

• Afegir/Eliminar: Introduir o eliminar quantitats o entitats
• Mou: Traduir entitats dins de l’espai del mateix contenidor
• Dividir/Combinar: Divideix o combina piles i quantitats
• Transferència: Mou entitats entre diferents contenidors (transicions entre espais)

Aquestes operacions preserven el determinisme, són completament reproduïbles i mantenen una semàntica consistent tant si s’apliquen a balances de 0D com a graelles de 2D.

Arquitectura

Quan un agent executa una crida d’eina que modifica l’estat del món, Asset Core la processa a través de tres capes. Aquesta arquitectura de tres capes s’inspira en els motors d’emmagatzematge de bases de dades, assegurant una separació neta de preocupacions i un comportament previsible.

Cap de Magatzematge (L1)

Estructures de dades de baix nivell optimitzades per al rendiment. Utilitza un disseny de Structure-of-Arrays (SoA) amb IDs densos per a una iteració amigable amb la memòria cau i patrons d’accés a la memòria predecibles. Aquesta capa proporciona primitives en brut sense validació ni lògica empresarial.

Operacions Layer (L2)

Validació de domini i orquestració d’estat. Aquesta capa orquestra primitives d’emmagatzematge, aplica restriccions del món (col·lisió, límits, ajustament de forma), manté índexs derivats i emet esdeveniments que descriuen què ha canviat. Les operacions són deterministes i completament validades abans de comprometre’s.

Cap de Transacció (L3)

Execució atòmica amb suport de retrocés. Aquesta capa coordina els límits de les transaccions, registra la informació de desfer per al retrocés i segella les operacions exitoses al registre de confirmació. Garantix que les operacions siguin atòmiques i aïllades. Aquesta estratificació assegura que els camins crítics per al rendiment es mantinguin ràpids (L1), les regles del món estiguin centralitzades i siguin provables (L2), i la correcció transaccional s’apliqui estructuralment (L3).

Garanties

Asset Core proporciona fortes garanties de correcció i fiabilitat mitjançant la reproducció determinista i un registre de compromís només d’addició.

Repetició

La reproducció és central per a les garanties de correcció d’Asset Core i permet la reconstrucció perfecta del comportament de l’agent. El registre de compromisos emmagatzema esdeveniments com a registres híbrids que contenen tant:

• Informació del delta: Què ha canviat (s’han afegit 10 elements, mogut de la ranura A a la ranura B)
• Post-estat: L’estat resultant després del canvi (la quantitat final és 50, l’entitat ara a la posició X)

Aquesta codificació dual permet:

• Anàlisi en temps real: La informació delta pot impulsar taulers de control, notificacions i consultes en viu.
• Reproducció determinista: L’estat posterior defineix el resultat autoritzat—reproduir la seqüència enregistrada reproduïx l’estat original exacte sense desviació acumulativa.
• Recuperació de fallades: Qualsevol projecció (model de lectura o observador) es pot reconstruir a partir del registre de confirmacions.

Replay aplica esdeveniments mecànicament utilitzant només primitives d’emmagatzematge, sense validació ni lògica de regles del món. Això garanteix que l’estat reproduït és equivalent bit a bit a l’estat original compromès.

Registre de Compromisos

El registre de commits és una seqüència durable d’agrupacions d’esdeveniments segellades que serveix com a registre autoritzat de totes les accions de l’agent. Evita les escriptures duals fent que el registre sigui l’única escriptura atòmica: cada transició d’estat es segella mitjançant un únic append, i totes les projeccions i notificacions deriven d’aquesta única font de veritat.

Propietats clau:

• Els esdeveniments són immutables un cop compromesos.
• Els números de seqüència globals, que augmenten de manera monòtona, proporcionen un ordenament total.
• Els lots es verifiquen mitjançant sumes de control per a la verificació de la integritat.
• Els segments poden ser comprimits, xifrats o arxivats.

Aquest disseny suporta el compliment (rutes d’auditoria, cadena de custòdia), la depuració (reproducció a qualsevol estat històric) i la isolació multi-tenant (historial de compromisos amb espai de noms). Les projeccions i notificacions es deriven d’esdeveniments compromesos i es poden tornar a provar de manera independent sense arriscar-se a la divergència.

Casos d’ús

Asset Core està dissenyat per donar suport a sistemes que requereixen un model determinista i transaccional de l’estat del món, amb un enfocament principal en agents basats en LLM i plataformes multi-agent.

Sistemes Multi-Agent

En entorns multi-agent, Asset Core pot servir com a model de món compartit. Les invocacions d’eines registren canvis d’estat deterministes—com ara moure o transferir recursos—al registre de confirmacions, creant una línia de temps auditable per a la depuració, l’anàlisi i la reproducció.

Plataformes d’Agent i Orquestració

Els marcs d’orquestració poden integrar Asset Core per proporcionar un estat de sessió durable i aïllament amb espai de noms. La reproducció determinista permet fluxos de treball multi-pas reproduïbles i inspecció post-hoc.

Simulacions i Jocs

Els motors de simulació i de jocs poden utilitzar Asset Core per modelar inventaris, equipament i lògica espacial. La reproducció determinista suporta un comportament de desar/carregar precís, un estat de multijugador sincronitzat i una verificació de grau d’auditoria.

Veure exemples

Per a demostracions concretes de cada tipus de contenidor, consulteu la pàgina Examples per a operacions JSON executables en esperit i escenaris d’agents.