Agents Visió General
Asset Core proporciona adaptadors llestos per a la producció per a la integració d’agents d’IA, permetent que els models manipulin l’estat a través d’un conjunt d’operacions delimitat i auditable. L’objectiu és permetre que l’automatització actuï de manera segura sense expandir la superfície d’atac ni trencar la reproducció determinista.
Qui és per a això
Enginyers que construeixen agents d’IA que necessiten interactuar amb l’estat d’Asset Core a través d’una interfície unificada basada en eines. Si esteu integrant amb MCP, OpenAI o Gemini, aquesta pàgina és el punt de partida conceptual.
Què aprendràs
- Per què el conjunt d’operacions fixes d’Asset Core és ideal per a agents
- Com la superfície d’eines canòniques es mapa a HTTP
- On trobar les definicions i esquemes complets de les eines
Paquet d’Informació LLM
Necessites un fitxer únic i detallat que puguis pujar al teu propi LLM? El paquet de briefing de l’Asset Core LLM cobreix el model mental complet, la lògica de mapeig, les garanties i l’orientació sobre l’ajust. És només en anglès (la majoria dels LLM gestionen bé l’anglès) i experimental; la font canònica de veritat és el lloc web. Utilitza-ho com a guia, no com a font de registre. La intenció és l’exploració autodirigida: puja-ho, descriu el teu domini i deixa que el model mapegi l’Asset Core al teu cas d’ús. També pots proporcionar a un agent les URL canòniques: https://assetcore.io/ o https://assetcore.io/docs (CSP estricte, sense seguiment), però no es garanteix que cada pàgina sigui visitada, així que aquest paquet manté les matemàtiques bàsiques, les restriccions i l’orientació en la presa de decisions en un sol lloc.
- Obrir: Asset Core LLM Briefing Pack (17.5 KB, només en anglès)
- Descarregar: Asset Core LLM Briefing Pack (.md) (17.5 KB, només en anglès)
Quan utilitzar això
Utilitzeu Asset Core com a backend d’estat del vostre agent quan necessiteu:
- Auditoria: Cada canvi d’estat és registrat
- Seguretat: Les operacions limitades prevenen mutacions perilloses
- Determinisme: Comportament reproductible per a proves i depuració
Estructura de nivell alt
El problema amb les APIs obertes
Els agents d’IA poden executar accions arbitràries, cosa que crea riscos. Sense un conjunt d’operacions delimitat, l’auditoria i la reversió esdevenen una conjectura.
- Les mutacions il·limitades poden corrompre l’estat
- No hi ha un registre d’auditoria per a què ha canviat
- Difícil de provar i verificar el comportament
- Difícil de restringir permisos
Transaccions com a Superfície Segura
Asset Core resol això exposant exactament 24 operacions. El vocabulari fix fa que l’accés automatitzat sigui revisable i aplicable.
| Domain | Operations |
|---|---|
| Container | CreateContainer, RemoveContainer |
| Balance | AddFungible, RemoveFungible, MoveFungible, TransferFungible, TransferMany, Distribute, MoveMany, MergeStacks, ConsolidateStacks |
| Instance | AddInstance, MoveInstance, RemoveInstance, BurnInstance, Attach, Detach |
| Slot | PlaceInSlot, RemoveFromSlot, SwapSlots |
| Schema | RegisterClass, RegisterClassShape, RegisterClassContinuousShape1d, RegisterClassContinuousShape2d |
Aquesta vocabulari fixa:
- Limita el radi d’explosió: Els agents només poden fer aquestes coses
- Habilita l’auditoria: Cada acció possible és coneguda
- Suporta permisos: Filtra operacions per etiqueta
- Simplifica les proves: Espai d’estats finit
Adaptadors de Protocols
Asset Core proporciona adaptadors que tradueixen entre protocols d’IA i HTTP. Això manté la superfície d’eines estable fins i tot a mesura que els protocols d’IA evolucionen.
Agent → Adapter → HTTP API → Daemon
Adaptadors disponibles:
| Protocol | Descripció | Transport |
|---|---|---|
| MCP | Model Context Protocol | STDIO, SSE |
| OpenAI | Crida de funcions | HTTP |
| Gemini | Declaracions de funcions | HTTP |
Tots els adaptadors exposen la mateixa superfície d’eina, per la qual cosa canviar de protocols no requereix canviar la vostra integració d’Asset Core.
Arquitectura d’Adaptador
Cada adaptador proporciona:
- Definicions d’eines que coincideixen amb l’esquema del protocol
- Executor que mapeja les crides d’eines a sol·licituds HTTP
- Client HTTP per a la comunicació amb el daemon
- Gestió d’errors amb respostes adequades al protocol
Els adaptadors viuen al crate assetcore-adapters i comparteixen infraestructura comuna.
Inventari d’Eines
Eines estàndard a través de tots els adaptadors:
| Eina | Descripció |
|---|---|
assetcore_commit | Enviar transaccions al daemon d’escriptura |
assetcore_write_health | Comprovar la salut del daemon d’escriptura |
assetcore_read_health | Comprovar la salut del daemon de lectura |
assetcore_read_freshness | Comprovar la frescor de la projecció |
assetcore_read_stream | Transmetre compromisos amb cursors SSE |
assetcore_list_containers | Llistar contenidors amb filtres |
assetcore_get_container_contents | Consulta unificada del contingut del contenidor |
assetcore_docs_search | Cercar documentació estàtica d’Asset Core |
tools/list | Punt d’entrada per a la descoberta d’eines MCP |
L’eina de commit accepta la mateixa estructura d’operació que l’API HTTP, de manera que els agents poden compondre transaccions complexes.
Filtratge per Etiquetes
Les operacions tenen etiquetes (domini, acció, abast, reversibilitat) que permeten filtrar:
# Allow only read operations
allowed = [op for op in operations if op.action != "destroy"]
# Restrict to specific domains
allowed = [op for op in operations if op.domain in ["balance", "container"]]
Això et permet construir agents amb diferents nivells de permís sense canviar el sistema central.
Properes passes
- Tooling Guide - Definicions d’eines canòniques
- Tooling Manifest - Metadades d’eines llegibles per màquina
- Acció de Referència - Referència completa de l’operació