Una sola fonte di verità
Schema OpenAPI / Zod / proto nel vostro monorepo. Tutti i client si rigenerano a ogni cambio.
SERVIZIO · 05
Schema-Driven Dev
Contract first. Codegen ovunque. Superficie API versionata su 4 linguaggi.
Codegen per 4 linguaggi
TypeScript, Python, Go, Rust — client + server. Niente tipi scritti a mano.
Contratti versionati
Solo additivo di default. Le breaking change vengono flaggate in CI; policy di deprecation imposta.
02 · Reference architecture
What we actually ship.
Every system we build follows this shape. Client at the edge, tools in a sandbox, traces everywhere, evaluators gating output. No black boxes, no "it works on my machine."
EDGE
Client
web · mobile · API
Gateway
auth · rate-limit · redact PII
ORCHESTRAZIONE
Orchestrator
planner · router · memory
AGENTI & TOOL
Retrieval
ibrido · rerank · cite
Tool call
sandboxed · timeboxed
Evaluator
gate · rubriche · LLM-judge
DATI & FIDUCIA
Vector + BM25
isolato per tenant
Traces / log
OTel · replayabili
Output firmato
auditabile · rollback
04 · Run
Watch an agent do the job.
Three real production scenarios, replayed at observed latency. Every box is a span; every span has tokens, cost, and an eval gate. This is what shows up in your traces, not a marketing animation.
POST/api/v1/agent/runIl desk invia un block trade da €4,2M. L’agente deve rifiutare, approvare o flaggare in <3s.
trace · compliancespan_id 7c1f…
orchestrator.run
PLANorchestrator.plan
Plan rationale
La revisione pretrade richiede: regole applicabili, market data, position-check e gate deterministico.
Subtasks
retrievaltool.market_datatool.position_checkevaluator
0ms/1.82s
LATENCY0msbudget 3.00s
TOKENS0in + out
COST$0.0000budget $0.025
EVAL GATE—deterministic + LLM-judge
APPROVATO · 1 flag
Il trade passa 11 di 12 regole. Regola 23.2 (concentrazione book) flaggata per firma desk-head.
latency2.41scost$0.014tokens1,827evals12/12
09 · STACK
Modern tools, composed cleanly.
Codegen
OpenAPI, Smithy, Zod
09 · FAQ
FAQ · Schema-Driven Dev
Prezzo fisso, scoped a due settimane. Condividiamo un rate sheet su richiesta — l'obiettivo è che ve ne andiate con qualcosa di concreto (architettura + spike) indipendentemente da se proseguite con noi.
Additivo di default, con un campo `version` su ogni envelope e una policy di deprecation verificata in CI. I breaking change passano per una finestra a versioni parallele.
INIZIA
Manda live il primo sistema.
Discovery a prezzo fisso in 2 settimane. Te ne vai con architettura, spike funzionante e piano di build.