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 limitat i auditable.
A qui va adreçat això
Enginyers que construeixen agents d’IA que necessiten interactuar amb l’estat d’Asset Core, ja sigui a través de MCP, la crida de funcions d’OpenAI o eines de Gemini.
Què aprendràs
- Per què el conjunt d’operacions fixes d’Asset Core és ideal per a agents
- Com els adaptadors de protocol tradueixen les trucades d’eines a HTTP
- Quin adaptador triar per al vostre cas d’ú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, la qual cosa crea riscos:
- 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 16 operacions:
| Domini | Operacions |
|---|---|
| Contenidor | CrearContenidor, EliminarContenidor |
| Balanç | AfegirFungible, EliminarFungible, TransferirFungible, FusionarPiles, ConsolidarPiles |
| Instància | MuntarInstància, CremarInstància, Adjuntar, Desadjuntar |
| Slot | Col·locarEnSlot, TreureDeSlot, IntercanviarSlots |
| Esquema | RegistrarClasse, RegistrarFormaClasse |
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:
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ó |
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
- Integració MCP - Configura el servidor MCP
- Eines d’OpenAI - Integració de trucades a funcions
- Gemini - Ús de l’adaptador Gemini
- Operacions per Domini - Referència completa d’operacions