The Orchestration engine keeps every completed agent Execution it relays, by tenant, Customer case and Execution, and serves its record and files at signed, expiring links. A KAB workflow step, which takes one output per step, is given one JSON document of links (`deliver: links`); other callers still get each file, and what they are given is kept either way. - store.py, links.py, delivery.py, serving.py; the relay keeps and links - the card declares `deliver`, `sources` and an output schema - image: STORE_DIR on a /data volume; PUBLIC_URL and LINK_SECRET settings - option 1's tests replaced by tests of the links document Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
41 lines
1.6 KiB
Python
41 lines
1.6 KiB
Python
"""The Orchestration engine's settings, from the environment or `.env`."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from pydantic_settings import BaseSettings, SettingsConfigDict
|
|
|
|
|
|
class OrchestrationSettings(BaseSettings):
|
|
model_config = SettingsConfigDict(
|
|
env_file=".env", env_file_encoding="utf-8", extra="ignore"
|
|
)
|
|
|
|
AGENT_NAME: str = "orchestration_engine"
|
|
AGENT_VERSION: str = "0.1.0"
|
|
LOG_LEVEL: str = "INFO"
|
|
|
|
A2A_HOST: str = "0.0.0.0"
|
|
A2A_PORT: int = 8080
|
|
A2A_PUBLIC_URL: str | None = None
|
|
|
|
# The agents it routes to: a YAML file of `agents: [{work, url, description}]`.
|
|
AGENTS_FILE: str = "agents.yaml"
|
|
# While an agent works, report that it still is at this interval, so a caller
|
|
# that takes a silent stream for a dead one does not retry (ADR-0003).
|
|
HEARTBEAT_SECONDS: float = 60
|
|
# How long to wait to connect to an agent. Reading waits as long as the
|
|
# agent's work takes.
|
|
CONNECT_TIMEOUT_SECONDS: float = 10
|
|
|
|
# What agents deliver is kept here and served at signed links (ADR-0004).
|
|
# Unset: nothing is kept, and a caller asking for links gets none.
|
|
STORE_DIR: str | None = None
|
|
# The base of every link: the address a browser reaches this service at, which
|
|
# is not its address inside the platform's network. Unset: A2A_PUBLIC_URL.
|
|
PUBLIC_URL: str | None = None
|
|
# The secret links are signed with. Unset: one is made at start-up, and links
|
|
# stop working when the service restarts.
|
|
LINK_SECRET: str | None = None
|
|
# How long a link works; 0 for always.
|
|
LINK_TTL_SECONDS: int = 30 * 24 * 3600
|