Documentació d'Asset Core

Documentació del motor d'estat del món determinista i referències de l'API.

Decision Gate docs

Pila de Raonament de l’Agent

Aquesta pàgina resumeix la pila de raonament de quatre capes que proporcionem als agents durant les execucions d’Asset Core, de manera que les decisions es mantinguin deterministes, auditable i alineades amb el catàleg d’operacions.

Pensa-hi com la visió operativa del model mental introduït a la Visió general dels documents i Conceptes.

Cada capa és intencionadament estreta: l’agent només necessita la capa que coincideix amb la pregunta actual.

El corpus de raonament complet és un conjunt de documents viu; els manifestos d’escenari fixen la revisió exacta utilitzada per a qualsevol paquet d’execució.

Les quatre capes

1) Raonament (Capa Conceptual)

Defineix el model del món i les invariants: espais de noms, contenidors, determinisme i regles de punt fix.

  • Enfocament: per què el sistema es comporta com ho fa.
  • Sortides: invariants que mai s’han de violar.

2) Ontologia (Tipus d’Entitats i Fungibilitat)

Defineix què existeix: classes, instàncies, quantitats fungibles, i quins tipus de contenidors poden contenir-les.

  • Enfocament: què volen dir les entitats i contenidors.
  • Sortides: representacions vàlides per a les entitats d’un domini.

3) Decisió (Selecció d’Eines)

Les mapes d’intenció a lectures, escriptures i regles de gestió d’errors concretes.

  • Enfocament: quina eina o operació cridar a continuació.
  • Sortides: un pla de compromís segur i lectures prèvies requerides.

4) Patró (Manual Operatiu)

Transforma les decisions en seqüències pas a pas amb comprovacions de verificació.

  • Enfocament: com executar correctament fluxos de treball comuns.
  • Sortides: seqüències de compromís i passos de verificació.

Com s’utilitza la pila

Els agents passen de la intenció a l’acció caminant per la pila en ordre.

  1. Raonament: validar invariants i suposicions del model.
  2. Ontologia: triar la representació d’entitats i els tipus de contenidors.
  3. Decisió: triar eines i estructurar el compromís.
  4. Patró: executar i verificar.

Què rep l’agent

Per a les execucions de l’escenari, proporcionem els quatre documents següents més la Referència d’Acció i el Manifest d’Eines.

Aquests guies descarregables són instantànies de les execucions de producció. Poden estar desactualitzades respecte a la documentació actual i no són normatives; utilitzeu la Referència d’Acció i el Manifest d’Eines per al contracte canònic.

Com llegir la pila

Si ets nou, llegeix Raonament, després Ontologia, després Decisió, i acaba amb el Playbook.

Si esteu diagnosticant una execució, salteu a la capa que coincideix amb el mode de fallada i verifiqueu les restriccions circumdants.

Notes de legitimitat

Els registres de manifestos d’escenaris enregistren el SHA de compromís per al corpus de raonament utilitzat durant l’execució, de manera que els lectors poden inspeccionar les entrades exactes que l’agent va veure, fins i tot a mesura que els documents evolucionen.