Exemples i demostracions de contenidors

Exemples concrets, executables en esperit, de les formes de contenidor d'Asset Core—demostrant la coordinació del món de manera determinista.

0D Balance

Un pool compartit de crèdits de computació o unitats d’energia. Les transaccions debiten o acrediten un únic valor escalar—sense posicions, només quantitat.

Què mostra això

Agregats escalar sense coordenades espacials
Ajustaments de balanç atòmic (dèbit/crèdit)
Reproducció determinista de la història de transaccions
Grups de recursos compartits multi-agent

Operacions d’exemple

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

Això crea un contenidor de Balance anomenat “energy_pool” i ajusta la classe energy_unit en -50, reduint el saldo de 100 a 50 unitats.

Diagrama llegenda: abans = 100 unitats, després = 50 unitats en energy_pool.

Utilitzeu un equilibri 0D quan només importa “quant”, no “on” es manté.

Garantia determinista: Les seqüències idèntiques produeixen resultats idèntics.

Escenari de l’agent: Un agent LLM gestionant crèdits de computació per a un clúster. Crides d’eines de l’agent:

check_balance() → consultar els crèdits actuals
reserve_credits(job_id, amount) → deducció atòmica
release_credits(job_id) → reemborsament en completar la feina

Asset Core garanteix que no hi hagi doble despesa, que no hi hagi saldos negatius i que hi hagi un registre complet de cada transacció de crèdit.

0D Slots

Una entitat exposa 8 espais per a eines. Eines com una càmera o un gripper ocupen exactament un espai; els espais no tenen geometria, només posicions etiquetades.

Què mostra això

Posicions discretes sense relacions geomètriques
Gestió d’eines/equipament amb exclusivitat de slots
Estat de l’equipament determinista
Posicionament semàntic (no coordenades espacials)

Operacions d’exemple

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

Això crea un contenidor de Slots amb 8 slots anomenat “robot_tools” i equipa una instància de camera_head al slot 3.

Diagrama llegenda: el slot 3 conté la càmera cap.

Utilitzeu slots quan necessiteu posicions mútuament excloents amb etiquetes, però sense geometria espacial.

Garantia determinista: Les seqüències idèntiques produeixen configuracions de slot idèntiques.

Escenari de l’agent:
Un agent LLM controlant un robot amb 8 espais d’eines. Crides d’eines de l’agent:

list_equipped_tools() → consultar l’equipament actual
equip_tool(slot_id, tool_name) → assignació atòmica de slot
swap_tools(slot_a, slot_b) → intercanvi transaccional

Asset Core imposa l’exclusivitat de slots: sense eines fantasma, sense doble equipament i amb plena procedència de cada canvi d’equipament.

Reixeta 1D: Transportador Lineal

Una cinta transportadora amb posicions 1..5. Els agents col·loquen i mouen paquets al llarg d’un únic eix; dos articles no poden ocupar la mateixa posició.

Què mostra això

Semàntica espacial lineal (posicionament d’eix únic)
Detecció de col·lisions i exclusivitat de posició
Operacions de moviment seqüencial
Col·locació i ordenació de moviments deterministes

Operacions d’exemple

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

Això crea un contenidor de graella 1D amb 5 posicions anomenades “conveyor” i col·loca package_42 a la posició 3.

Diagrama llegenda: P42 marca package_42 en la posició 3.

Utilitzeu una graella 1D quan l’ordre al llarg d’un sol carril és important i cal prevenir les col·lisions.

Garantia determinista: Les seqüències idèntiques produeixen resultats idèntics.

Escenari de l’agent: Un agent LLM gestionant una cinta transportadora. Crides d’eines de l’agent:

get_item_position(item_id) → consultar la ubicació a la cinta
move_item(item_id, target_position) → moviment segur contra col·lisions
remove_item(item_id) → eliminació atòmica del cinturó

Asset Core evita la doble ocupació, rastreja l’ordre dels articles i permet la reproducció perfecta de les operacions del transportador.

1D Continu: Rail de Precisió

Un rail calibrat amb resolució en mil·límetres. Un carro robotitzat es desplaça al llarg d’un eix continu utilitzant coordenades de punt fix.

Què mostra això

Coordenades de punt fix amb arrodoniment determinista
Col·locació verificada dins d’un sol eix
Comprovacions de col·lisió contínues per a intervals superposats
Semàntiques de compromís/repetició idèntiques a contenidors discretes

Operacions d’exemple

{
  "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 }
      }
    }
  ]
}

Això crea un contenidor ContinuousLine1d anomenat “rail” i mou carriage_A a x=158.750 (quantization_inv=1000).

Llegenda del diagrama: C = carriage_A.

Utilitzeu una línia contínua 1D quan les distàncies del món real al llarg d’un únic eix han de ser preservades.

Garantia determinista: Les seqüències idèntiques produeixen resultats idèntics.

Escenari de l’agent: Un agent LLM controlant un ferrocarril lineal. Crides d’eines de l’agent:

get_carriage_position(carriage_id) → consulta la coordenada actual
move_carriage(carriage_id, target_x) → moviment segur davant de col·lisions
reserve_span(start_x, end_x) → assegurar una finestra de viatge exclusiva

Asset Core aplica una col·locació determinista, evita la superposició i proporciona una reproducció exacta del moviment del ferrocarril.

Reixeta 2D: Planta del Magatzem

Una petita graella d’emmagatzematge (5×5). Els robots i els paquets ocupen coordenades discretes; els moviments compromesos es serialitzen per evitar col·lisions.

Què mostra això

Semàntica espacial bidimensional (coordenades x, y)
Detecció de col·lisions entre múltiples entitats
Col·locació i moviment basats en coordenades
Estat de graella autoritzada per a la coordinació multi-agent

Operacions d’exemple

{
  "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"
      }
    }
  ]
}

Això crea un contenidor de graella 2D (5×5) anomenat “warehouse” i col·loca robot_A a (1,4) i package_12 a (2,4).

Diagrama llegenda: R = robot_A, P = package_12.

Utilitzeu una graella 2D quan els agents necessiten coordenades compartides, consciència del veïnat i un moviment segur contra col·lisions.

Garantia determinista: Les seqüències idèntiques produeixen estats del món idèntics.

Escenari d’agent: Múltiples agents LLM navegant per un pis de magatzem compartit. Crides d’eines d’agent:

get_robot_position(robot_id) → consultar les coordenades actuals
plan_path(start, goal) → cerca de camins amb consciència de col·lisions
move_robot(robot_id, target_coords) → moviment atòmic i segur contra col·lisions

Asset Core proporciona un estat espacial autoritari: sense posicions fantasma, sense col·lisions i amb un historial de coordinació complet entre tots els agents.

2D Continu: Robot Workcell

Una cel·la de treball delimitada per a robòtica de recollida i col·locació. Les col·locacions utilitzen coordenades x/y de punt fix amb rotació determinista en milidegrets.

Què mostra això

Coordenades x/y de punt fix amb quantització explícita
Comprovacions de col·lisió de rectangles orientats (OBB)
Col·locacions, moviments i rotacions amb comprovació de límits
Reproducció determinista de plans de moviment multi-agent

Operacions d’exemple

{
  "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 }
      }
    }
  ]
}

Això crea una workcell ContinuousGrid2d, col·loca gripper_A a (25.000, 40.000), col·loca part_17 a (110.000, 30.000) i mou el gripper cap al objectiu.

Llegenda del diagrama: G = gripper_A, P = part_17.

Utilitzeu un contenidor continu 2D quan cal preservar les coordenades físiques i la rotació.

Garantia determinista: Les seqüències idèntiques produeixen estats del món idèntics.

Escenari d’agent:
Un planificador de robot coordinant recollides en una cel·la de treball compartida. Crides d’eina d’agent:

preflight_commit(pick_plan) → valida la seqüència sense mutació
commit(pick_plan) → executar un cop que el preflight tingui èxit
read_workcell_region(bounds) → consulta ubicacions properes per a comprovacions de col·lisió

Asset Core garanteix que el preflight i el commit es mantinguin sincronitzats mentre es preserva un rastre d’auditoria determinista.

Transferència Universal: Operacions Transdimensionals

Les operacions d’Asset Core funcionen de manera consistent entre tipus de contenidors. La mateixa gramàtica s’aplica tant si es transfereixen entre balances, slots o graelles, demostrant el model d’operació universal.

Què mostra això

Semàntica d’operació unificada a través de dimensions
Transicions d’estat entre contenidors
Registre de compromisos consistent per a fluxos de treball amb múltiples contenidors
Transformacions de l’estat del món composables

Exemple: Transferència de Balance → Reixeta 2D

Orientació addicional:

Tono: formal Registre: tècnic

Context:

domini: infraestructura blockchain
audiència: desenvolupadors i investigadors
propòsit: documentació tècnica

Restriccions:

Utilitzar un llenguatge neutral en termes de gènere
Preservar noms de marca
Mantenir l’exactitud tècnica

Preservar sense traducció:

code_blocks
inline_code
links
glossary_terms
mathematical_notation

Orientació del glossari:

Preservar aquests termes exactament: 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"
      }
    }
  ]
}

Això converteix una quantitat d’un equilibri 0D en un element col·locat en una graella 2D—mateixa gramàtica d’operació, diferents tipus de contenidors.

Els mateixos verbs (ajustar, col·locar, transferir) a través dels tipus de contenidors; l’ordenació determinista vincula ambdós canvis a una història de commits.

Escenari de l’agent: Un agent LLM transfereix parts d’un pool (equilibri 0D) a posicions d’assemblatge (reixeta 2D). Crides d’eines de l’agent:

check_parts_available() → consultar saldo
reserve_and_place(part_type, grid_coords) → operació atòmica entre contenidors

Asset Core compromet ambdós canvis de manera atòmica—sense inventari fantasma, sense peces perdudes i un registre d’auditoria unificat a través dels tipus de contenidors.

Aprendre Més

Per a detalls tècnics, consulteu Basics per a l’arquitectura i els tipus de contenidors, o la Docs per a una documentació tècnica més profunda.