Components

PieceRole
RouterSelects agent paths and delegation (dynamic_agent_router.py).
NPC agentsCharacter agents and tool wiring (dynamic_npc_agent.py and related).
Factory / servicesBuilds and runs agent lifecycles (dynamic_agent_factory.py, dynamic_agent_service.py).

Runtime context realism

dynamic_npc_agent.py injects runtime context from org-admin configuration and live org data:
  • organization timezone, local date/time, office hours, and business days
  • upcoming meetings (organization/user scoped where available)
  • open task deadlines for the active user in DM/channel flows
Keep this path aligned with Simulation Admin settings so agent behavior matches the configured workplace calendar.

Tools

Tool modules connect model-chosen actions to application APIs (src/core/autogen/tools.py, task_tools.py, and others). If you change a tool’s contract, update prompts, validation, and safety checks together.

Observability

Agent activity is logged through src/core/autogen_logger.py. Align log content and retention with customer agreements and privacy policy.