[WIP] Removed Several Abstractions and Enabled Lighter Durable Agents and Orchestrators

[Cyb3rWard0g]

No description provided.

[sicoyle]

overall really liking where this is going 🙌 - few comments so far high level for ya :) any chance you could add some tests?

[sicoyle]

Suggested change

[sicoyle]

add gandalf? shall we just combine this quickstart with the 05 one instead of adding a new quickstart?

[Cyb3rWard0g]

Yeah I was just trying to keep it separate to not mess with the other ones for now 😅.

[sicoyle]

add gandalf?

[sicoyle]

I'm not sure we need the _config suffixes here on the field names

[Cyb3rWard0g]

Oh you mean on the attributes of the class? I was thinking about the same thing too. What do you think? I think it would be cleaner ;) I am fine with renaming those without the suffix.

[sicoyle]

oooooo - what are modules for?

[Cyb3rWard0g]

I was testing this. I implemented it, but forgot to add more documentation :( . Modules are a plugin/extensibility system for dynamically adding prompt sections to agents. They work through a registry pattern that allows you to compose agent prompts from reusable, configurable components.

How Modules Work

The modules system has three key components:

1. PROMPT_MODULE_REGISTRY - A global dictionary mapping module names to factory functions
2. register_prompt_module() - Function to register new modules globally
3. Module resolution logic - Processes modules when building agent prompts

When an agent is created with modules, the system:

1. Checks if there's a module_override for that module name
2. If not, looks up the factory function in the registry
3. Calls the factory to generate a PromptSection
4. Injects these sections into the agent's system prompt

Current State: Fully Implemented

• PromptSection is defined in dapr_agents/agents/configs.py
• AgentProfileConfig has both modules and module_overrides fields
• The processing logic in prompting.py handles module resolution

Usage Example

Here's how to use modules in your agent configuration:

from dapr_agents.agents.configs import (
    AgentProfileConfig,
    PromptSection,  # Add this import
)

sam_profile = AgentProfileConfig(
    name="Samwise Gamgee",
    role="Logistics, Provisions & Morale",
    goal="Keep the party supplied, rested, and on schedule...",
    instructions=[
        "Track food, water, camp gear, and rest cadence; flag shortages early.",
        # ... more instructions
    ],
    style_guidelines=[
        "Warm, plain-spoken, and grounded.",
        # ... more guidelines
    ],
    # Declare which modules you want
    modules=("supplies", "campcraft"),
    # Provide inline implementations (no global registration needed)
    module_overrides={
        "supplies": PromptSection(
            title="Supply Management",
            lines=[
                "Track current inventory of food, water, and camp gear.",
                "Monitor daily consumption rates and estimate days remaining.",
                "Flag low supplies before they become critical (2-day threshold).",
                "Suggest resupply opportunities at settlements or natural resources.",
            ]
        ),
        "campcraft": PromptSection(
            title="Campsite Selection Protocol",
            lines=[
                "Evaluate proximity to water (within 100m), natural concealment, and defensibility.",
                "Consider current weather conditions and terrain protection.",
                "Identify at least two emergency escape routes from the camp location.",
                "Balance safety requirements with rest quality and party morale needs.",
            ]
        ),
    }
)

Without modules, Sam's system prompt contains:

• Name: "Samwise Gamgee"
• Role: "Logistics, Provisions & Morale"
• Goal: (goal text)
• Primary Instructions: (instruction list)
• Communication Style: (style guidelines)

With the modules above, Sam's system prompt gets additional sections:

Supply Management:
- Track current inventory of food, water, and camp gear.
- Monitor daily consumption rates and estimate days remaining.
- Flag low supplies before they become critical (2-day threshold).
- Suggest resupply opportunities at settlements or natural resources.

Campsite Selection Protocol:
- Evaluate proximity to water (within 100m), natural concealment, and defensibility.
- Consider current weather conditions and terrain protection.
- Identify at least two emergency escape routes from the camp location.
- Balance safety requirements with rest quality and party morale needs.