Definitie
Architectuur en interfaces Architectuur en interfaces definiëren de belangrijkste componenten van een systeem, de verantwoordelijkheden die aan elke component zijn toegewezen en de contracten die ze verbinden. In AI‑software omvat dit het isoleren van modelaanroepen, retrieval, prompts, tools, datapijplijnen, beleidscontroles en menselijke beoordeling achter expliciete API’s, zodat gedrag kan worden getest, geobserveerd, vervangen en bestuurd.
Architectuur legt impactvolle structurele beslissingen vast: grenzen, componenten, integratie, datastroom, deployment en kwaliteitsattributen. Architectuur moet modelvervanging en workflow‑evolutie mogelijk maken.
API‑ en contractontwerp definieert stabiele interfaces, schema’s, validatie, fouten, idempotentie en versiebeheer. Toolcontracten voor agents zijn API’s en verdienen dezelfde discipline.
Engineeringmodus
Architectuur en interfaces maken AI‑systemen bestuurbaar. Modelaanroepen, retrieval, tools, beleid en opslag moeten expliciete contracten, eigenaarschap en faalgedrag hebben. Het ontwerp moet zichtbaar maken wat gebruikers kunnen vertrouwen of corrigeren. Bij het bouwen gaat de voorkeur uit naar vervangbare componenten en getypeerde grenzen. Operations monitort elke grens afzonderlijk. Het risico is dat je het productgedrag direct koppelt aan een prompt of leveranciers‑API zonder controlepunten.
Evaluatiecheck
Vraag welk observeerbaar bewijs zou aantonen dat dit concept goed is toegepast in een echt systeem, een repository of een leeropdracht.
Praktijkvoorbeeld
Een productie‑RAG‑assistent scheidt vaak de chat‑UI, de retrievalservice, de model‑gateway, beleidscontroles en auditlogging. Duidelijke interfaces stellen teams in staat retrieval te testen zonder de UI, modelproviders te wisselen, permissies centraal af te dwingen en uit te leggen welk bewijs een gegenereerd antwoord ondersteunde.
Gerelateerde concepten
Verder lezen: Len Bass, Paul Clements en Rick Kazman, Software Architecture in Practice , en Martin Fowler, Software Architecture Guide .
