Skip to content

simple

simple

SimpleAgent — single-turn query-to-response agent (no tool calling).

Classes

SimpleAgent 

SimpleAgent(
    engine: InferenceEngine,
    model: str,
    *,
    bus: Optional[EventBus] = None,
    temperature: Optional[float] = None,
    max_tokens: Optional[int] = None,
    prompt_builder: Optional[Any] = None,
)

Bases: BaseAgent

Single-turn agent: query -> model -> response. No tool calling.

Source code in src/diapason/agents/_stubs.py 
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
def __init__(
    self,
    engine: InferenceEngine,
    model: str,
    *,
    bus: Optional[EventBus] = None,
    temperature: Optional[float] = None,
    max_tokens: Optional[int] = None,
    prompt_builder: Optional[Any] = None,
) -> None:
    self._engine = engine
    self._model = model
    self._bus = bus
    self._prompt_builder = prompt_builder

    # Three-tier resolution: explicit arg > config > class default > hardcoded
    if temperature is not None and max_tokens is not None:
        self._temperature = temperature
        self._max_tokens = max_tokens
    else:
        try:
            cfg = load_config()
            self._temperature = (
                temperature
                if temperature is not None
                else cfg.intelligence.temperature
            )
            self._max_tokens = (
                max_tokens
                if max_tokens is not None
                else cfg.intelligence.max_tokens
            )
        except Exception:
            self._temperature = (
                temperature
                if temperature is not None
                else getattr(self, "_default_temperature", 0.7)
            )
            self._max_tokens = (
                max_tokens
                if max_tokens is not None
                else getattr(self, "_default_max_tokens", 1024)
            )
Methods:
run 
run(
    input: str,
    context: Optional[AgentContext] = None,
    **kwargs: Any,
) -> AgentResult

Single-turn: build messages, call engine, return result.

Source code in src/diapason/agents/simple.py 
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
def run(
    self,
    input: str,
    context: Optional[AgentContext] = None,
    **kwargs: Any,
) -> AgentResult:
    """Single-turn: build messages, call engine, return result."""
    self._emit_turn_start(input)

    messages = self._build_messages(input, context)
    result = self._generate(messages)
    content = result.get("content", "")

    self._emit_turn_end(content_length=len(content))

    return AgentResult(content=content, turns=1)