Bouwen met AI

Van één prompt naar drie leveringsvarianten, in minder dan tien minuten.

De REST API en Python SDK van Sympheny zijn volledig gedocumenteerd, zodat een AI-assistent of coding agent een project kan opzetten, scenariovarianten kan aanmaken en een optimalisatierun kan starten. Wat er aan de andere kant uitkomt, verandert niet: dezelfde deterministische MILP-engine lost het model op, of een mens of een agent het nu heeft samengesteld.

Een assistent zet het model op. Sympheny lost het op.

Walkthrough van 40 seconden (in het Engels)

Één prompt, drie leveringsvarianten — gasketel, warmtepomp met zonnepanelen op het dak en stadsverwarming — opgezet via de gedocumenteerde API. Clip zonder geluid; elke stap is op het scherm ondertiteld.

De details en de volledige handleiding in onze documentatie →
Wat de walkthrough laat zien

Vijf stappen, van een geschreven briefing naar drie scenario's klaar om te optimaliseren.

De clip doorloopt een echte opzet: een briefing in gewone taal, het script dat de assistent daaruit maakt, de aannames die hij vooraf terugkoppelt, en de drie scenario's die er aan de andere kant uitkomen.

  1. Vragen

    Beschrijf de studie in gewone taal

    De briefing vraagt om een project met drie leveringsvarianten — een gasketel, een warmtepomp met zonnepanelen op het dak en stadsverwarming — voor de warmte-, koude- en elektriciteitsvraag van een woongebouw van 1.500 m² over vijf verdiepingen, ontleend aan de Sympheny-database. De assistent werkt vanuit de gepubliceerde API-specificatie en weet dus wat een project, een analyse, een scenario en een hub zijn voordat hij begint.

  2. Hij schrijft het script

    De assistent maakt het opzetscript

    Hij schrijft Python tegen de Sympheny SDK, één tak per variant, in plaats van door de interface te klikken. Het script is van u om te lezen, te versioneren en opnieuw te draaien — wat meer waard is dan de tijdwinst, omdat een collega precies kan zien wat er is gebouwd en op welke basis.

  3. Aannames controleren

    Hij vertelt u wat hij zelf moest beslissen

    Voordat hij gaat draaien, markeert de assistent de twee afwegingen die de briefing niet had beslecht: welk vraagjaar uit de database wordt genomen, en waar de koeling vandaan komt. Dit is wat de workflow bruikbaar maakt op echte projecten — de onduidelijkheden komen boven als vragen, in plaats van als stille standaardwaarden die diep in een model verstopt zitten.

  4. Eén analyse, drie scenario's

    Drie varianten op één gedeelde basis

    De drie scenario's landen in één analyse, elk met eigen invoer, technologieën en uitvoer, en allemaal met hetzelfde vraagprofiel en dezelfde aannames. Die gedeelde basis maakt de vergelijking verdedigbaar wanneer een klant of een commissie vraagt waarom één variant heeft gewonnen.

  5. Wat er daarna gebeurt

    Sympheny optimaliseert ze

    Vanaf daar is de workflow de gewone. Sympheny draait de MILP-optimalisatie over de technologie- en capaciteitscombinaties voor elke variant en levert de optimale configuraties, met de afwegingen op een Pareto-front. De assistent heeft het model opgezet. Hij heeft het nooit opgelost.

Light App Editor

"Voeg na stap 1 een nieuwe stap toe die alle projecten opsomt…" — en de wizard heeft er een.

AI helpt u de interface te bouwen. Sympheny optimaliseert deterministisch, zoals altijd.

Een light app is een kleine, gerichte interface boven op Sympheny — een wizard die de vorm heeft van de studie die uw team echt draait, niet van het hele platform. U bouwt er een, en past hem aan, in de Light App Editor.

De clip laat zien hoe er een wordt aangepast. Een geschreven instructie voegt een stap toe aan een al uitgerolde wizard van vier stappen, de stappen daaronder krijgen een nieuw nummer, en het nieuwe scherm is twee seconden later live. De toegevoegde stap is geen mockup: hij roept GET /projects aan bij de Sympheny-backend en toont wat er terugkomt — eigenaar, status, laatste update — voor elk project in het account.

Light App Editor · 40 seconden

Een al uitgerolde wizard van vier stappen krijgt er een vijfde bij uit één geschreven instructie: in twee seconden uitgerold en met live gegevens uit de Sympheny-backend. Clip zonder geluid; elke stap is op het scherm ondertiteld. De clip laat een bestaande app zien die wordt uitgebreid, niet een app die vanaf nul wordt gebouwd.

Praat met ons over AI voor uw eigen light app →
Drie ingangen

Alles wat een agent nodig heeft, is al gedocumenteerd.

Twee van de drie zijn vandaag al live: de REST API en de Python SDK zijn volledig gedocumenteerd en nu al aan te sturen. De MCP-server, waarmee een assistent verbinding maakt zonder dat u zelf iets hoeft te bouwen, komt in de komende weken beschikbaar.

Nu beschikbaar

REST API

Elk endpoint is publiek gedocumenteerd, met JWT-authenticatie, request- en response-schema's en een browsergebaseerde API Explorer. Projecten, analyses, scenario's, fasen, hubs, technologieën en solverberekeningen zijn allemaal bereikbaar.

REST API-referentie →
Nu beschikbaar

Python SDK

sympheny-toolbox, de officiële client, vereist Python 3.11 of nieuwer en installeert met pip. De toolbox stelt elk gedocumenteerd endpoint beschikbaar als getypeerde methode met Pydantic-validatie, biedt bijbehorende synchrone en asynchrone clients, en regelt inloggen, tokencaching en verversing voor u. Uitgewerkte handleidingen behandelen het starten van een solverberekening en het downloaden van resultaten.

Python SDK-handleiding →
Binnen enkele weken

MCP-server

Een remote Model Context Protocol-server, zodat een assistent Sympheny kan aanroepen via een standaardverbinding in plaats van met handgeschreven HTTP. De client-installatie voor Claude Code, Claude Desktop, ChatGPT en Gemini CLI is al vooraf gedocumenteerd, en het endpoint gaat antwoorden zodra de server in de komende weken live gaat. Tot die tijd doen de REST API en de SDK hetzelfde werk — dat is wat de walkthrough hierboven gebruikt.

MCP-installatie, vooraf gedocumenteerd →
Van opzet leesbaar voor agents

De documentatie is geschreven om door machines én mensen gelezen te worden.

docs.sympheny.com publiceert llms.txt, een compacte index van de documentatie in navigatievolgorde met één regel beschrijving per pagina, en llms-full.txt, de volledige set achter elkaar in leesvolgorde. Beide volgen de llms.txt-conventie.

Het praktische effect is dat u een assistent één URL kunt geven en hij het platform in context heeft — endpoints, schema's, modelstructuur en uitgewerkte voorbeelden — in plaats van de site te moeten doorzoeken of te gokken naar de vorm van een API.

llms.txtllms-full.txtGedocumenteerde schema'sGetypeerde SDK-methoden
Wat dit niet verandert

De optimalisatie is deterministisch, met of zonder assistent.

Een assistent koppelen verandert hoe een model wordt gebouwd. Het raakt niet aan hoe het model wordt opgelost.

Geen AI in de berekening

Elk resultaat komt uit de Mixed-Integer Linear Programming-engine en is herleidbaar tot de beperkingen, kostenparameters en energiebalansen die het hebben voortgebracht. Dezelfde invoer levert altijd dezelfde uitvoer.

Standaard uit

Sympheny levert geen ingebouwde assistent en koppelt niets namens u. U beslist of u er een koppelt, en welke aanbieder u gebruikt.

Uw aanbieder, uw overeenkomst

De scenariodata die een assistent verstuurt en ontvangt, gaat via de aanbieder die u hebt gekozen, onder uw overeenkomst met hen, niet die van ons. Sympheny integreert geen model van derden in de eigen berekeningspijplijn.

Er wordt niets op uw data getraind

Er worden geen energieprofielen, gebouwgegevens of projectinvoer van klanten gebruikt om enig model te trainen, van ons of van derden.

Lees de volledige pagina over AI- en datatransparantie →
Waar teams het gebruiken

De delen van het werk die het automatiseren waard zijn.

Scenariovarianten op volume

Zet tien varianten van dezelfde studie op uit één specificatie, in plaats van elke variant met de hand te bouwen en te hopen dat de aannames gelijk zijn gebleven.

Gevoeligheidsanalyses

Draai een scenario opnieuw over een reeks tarieven, technologiekosten of vraagaannames, en verzamel de resultaten op één plek.

Opzet vanuit een bestaande specificatie

Zet een klantbriefing, een spreadsheet met locatiegegevens of een bestaande modelbeschrijving om in een Sympheny-project zonder het opnieuw te typen.

Herhaalbare pijplijnen

Stuur Sympheny aan vanuit een notebook of een interne tool, zodat een studie die uw team elke maand draait, elke maand op dezelfde manier draait.

Vragen

Werken met AI-assistenten en agents.

Kan ik Sympheny gebruiken met een AI-assistent of agent?

Ja. Sympheny publiceert een REST API en een Python SDK, beide volledig gedocumenteerd, zodat een assistent of coding agent scenario's kan aanmaken, optimalisatieruns kan starten en resultaten kan teruglezen. Een MCP-server komt in de komende weken beschikbaar. De installatie is gedocumenteerd op docs.sympheny.com. Er is standaard niets gekoppeld — u beslist of u het gebruikt.

Kan ik een light app aanpassen met een AI-assistent?

Ja. De Light App Editor neemt een instructie in gewone taal en past de app aan — in de clip hierboven komt er een wizardstap bij die alle projecten in het account opsomt, met een echte API-aanroep erachter, in twee seconden uitgerold. Wat u ziet is een aanpassing aan een app die al bestaat; er een vanaf nul bouwen is een langere klus. Hoe dan ook verandert de optimalisatie erachter niet: dezelfde deterministische MILP-engine lost het model op.

Als ik een assistent koppel, waar gaat mijn data dan naartoe?

Naar de aanbieder die u koppelt. Als u een assistent op Sympheny richt, gaat de scenariodata die hij verstuurt en ontvangt via die aanbieder, onder uw overeenkomst met hen, niet die van ons. Sympheny kiest de aanbieder niet voor u en integreert geen model van derden in de eigen berekeningspijplijn.

Verandert het koppelen van een assistent mijn resultaten?

Nee. Een assistent kan een scenario bouwen of aanpassen, maar de optimalisatie draait altijd op dezelfde deterministische MILP-engine. Een scenario dat door een assistent is samengesteld en hetzelfde scenario met de hand samengesteld leveren dezelfde resultaten.

Let op: Een assistent kan het model opzetten. Hij lost het nooit op.

Moet ik ontwikkelaar zijn om dit te gebruiken?

Voor de API en de SDK wel — of u hebt iemand in het team die dat is. De assistent het script laten schrijven verlaagt de drempel aanzienlijk, maar iemand moet het nog steeds draaien en lezen wat het heeft gedaan. De MCP-server is wat die stap wegneemt, en die komt in de komende weken. Tot die tijd is dit een workflow voor teams met enige scriptingcapaciteit; alle anderen werken in de webapp, waar dezelfde optimalisatie draait.

Is minder dan tien minuten realistisch?

Voor de opzet die hier te zien is wel: een project met drie varianten met vraag uit de database, met de API-specificatie beschikbaar voor de assistent en iemand die weet wat hij wil modelleren. Een eerste poging duurt langer, en de optimalisatierun komt daar nog bij. Het is een uitspraak over scenario-opzet, niet over het opleveren van een afgerond energieconcept.

Wanneer gaat de MCP-server live?

In de komende weken. De client-installatie voor Claude Code, Claude Desktop, ChatGPT en Gemini CLI is al gedocumenteerd, en het endpoint gaat antwoorden zodra de server live gaat. Alles wat de walkthrough hierboven laat zien, werkt vandaag al zonder MCP, via de REST API en de SDK. Wilt u bericht wanneer MCP er is, noem het dan tijdens een demogesprek of schrijf ons.

Wilt u het uitproberen op een eigen project?

Start een gratis proefperiode en stuur het aan via de API, of plan een demo en we lopen de opzet met u door op een project dat op het uwe lijkt.

Book a demo