Skip to content

Workspace, project, call

Term Meaning
Call One LLM-backed function being replaced, e.g. route_rfi. Has its own versions, threshold, mode and metrics.
Project Named group of calls sharing a pipeline and data source, e.g. autoresponse.
Workspace Top-level container: registry location, secrets, telemetry, scheduler. Usually one per team or environment (dev, prod).
Path workspace/project/call, e.g. prod/autoresponse/route_rfi. Used in storage keys, the CLI and audit packs.

pecca.replace("route_rfi") with no project uses the implicit workspace default and project default, like logging.getLogger(). Set PECCA_WORKSPACE to change the default workspace; then project/call is enough on the CLI.

Pecca keeps only its own metadata. Models and call state live in the workspace registry (local://./.pecca by default, or MLflow / Unity Catalog / W&B).

.pecca/<workspace>/<project>/<call>/
  state.json   versions/vN/   logs/YYYY-MM-DD.jsonl   audit/vN/