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.
A quién va dirigido esto
Ingenieros construyendo agentes de IA que necesitan interactuar con el estado de Asset Core, ya sea a través de MCP, llamadas a funciones de OpenAI o herramientas de Gemini.
Lo que aprenderás
- Por qué el conjunto de operaciones fijas de Asset Core es ideal para agentes
- Cómo los adaptadores de protocolo traducen las llamadas de herramientas a HTTP
- Qué adaptador elegir para su caso de uso
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:
- 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 16 operaciones:
| Dominio | Operaciones |
|---|---|
| Contenedor | CrearContenedor, EliminarContenedor |
| Balance | AgregarFungible, EliminarFungible, TransferirFungible, FusionarPilas, ConsolidarPilas |
| Instancia | CrearInstancia, QuemarInstancia, Adjuntar, Desadjuntar |
| Ranura | ColocarEnRanura, EliminarDeRanura, IntercambiarRanuras |
| Esquema | RegistrarClase, RegistrarFormaClase |
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:
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 |
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
- Integración MCP - Configurar el servidor MCP
- OpenAI Tools - Integración de llamadas a funciones
- Gemini - Uso del adaptador Gemini
- Operaciones por Dominio - Referencia completa de operaciones