feat: working orhcestration engine
This commit is contained in:
58
orchestration/routing.py
Normal file
58
orchestration/routing.py
Normal file
@@ -0,0 +1,58 @@
|
||||
"""Which agents a request is for (ADR-0003). It never guesses.
|
||||
|
||||
In order: the work the caller named, an agent's or a sequence's; the only agent,
|
||||
when there is one and no sequence; otherwise none, with how to name the work.
|
||||
Reading a request by Jev is step F3, added to these rules rather than in place of
|
||||
them.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from collections.abc import Mapping
|
||||
from collections.abc import Sequence as Seq
|
||||
from dataclasses import dataclass
|
||||
from typing import Any
|
||||
|
||||
from orchestration.agents import Agent, Sequence
|
||||
|
||||
WORK = "work" # the metadata field a caller names the work in
|
||||
|
||||
|
||||
@dataclass(frozen=True)
|
||||
class Decision:
|
||||
agents: tuple[Agent, ...] # in the order they work; empty when none
|
||||
reason: str
|
||||
|
||||
@property
|
||||
def agent(self) -> Agent | None:
|
||||
"""The first agent, or None when nothing is to start."""
|
||||
return self.agents[0] if self.agents else None
|
||||
|
||||
|
||||
def route(
|
||||
options: Mapping[str, Any],
|
||||
agents: Seq[Agent],
|
||||
sequences: Seq[Sequence] = (),
|
||||
) -> Decision:
|
||||
named = options.get(WORK)
|
||||
offered = ", ".join([*(a.work for a in agents), *(s.work for s in sequences)])
|
||||
if named:
|
||||
for agent in agents:
|
||||
if agent.work == named:
|
||||
return Decision((agent,), f"The caller named the work {named!r}.")
|
||||
for sequence in sequences:
|
||||
if sequence.work == named:
|
||||
return Decision(
|
||||
sequence.steps, f"The caller named the sequence {named!r}."
|
||||
)
|
||||
return Decision(
|
||||
(),
|
||||
f"No agent here does the work {named!r}. The work it can name: {offered}.",
|
||||
)
|
||||
if len(agents) == 1 and not sequences:
|
||||
return Decision((agents[0],), "It is the only agent.")
|
||||
return Decision(
|
||||
(),
|
||||
"Nothing was started: name the work this is, as `work` in the request's "
|
||||
f"metadata. The work it can name: {offered}.",
|
||||
)
|
||||
Reference in New Issue
Block a user