feat: working orhcestration engine
This commit is contained in:
68
orchestration/agents.py
Normal file
68
orchestration/agents.py
Normal file
@@ -0,0 +1,68 @@
|
||||
"""The agents the Orchestration engine routes to, and the sequences of them, from
|
||||
configuration."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from dataclasses import dataclass
|
||||
from pathlib import Path
|
||||
|
||||
import yaml
|
||||
|
||||
|
||||
@dataclass(frozen=True)
|
||||
class Agent:
|
||||
"""One kind of work, and the agent that does it."""
|
||||
|
||||
work: str # what a caller names: "operating_model", "solution_architecture"
|
||||
url: str # the agent's base URL; its card says where its A2A interface is
|
||||
description: str = ""
|
||||
|
||||
|
||||
@dataclass(frozen=True)
|
||||
class Sequence:
|
||||
"""Work done by agents in turn: each one's files are the next one's sources."""
|
||||
|
||||
work: str # what a caller names: "architecture_and_operating_model"
|
||||
steps: tuple[Agent, ...]
|
||||
description: str = ""
|
||||
|
||||
|
||||
def load_routes(path: str | Path) -> tuple[list[Agent], list[Sequence]]:
|
||||
"""The agents and the sequences in `path`, in the order written. One agent or
|
||||
sequence per kind of work; a sequence names only agents configured here."""
|
||||
raw = yaml.safe_load(Path(path).read_text(encoding="utf-8")) or {}
|
||||
agents = [
|
||||
Agent(
|
||||
work=str(entry["work"]),
|
||||
url=str(entry["url"]).rstrip("/"),
|
||||
description=str(entry.get("description") or ""),
|
||||
)
|
||||
for entry in raw.get("agents") or []
|
||||
]
|
||||
by_work = {agent.work: agent for agent in agents}
|
||||
sequences: list[Sequence] = []
|
||||
for entry in raw.get("sequences") or []:
|
||||
unknown = [str(step) for step in entry["steps"] if str(step) not in by_work]
|
||||
if unknown:
|
||||
raise ValueError(
|
||||
f"The sequence {entry['work']!r} names no configured agent for "
|
||||
+ ", ".join(repr(step) for step in unknown)
|
||||
)
|
||||
sequences.append(
|
||||
Sequence(
|
||||
work=str(entry["work"]),
|
||||
steps=tuple(by_work[str(step)] for step in entry["steps"]),
|
||||
description=str(entry.get("description") or ""),
|
||||
)
|
||||
)
|
||||
seen: set[str] = set()
|
||||
for work in [*(a.work for a in agents), *(s.work for s in sequences)]:
|
||||
if work in seen:
|
||||
raise ValueError(f"Two agents are configured for the work {work!r}")
|
||||
seen.add(work)
|
||||
return agents, sequences
|
||||
|
||||
|
||||
def load_agents(path: str | Path) -> list[Agent]:
|
||||
"""The agents in `path`, without its sequences."""
|
||||
return load_routes(path)[0]
|
||||
Reference in New Issue
Block a user