From 4cf1e5aaf73c51bf9605ca872e2b319d388214aa Mon Sep 17 00:00:00 2001 From: Storm Date: Tue, 21 Oct 2025 12:33:47 +0200 Subject: [PATCH] docs: added docstrings to bdi_core and BeliefSetter behaviour ref: N25B-197 --- src/control_backend/agents/bdi/bdi_core.py | 5 ++++- src/control_backend/agents/bdi/behaviours/belief_setter.py | 5 ++++- 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/src/control_backend/agents/bdi/bdi_core.py b/src/control_backend/agents/bdi/bdi_core.py index d0c8b6c..69fb5e5 100644 --- a/src/control_backend/agents/bdi/bdi_core.py +++ b/src/control_backend/agents/bdi/bdi_core.py @@ -7,7 +7,10 @@ from control_backend.agents.bdi.behaviours.belief_setter import BeliefSetter class BDICore(BDIAgent): """ - TODO: docs + This is the Brain agent that does the belief inference with AgentSpeak. + This is a continous process that happens automatically in the background. + This class contains all the actions that can be called from AgentSpeak plans. + It has the BeliefSetter behaviour. """ logger = logging.getLogger("BDI Core") diff --git a/src/control_backend/agents/bdi/behaviours/belief_setter.py b/src/control_backend/agents/bdi/behaviours/belief_setter.py index c8d4c2e..777dda3 100644 --- a/src/control_backend/agents/bdi/behaviours/belief_setter.py +++ b/src/control_backend/agents/bdi/behaviours/belief_setter.py @@ -10,10 +10,13 @@ from control_backend.core.config import settings class BeliefSetter(CyclicBehaviour): """ - TODO: docs + This is the behaviour that the BDI agent runs. + This behaviour waits for incoming message and processes it based on sender. + Currently, t only waits for messages containing beliefs from Belief Collector and adds these to its KB. """ agent: BDIAgent logger = logging.getLogger("BDI/Belief Setter") + async def run(self): msg = await self.receive(timeout=0.1) if msg: