Documentació

Documentació d’Asset Core

Asset Core és un motor d’execució independent del domini que tracta l’estat espacial com a objectes matemàtics de primera classe amb reproducció determinista, origen d’esdeveniments i aïllament multi-tenant.

A qui va adreçat això

Aquesta documentació serveix tres audiències principals, cadascuna amb objectius diferents i camins recomanats a través del material.

Què aprendràs

Trieu el vostre camí d’aprenentatge en funció del vostre rol i objectius.

Enginyer/a de Laboratori / Investigació

Realitzeu experiments i necessiteu fer un seguiment de mostres, reactius i posicions d’equipament amb pistes d’auditoria completes.

Lectura recomanada:

  1. Visió general per començar - Entendre els components mínims
  2. Primer Compromís i Lectura - Envia la teva primera transacció
  3. Contenidors i Actius - Apreneu sobre balances, slots i graelles
  4. Python SDK - Experimenta amb scripts de manera programàtica
  5. Receptes - Patrons comuns de múltiples operacions

Enginyer d’Aplicacions / Integració

Integreu Asset Core en aplicacions i necessiteu entendre l’API HTTP i el model de transacció.

Lectura recomanada:

  1. Visió general per començar - Fonaments de l’arquitectura del sistema
  2. Model d’execució - Món de sol-escriptor i projeccions
  3. HTTP API - Referència d’endpoint i especificació OpenAPI
  4. Transaccions - Estructura de la sol·licitud i operacions
  5. Model d’Error - Codis d’estat i gestió d’errors

Agent / Tooling Engineer

Construeixes agents d’IA que manipulen l’estat d’Asset Core mitjançant la invocació d’eines o MCP.

Lectura recomanada:

  1. Visió General dels Agents - Per què les transaccions són la superfície segura
  2. Transaccions i Operacions - El conjunt d’operacions fixes
  3. Integració MCP - servidor del Model Context Protocol
  4. Eines d’OpenAI - Integració de trucades a funcions
  5. Operacions per Domini - Referència completa d’operacions

Quan utilitzar això

Utilitzeu Asset Core quan necessiteu:

  • Gestió d’estat determinista i auditable
  • Sourcing d’esdeveniments amb capacitat de reproducció
  • Aïllament multi-tenant a escala
  • Un conjunt d’operacions segur i delimitat per a agents d’IA

Estructura de nivell alt

La documentació està organitzada en aquestes seccions:

  • Començar - Instal·lació, inici ràpid i primeres transaccions
  • Conceptes - Idees fonamentals: model d’execució, contenidors, transaccions, frescor
  • API - punts d’extrem HTTP, format de transacció, operacions, errors
  • SDK - SDK de Python i eines CLI
  • Agents - integració d’IA: adaptadors MCP, OpenAI, Gemini
  • Ops - Desplegament, comprovacions de salut i mètriques
  • Annex - Anàlisis en profunditat de l’arquitectura i convencions de la base de codi

Properes passes

Comenceu amb la Visió General d’Introducció per entendre els components del sistema, després seguiu el camí d’aprenentatge per al vostre rol.