Model Agent Mental States from RDF Context
Transforms RDF context into formal BDI mental states - beliefs, desires, intentions - for explainable multi-agent reasoning.
Why it matters
Transform external RDF context into structured agent beliefs, desires, and intentions (BDI) for enhanced cognitive reasoning and explainability in multi-agent systems.
Outcomes
What it gets done
Process RDF context into agent beliefs about world states.
Model rational agency with perception, deliberation, and action cycles.
Enable explainability through traceable reasoning chains.
Augment LLMs with formal cognitive structures for Logic Augmented Generation.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/ag-bdi-mental-states | bash Overview
BDI Mental State Modeling
Transforms external RDF context into formal BDI (Belief-Desire-Intention) mental states using ontology patterns - Turtle triples linking beliefs, desires, intentions, plans, justifications, and time intervals - so agents reason through an explicit, explainable cognitive architecture instead of opaque state. Use it when processing RDF context into agent beliefs, implementing BDI frameworks (SEMAS, JADE, JADEX), augmenting an LLM with formal ontological constraints, coordinating mental states across multi-agent platforms, or when reasoning needs a traceable, queryable justification chain.
What it does
BDI Mental State Modeling transforms external RDF context into an agent's mental states - beliefs, desires, and intentions - using formal BDI (Belief-Desire-Intention) ontology patterns expressed as Turtle triples. Mental states are modeled as persistent "endurants" (bdi:Belief, bdi:Desire, bdi:Intention), while the events that change them are "perdurants" (BeliefProcess, DesireProcess, IntentionProcess), following DOLCE-style ontology conventions. A cognitive chain links them: a belief motivates a desire, a desire is fulfilled by an intention, and an intention specifies a plan grounded in a world state - all queryable and cross-referenced via bidirectional properties like motivates/isMotivatedBy.
When to use - and when NOT to
Use it when processing external RDF context into agent beliefs about world state, modeling rational agency through perception-deliberation-action cycles, implementing an actual BDI framework (SEMAS, JADE, JADEX), augmenting an LLM with formal cognitive structure via Logic Augmented Generation, coordinating mental states across multi-agent platforms, tracking how beliefs/desires/intentions evolve over time, or linking motivational states to concrete action plans. It's specifically for systems that need explainability through traceable reasoning chains and semantic interoperability - not for lightweight agent state that doesn't need to be queried, justified, or shared across a multi-agent platform.
Inputs and outputs
Input is external RDF/world-state context (e.g. a push notification, a scheduled meeting); output is a set of interlinked BDI ontology instances. World states ground mental states via bdi:perceives/bdi:refersTo; intentions specify plans (bdi:specifies) that address goals through ordered tasks (bdi:precedes). The T2B2T (Triples-to-Beliefs-to-Triples) pattern implements bidirectional flow: external context triggers a BeliefProcess that generates a belief (Phase 1), and mental deliberation later produces new RDF output via a PlanExecution that brings about a new world state (Phase 2). Every mental entity can carry a bdi:isJustifiedBy link to supporting evidence for explainability, and a bdi:hasValidity time interval so a SPARQL query can retrieve which mental states were active at a specific moment. Complex beliefs decompose into parts (bdi:hasPart) for selective updates - e.g. updating only a meeting's location without touching its time.
Integrations
The skill maps to C4 architecture levels with specific notations (ArchiMate for context/container levels, UML for component level, UML/RDF for code-level belief/desire/intention classes), integrates with Logic Augmented Generation by serializing the ontology as Turtle context prepended to an LLM prompt and validating extracted triples against it, and can translate BDI ontology into executable SEMAS production rules (belief triggers desire formation, desire triggers intention commitment) for frameworks like JADE/JADEX.
Who it's for
Developers building multi-agent systems that need formally explainable, semantically interoperable agent reasoning - traceable belief-to-action chains, temporal state queries, and cross-platform mental-state coordination - rather than an agent's internal state being an opaque black box.
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.