Ejemplos y Demostraciones de Contenedores

Ejemplos concretos y ejecutables en espíritu de las formas de contenedor de Asset Core—demostrando la coordinación determinista del estado del mundo.

0D Balance

Un conjunto compartido de créditos de computación o unidades de energía. Las transacciones debitan o acreditan un único valor escalar—sin posiciones, solo cantidad.

Lo que esto muestra

Agregados escalares sin coordenadas espaciales
Ajustes de balance atómico (débito/crédito)
Reproducción determinista del historial de transacciones
Grupos de recursos compartidos multiagente

Ejemplo de operaciones

{
  "operations": [
    {
      "op": "CreateContainer",
      "args": {
        "kind": "Balance",
        "container": "energy_pool"
      }
    },
    {
      "op": "AdjustBalance",
      "args": {
        "container": "energy_pool",
        "class": "energy_unit",
        "delta": -50
      }
    }
  ]
}

Esto crea un contenedor de Balance llamado “energy_pool” y ajusta la clase energy_unit en -50, reduciendo el balance de 100 a 50 unidades.

Diagrama de leyenda: antes = 100 unidades, después = 50 unidades en energy_pool.

Utilice un balance 0D cuando solo importa “cuánto”, no “dónde” se mantiene.

Garantía determinista: Secuencias idénticas producen resultados idénticos.

Escenario del agente: Un agente LLM gestionando créditos de computación para un clúster. Llamadas a herramientas del agente:

check_balance() → consultar créditos actuales
reserve_credits(job_id, amount) → deducción atómica
release_credits(job_id) → reembolso al completar el trabajo

Asset Core garantiza que no haya doble gasto, no haya saldos negativos y se mantenga un registro completo de cada transacción de crédito.

0D Slots

Una entidad expone 8 espacios para herramientas. Herramientas como una cámara o un agarre ocupan exactamente un espacio; los espacios no tienen geometría, solo posiciones etiquetadas.

Lo que esto muestra

Posiciones discretas sin relaciones geométricas
Gestión de herramientas/equipos con exclusividad de ranura
Estado del equipo determinista
Posicionamiento semántico (no coordenadas espaciales)

Ejemplo de operaciones

{
  "operations": [
    {
      "op": "CreateContainer",
      "args": {
        "kind": { "Slots": { "count": 8 } },
        "container": "robot_tools"
      }
    },
    {
      "op": "EquipInstanceInSlot",
      "args": {
        "container": "robot_tools",
        "slot_index": 3,
        "instance": "camera_head"
      }
    }
  ]
}

Esto crea un contenedor de Slots con 8 slots llamado “robot_tools” y equipa una instancia de camera_head en el slot 3.

Diagrama de leyenda: el slot 3 contiene la cámara_head.

Utilice slots cuando necesite posiciones mutuamente exclusivas con etiquetas, pero sin geometría espacial.

Garantía determinista: Secuencias idénticas producen configuraciones de ranura idénticas.

Escenario del agente:
Un agente LLM controlando un robot con 8 ranuras para herramientas. Llamadas a herramientas del agente:

list_equipped_tools() → consultar el equipo actual
equip_tool(slot_id, tool_name) → asignación atómica de ranura
swap_tools(slot_a, slot_b) → intercambio transaccional

Asset Core impone la exclusividad de los slots: no hay herramientas fantasma, no hay doble equipamiento y se garantiza la plena procedencia de cada cambio de equipo.

Rejilla 1D: Transportador Lineal

Un carril de transporte con posiciones 1..5. Los agentes colocan y mueven paquetes a lo largo de un solo eje; dos elementos no pueden ocupar la misma posición.

Lo que esto muestra

Semántica espacial lineal (posicionamiento en un solo eje)
Detección de colisiones y exclusividad de posición
Operaciones de movimiento secuenciales
Colocación determinista y orden de movimiento

Ejemplo de operaciones

{
  "operations": [
    {
      "op": "CreateContainer",
      "args": {
        "kind": {
          "Grid": {
            "capacity": 5,
            "grid_width": null
          }
        },
        "container": "conveyor"
      }
    },
    {
      "op": "PlaceInstanceOnGrid",
      "args": {
        "container": "conveyor",
        "position": { "index": 3 },
        "instance": "package_42"
      }
    }
  ]
}

Esto crea un contenedor de cuadrícula 1D con 5 posiciones llamadas “conveyor” y coloca package_42 en la posición 3.

Leyenda del diagrama: P42 marca package_42 en la posición 3.

Utilice una cuadrícula 1D cuando el orden a lo largo de un solo carril sea importante y se deban prevenir colisiones.

Garantía determinista: Secuencias idénticas producen resultados idénticos.

Escenario del agente: Un agente LLM gestionando una cinta transportadora. Llamadas a herramientas del agente:

get_item_position(item_id) → consultar ubicación en la cinta
move_item(item_id, target_position) → movimiento seguro contra colisiones
remove_item(item_id) → eliminación atómica del cinturón

Asset Core previene la doble ocupación, rastrea el orden de los artículos y permite la reproducción perfecta de las operaciones del transportador.

1D Continuo: Riel de Precisión

Un riel calibrado con resolución en milímetros. Un carro robótico se mueve a lo largo de un eje continuo utilizando coordenadas de punto fijo.

Lo que esto muestra

Coordenadas de punto fijo con redondeo determinista
Colocación verificada por límites a lo largo de un solo eje
Comprobaciones de colisión continuas para intervalos superpuestos
Semánticas de compromiso/repetición idénticas a contenedores discretos

Ejemplo de operaciones

{
  "operations": [
    {
      "op": "CreateContainer",
      "args": {
        "kind": {
          "ContinuousLine1d": {
            "min_x": 0,
            "max_x": 200000,
            "quantization_inv": 1000
          }
        },
        "container": "rail"
      }
    },
    {
      "op": "PlaceInstanceInContinuous1d",
      "args": {
        "container": "rail",
        "coord": { "x": 25000 },
        "instance": "carriage_A"
      }
    },
    {
      "op": "MoveInstanceWithinContinuous1d",
      "args": {
        "container": "rail",
        "instance": "carriage_A",
        "to_coord": { "x": 158750 }
      }
    }
  ]
}

Esto crea un contenedor ContinuousLine1d llamado “rail” y mueve carriage_A a x=158.750 (quantization_inv=1000).

Diagrama de leyenda: C = carriage_A.

Utilice una línea continua 1D cuando las distancias del mundo real a lo largo de un solo eje deban ser preservadas.

Garantía determinista: Secuencias idénticas producen resultados idénticos.

Escenario del agente: Un agente LLM controlando un riel lineal. Llamadas a herramientas del agente:

get_carriage_position(carriage_id) → consultar la coordenada actual
move_carriage(carriage_id, target_x) → movimiento seguro contra colisiones
reserve_span(start_x, end_x) → asegurar ventana de viaje exclusiva

Asset Core impone una colocación determinista, previene la superposición y proporciona una reproducción exacta del movimiento del riel.

Rejilla 2D: Piso del Almacén

Una pequeña cuadrícula de almacén (5×5). Los robots y los paquetes ocupan coordenadas discretas; los movimientos comprometidos se serializan para prevenir colisiones.

Lo que esto muestra

Semántica espacial bidimensional (coordenadas x, y)
Detección de colisiones entre múltiples entidades
Colocación y movimiento basados en coordenadas
Estado de cuadrícula autoritativo para la coordinación de múltiples agentes

Ejemplo de operaciones

{
  "operations": [
    {
      "op": "CreateContainer",
      "args": {
        "kind": {
          "Grid": {
            "capacity": 25,
            "grid_width": 5
          }
        },
        "container": "warehouse"
      }
    },
    {
      "op": "PlaceInstanceOnGrid",
      "args": {
        "container": "warehouse",
        "position": { "x": 1, "y": 4 },
        "instance": "robot_A"
      }
    },
    {
      "op": "PlaceInstanceOnGrid",
      "args": {
        "container": "warehouse",
        "position": { "x": 2, "y": 4 },
        "instance": "package_12"
      }
    }
  ]
}

Esto crea un contenedor de cuadrícula 2D (5×5) llamado “warehouse” y coloca robot_A en (1,4) y package_12 en (2,4).

Leyenda del diagrama: R = robot_A, P = package_12.

Utilice una cuadrícula 2D cuando los agentes necesiten coordenadas compartidas, conciencia del vecindario y movimiento seguro contra colisiones.

Garantía determinista: Secuencias idénticas producen estados del mundo idénticos.

Escenario del agente: Múltiples agentes LLM navegando por un piso de almacén compartido. Llamadas a herramientas del agente:

get_robot_position(robot_id) → consultar coordenadas actuales
plan_path(start, goal) → búsqueda de caminos consciente de colisiones
move_robot(robot_id, target_coords) → movimiento atómico y seguro contra colisiones

Asset Core proporciona un estado espacial autoritativo: sin posiciones fantasma, sin colisiones y con un historial de coordinación completo entre todos los agentes.

2D Continuo: Celda de Trabajo de Robot

Una célula de trabajo limitada para robótica de pick-and-place. Las colocaciones utilizan coordenadas fijas x/y con rotación determinista en miligrados.

Lo que esto muestra

Coordenadas fijas x/y con cuantización explícita
Comprobaciones de colisión de rectángulos orientados (OBB)
Colocaciones, movimientos y rotaciones con verificación de límites
Reproducción determinista de planes de movimiento multiagente

Ejemplo de operaciones

{
  "operations": [
    {
      "op": "CreateContainer",
      "args": {
        "kind": {
          "ContinuousGrid2d": {
            "min_x": 0,
            "min_y": 0,
            "max_x": 200000,
            "max_y": 120000,
            "quantization_inv": 1000,
            "bucket_cell_size": 10000
          }
        },
        "container": "workcell"
      }
    },
    {
      "op": "PlaceInstanceInContinuous2d",
      "args": {
        "container": "workcell",
        "coord": { "x": 25000, "y": 40000 },
        "rotation": 0,
        "instance": "gripper_A"
      }
    },
    {
      "op": "PlaceInstanceInContinuous2d",
      "args": {
        "container": "workcell",
        "coord": { "x": 110000, "y": 30000 },
        "rotation": 90000,
        "instance": "part_17"
      }
    },
    {
      "op": "MoveInstanceWithinContinuous2d",
      "args": {
        "container": "workcell",
        "instance": "gripper_A",
        "to_coord": { "x": 90000, "y": 80000 }
      }
    }
  ]
}

Esto crea una workcell ContinuousGrid2d, coloca gripper_A en (25.000, 40.000), coloca part_17 en (110.000, 30.000) y mueve el gripper hacia el objetivo.

Diagrama de leyenda: G = gripper_A, P = part_17.

Utilice un contenedor continuo 2D cuando se deban preservar las coordenadas físicas y la rotación.

Garantía determinista: Secuencias idénticas producen estados del mundo idénticos.

Escenario del agente: Un planificador robótico coordinando recogidas en una celda de trabajo compartida. Llamadas a la herramienta del agente:

preflight_commit(pick_plan) → validar la secuencia sin mutación
commit(pick_plan) → ejecutar una vez que el preflight tenga éxito
read_workcell_region(bounds) → consultar ubicaciones cercanas para verificar colisiones

Asset Core asegura que el preflight y el commit se mantengan sincronizados mientras se preserva un rastro de auditoría determinista.

Transferencia Universal: Operaciones Cruzadas Dimensionales

Las operaciones de Asset Core funcionan de manera consistente a través de los tipos de contenedores. La misma gramática se aplica ya sea al transferir entre saldos, espacios o cuadrículas, demostrando el modelo de operación universal.

Lo que esto muestra

Semánticas de operación unificadas a través de dimensiones
Transiciones de estado entre contenedores
Registro de commits consistente para flujos de trabajo de múltiples contenedores
Transformaciones del estado del mundo composables

Ejemplo: Transferencia de Balance → Grid 2D

Additional guidance:

Tone: formal Register: technical

Context:

domain: infraestructura de blockchain
audience: desarrolladores e investigadores
purpose: documentación técnica

Constraints:

Use gender-neutral language
Preserve brand names
Maintain technical accuracy

Preserve without translation:

code_blocks
inline_code
links
glossary_terms
mathematical_notation

Glossary guidance:

Preserve these terms exactly: Asset Core, Asset‑Core, CSP, API, Docker, ECS, daemon, L1, L2, L3, OpenGraph, GitHub, Astro, TypeScript, JavaScript, ℤ, ℤ², ℤ³, ℝ², ℝ³, 0D, 1D, 2D, 3D.

{
  "operations": [
    {
      "op": "CreateContainer",
      "args": {
        "kind": "Balance",
        "container": "parts_pool"
      }
    },
    {
      "op": "CreateContainer",
      "args": {
        "kind": {
          "Grid": {
            "capacity": 25,
            "grid_width": 5
          }
        },
        "container": "assembly_floor"
      }
    },
    {
      "op": "AdjustBalance",
      "args": {
        "container": "parts_pool",
        "class": "widget",
        "delta": -1
      }
    },
    {
      "op": "PlaceInstanceOnGrid",
      "args": {
        "container": "assembly_floor",
        "position": { "x": 2, "y": 3 },
        "instance": "widget#0001"
      }
    }
  ]
}

Esto convierte una cantidad de un balance 0D en un elemento colocado en una cuadrícula 2D—misma gramática de operación, diferentes tipos de contenedores.

Los mismos verbos (ajustar, colocar, transferir) a través de tipos de contenedores; el orden determinista vincula ambos cambios a un historial de commits.

Escenario del agente:
Un agente LLM transfiriendo partes de un grupo (balance 0D) a posiciones de ensamblaje (rejilla 2D). Llamadas a herramientas del agente:

check_parts_available() → consultar saldo
reserve_and_place(part_type, grid_coords) → operación atómica de contenedor cruzado

Asset Core realiza ambos cambios de manera atómica: sin inventario fantasma, sin piezas perdidas y con una auditoría unificada a través de los tipos de contenedores.

Aprender Más

Para detalles técnicos, consulte Basics para tipos de arquitectura y contenedores, o la Docs para una documentación técnica más profunda.