Visión general de agentes
Asset Core proporciona adaptadores listos para producción para la integración de agentes de IA, permitiendo que los modelos manipulen el estado a través de un conjunto de operaciones limitado y auditable. El objetivo es permitir que la automatización actúe de manera segura sin expandir la superficie de ataque o romper la reproducción determinista.
Para quién es esto
Ingenieros que construyen agentes de IA que necesitan interactuar con el estado de Asset Core a través de una interfaz unificada basada en herramientas. Si está integrando con MCP, OpenAI o Gemini, esta página es el punto de partida conceptual.
Lo que aprenderás
- Por qué el conjunto de operaciones fijas de Asset Core es ideal para agentes
- Cómo la superficie de herramientas canónicas se mapea a HTTP
- Dónde encontrar las definiciones y esquemas completos de las herramientas
Paquete de Información de LLM
¿Necesita un archivo único y detallado que pueda cargar en su propio LLM? El Paquete de Información del LLM de Asset Core cubre el modelo mental completo, la lógica de mapeo, las garantías y la orientación sobre el ajuste. Es solo en inglés (la mayoría de los LLM manejan bien el inglés) y experimental; la fuente canónica de verdad es el sitio web. Úselo como guía, no como fuente de registro. La intención es la exploración autodirigida: cárguelo, describa su dominio y deje que el modelo mapee Asset Core a su caso de uso. También puede dar a un agente las URL canónicas: https://assetcore.io/ o https://assetcore.io/docs (CSP estricto, sin seguimiento), pero no se garantiza que se visite cada página, por lo que este paquete mantiene las matemáticas fundamentales, las restricciones y la orientación de decisiones en un solo lugar.
- Abierto: Paquete de Información de LLM de Asset Core (17.5 KB, solo en inglés)
- Descargar: Asset Core LLM Briefing Pack (.md) (17.5 KB, solo en inglés)
Cuándo usar esto
Utilice Asset Core como el backend de estado de su agente cuando necesite:
- Auditoría: Cada cambio de estado es registrado
- Seguridad: Las operaciones acotadas previenen mutaciones peligrosas
- Determinismo: Comportamiento reproducible para pruebas y depuración
Estructura de alto nivel
El Problema con las API Abiertas
Los agentes de IA pueden ejecutar acciones arbitrarias, lo que crea riesgos. Sin un conjunto de operaciones limitado, la auditoría y la reversión se convierten en conjeturas.
- Las mutaciones no limitadas pueden corromper el estado
- No hay un rastro de auditoría para lo que cambió
- Difícil de probar y verificar el comportamiento
- Difícil de restringir permisos
Transacciones como Superficie Segura
Asset Core resuelve esto al exponer exactamente 24 operaciones. El vocabulario fijo hace que el acceso automatizado sea revisable y exigible.
| Dominio | Operaciones |
|---|---|
| Contenedor | CreateContainer, RemoveContainer |
| Balance | AddFungible, RemoveFungible, MoveFungible, TransferFungible, TransferMany, Distribute, MoveMany, MergeStacks, ConsolidateStacks |
| Instancia | AddInstance, MoveInstance, RemoveInstance, BurnInstance, Attach, Detach |
| Ranura | PlaceInSlot, RemoveFromSlot, SwapSlots |
| Esquema | RegisterClass, RegisterClassShape, RegisterClassContinuousShape1d, RegisterClassContinuousShape2d |
Este vocabulario fijo:
- Limita el radio de explosión: Los agentes solo pueden hacer estas cosas
- Habilita la auditoría: Se conoce cada acción posible
- Soporta permisos: Filtrar operaciones por etiqueta
- Simplifica las pruebas: Espacio de estado finito
Adaptadores de Protocolo
Asset Core proporciona adaptadores que traducen entre protocolos de IA y HTTP. Esto mantiene la superficie de herramientas estable incluso a medida que los protocolos de IA evolucionan.
Agent → Adapter → HTTP API → Daemon
Adaptadores disponibles:
| Protocolo | Descripción | Transporte |
|---|---|---|
| MCP | Protocolo de Contexto de Modelo | STDIO, SSE |
| OpenAI | Llamadas a funciones | HTTP |
| Gemini | Declaraciones de funciones | HTTP |
Todos los adaptadores exponen la misma superficie de herramientas, por lo que cambiar de protocolos no requiere modificar su integración con Asset Core.
Arquitectura del Adaptador
Cada adaptador proporciona:
- Definiciones de herramientas que coinciden con el esquema del protocolo
- Ejecutor que mapea las llamadas a herramientas a solicitudes HTTP
- Cliente HTTP para comunicación con el daemon
- Manejo de errores con respuestas apropiadas al protocolo
Los adaptadores viven en el assetcore-adapters crate y comparten infraestructura común.
Inventario de Herramientas
Herramientas estándar en todos los adaptadores:
| Herramienta | Descripción |
|---|---|
assetcore_commit | Enviar transacciones al daemon de escritura |
assetcore_write_health | Comprobar la salud del daemon de escritura |
assetcore_read_health | Comprobar la salud del daemon de lectura |
assetcore_read_freshness | Comprobar la frescura de la proyección |
assetcore_read_stream | Transmitir commits con cursores SSE |
assetcore_list_containers | Listar contenedores con filtros |
assetcore_get_container_contents | Consulta unificada de contenidos de contenedores |
assetcore_docs_search | Buscar documentación estática de Asset Core |
tools/list | Punto de descubrimiento de herramientas MCP |
La herramienta de commit acepta la misma estructura de operación que la API HTTP, por lo que los agentes pueden componer transacciones complejas.
Filtrado por Etiquetas
Las operaciones tienen etiquetas (dominio, acción, alcance, reversibilidad) que permiten el filtrado:
# 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"]]
Esto te permite construir agentes con diferentes niveles de permiso sin cambiar el sistema central.
Próximos pasos
- Guía de Herramientas - Definiciones canónicas de herramientas
- Tooling Manifest - Metadatos de herramientas legibles por máquina
- Referencia de Acción - Referencia completa de operaciones