Gebruikershandleiding — AURA

Deze gids is voor wie net een account heeft aangemaakt en zich afvraagt waar te beginnen. Hij beschrijft wat het platform vandaag doet, in de volgorde waarin u het gebruikt.

Wat AURA doet, en wat niet

AURA verzamelt bewijs van de conformiteit van uw AI-systemen met Verordening (EU) 2024/1689, ordent het in een verifieerbaar dossier, en meet wat meetbaar is — de bias van een model, de koolstofvoetafdruk van een training.

AURA is geen aangemelde instantie. De opgestelde rapporten vormen geen conformiteitsbeoordeling in de zin van artikel 43 van de Verordening, geen certificering en geen juridisch advies.

Deze zin is geen voorzorg van een advocaat. Ze beschrijft precies de grens: het platform helpt u een dossier op te bouwen en te weten waar u staat. Het is een erkende auditor die attesteert, en die alleen.

Drie onderscheidingen die u overal in de interface terugvindt, omdat ze de betekenis veranderen van wat u leest:

De gratis proefperiode

Ze begint zodra uw organisatie is aangemaakt, zonder iets te hoeven vragen.

Wat ze omvat

De Assistent, 10 dagen gratis. Hij beantwoordt vragen over de regelgeving (AI-verordening, AVG, NIS2) en over AURA zelf — hoe u een audit start, wat een score of een technische test betekent — uitsluitend op basis van zijn twee geïndexeerde bibliotheken. Hij citeert zijn bronnen, en als hij niets vindt, zegt hij dat liever dan iets te verzinnen.

Eén gratis audit, naar keuze. Bias of juridisch, eenmalig. De keuze is aan u: de as die u start verbruikt de proefperiode, de andere blijft beschikbaar zodra u een sleutel instelt.

Wat er daarna gebeurt

Na de 10 dagen, of zodra de audit verbruikt is, meldt het platform dat de proefperiode is afgelopen. Niets wordt verwijderd: uw projecten, dossiers en rapporten blijven toegankelijk. Het is de aanroep naar een taalmodel die stopt.

U ziet op elk moment waar u staat onder Instellingen → LLM-providers. De banner verdwijnt vanzelf zodra u uw eigen sleutel hebt ingesteld: hij kondigt alleen aan wat u nog gratis wordt aangeboden.

De Assistent

Een intentierouter deelt elke vraag in — juridisch (de verordening, haar artikelen, haar verplichtingen) of platform (AURA zelf: de schermen, hoe u een audit start, wat een methodologie betekent die het platform toepast — een WEAT/SEAT- of BBQ/HELM-test, de AIRS-motor, gemeten/geschatte/verklaarde bewijsstukken). Bij twijfel valt de Assistent terug op de juridische modus — de strengste.

Elk antwoord vermeldt zijn herkomst (Juridisch of Platform) en blijft uitsluitend gebaseerd op de fragmenten uit de bijbehorende bibliotheek: nooit een antwoord zonder onderliggend document, in welke modus ook.

Het antwoord komt eerst beknopt, met een voorstel om een specifiek punt uit te diepen in plaats van meteen alle bijzondere gevallen op te sommen.

Het traject van een audit

1. Een project

AI-systemen → Nieuw project. Een project staat voor een AI-systeem. U heeft er zoveel als u systemen te documenteren heeft.

2. Een uitvoering

Een uitvoering is een gedateerde campagne op dit systeem: de foto van een toestand, op een bepaald moment. U start er meerdere in de loop van de tijd, en dat is gewild — een conformiteitsdossier wordt van versie tot versie vergeleken.

Zodra de uitvoering geopend is, toont de zijbalk haar tabbladen: Classificatie, Conformiteit, Beoordelingen, en — zodra een campagne geopend is — Bewijsdossier & rapport. Het tabblad Beoordelingen is het overzicht: het toont naast elkaar de twee kaarten die elk een audit openen — Conformiteit AI-verordening (het AIRS-referentiekader, stap 5) en Juridische conformiteit (de verklarende vragenlijst, stap 4).

3. De risicoclassificatie

De Verordening vraagt niet hetzelfde van elk systeem. Acht vragen, beoordeeld door een deterministische regelboom — nooit een taalmodel — bepalen uw categorie: verboden praktijk, hoog risico (bijlage I of III), AI-model voor algemene doeleinden met systeemrisico, transparantieverplichtingen (art. 50), of minimaal risico.

Het beslissingsspoor wordt bewaard. Elk antwoord activeert een geïdentificeerde regel; het rapport toont welke regel doorslaggevend was, en op welk antwoord — u kunt de classificatie dus uitleggen, niet alleen aankondigen.

Tabblad Classificatie. Opnieuw op de vragen antwoorden, wanneer u dat al een eerste keer hebt gedaan, levert een nieuwe classificatie op (knop Herclasseren vanuit het tabblad Conformiteit, zodra een eerste classificatie bestaat); al geëxporteerde dossiers bewaren de oude — de classificatie die als basis diende voor een geleverd rapport verandert nooit met terugwerkende kracht.

4. De vragenlijst

Een verklarende vragenlijst gekoppeld aan de uitvoering: uw verklaringen over uw documentatie, uw governance, uw gegevens, in het kader van de AI-verordening en de AVG. Ze levert een verklarende score op, en dat woord telt: hij berust op wat u verklaart, zonder verificatie. Hij signaleert aandachtspunten; hij besluit niet tot conformiteit.

Tabblad Beoordelingen → kaart "Juridische conformiteit" → De juridische audit starten. Uw antwoorden blijven niet geïsoleerd: zodra een Core AIRS-campagne wordt geopend (volgende sectie), worden ze daar overgenomen als verklaard bewijs — dat is precies wat "Core AIRS verifieert op basis van stukken" in de praktijk betekent.

5. De controlecampagne

Dit is de kern. Het platform toetst uw systeem aan het AIRS-referentiekader en verzamelt, voor elke toepasselijke controle, een bewijsstuk met zijn aard — gemeten, geschat of verklaard.

Tabblad Conformiteit → Beoordelingscampagnes → een modaliteit kiezen → Een campagne openen. Twee modaliteiten, die niet dezelfde controles omvatten:

Elke controle toont de verwachte verificatiemethode en het gezochte bewijs. Een controle zonder bewijs blijft niet beoordeeld — ze wordt nooit geteld als een hiaat, en blijft zichtbaar in plaats van verborgen te worden, om niet de indruk te wekken dat ze niet van toepassing was.

Toepasselijke termijnen. Het tabblad Conformiteit vermeldt ook de verplichtingen die op uw categorie van toepassing zijn, met hun datum. Een termijn met de vermelding voorlopig vloeit voort uit een politiek akkoord dat nog niet is gepubliceerd in het Publicatieblad van de Europese Unie: ze kan nog wijzigen, en mag niet als verworven worden beschouwd.

6. Het rapport en het dossier

Vanaf een geopende campagne bevriest De campagne sluiten en het rapport opstellen de dekking — een al geleverd rapport mag niet veranderen omdat het referentiekader sindsdien is geëvolueerd. Drie uitkomsten, in de kop van de campagne:

Het rapport kan een openingssamenvatting dragen. U schrijft ze zelf, of u vraagt een taalmodel om een eerste ontwerp — maar ze komt pas in het document na uw nalezing en goedkeuring, die erin verschijnen met uw naam en de datum. Een ontwerp gaat nooit in uw naam naar een auditor.

Overstappen naar uw eigen sleutel

De proefperiode wordt bediend door de sleutel van CEVIA. Daarna stelt u uw eigen sleutel in: de aanroepen worden dan gefactureerd door uw provider, zonder tijdslimiet.

Instellingen → LLM-providers. Vijf toepassingen worden onafhankelijk ingesteld.

Drie dingen zijn goed om te weten voordat u begint.

« Te auditeren model » duidt het uwe aan, niet het beste op de markt — in beide gevallen. Er een gerenommeerd model in plaatsen zou neerkomen op het auditeren van dat model, en op het verkrijgen van een correct rapport dat niets zegt over uw systeem. Beide « te auditeren »-toepassingen staan los van elkaar: de ene instellen stelt de andere niet in, net zoals het vectorisatiemodel wijzigen niets verandert aan het model dat de antwoorden van de assistent opstelt.

Het vectorisatiemodel wijzigen verplicht tot herindexering. Twee modellen ordenen teksten niet op dezelfde plaats; ze mengen levert stilzwijgend foute antwoorden op. Het platform herinnert u daaraan bij elke indexering.

De knop « Testen » doet een echte aanroep. Alleen de vorm van een sleutel valideren zou niets bewijzen — het is de provider die beslist of hij ze aanvaardt.

Wat er met uw sleutel gebeurt

Ze wordt versleuteld voordat ze wordt opgeslagen, en wordt nooit opnieuw getoond — niet op het scherm, niet in een logboek, niet in een foutmelding. De lijst toont zeven van de tweeëndertig tekens, genoeg om te herkennen welke is ingesteld. Om ze te wijzigen, voert u een nieuwe in; de oude wordt nooit herlezen.

Elke toepassing draagt een maandelijks tokenplafond. Een aanroep die dit zou overschrijden, wordt geweigerd voordat hij wordt verzonden: dat maakt van een onbedoelde lus een beleefde weigering in plaats van een factuur.

Instellingen → LLM-providers → Verbruiksdetail toont wat is verbruikt, per toepassing, met de geschatte kost en de geschatte uitstoot. De kost komt uit de openbare tarieflijst van de provider; zijn factuur is doorslaggevend.

Een zelf gehost model auditeren

Een model dat op uw eigen server draait — fijn afgestemd, met zijn eigen zoeksysteem, ongeacht de machinerie erachter — wordt op dezelfde manier geauditeerd als elk ander: AURA behandelt het als een zwarte doos. Het stelt de testvragen, het leest de antwoorden, en ziet nooit wat er daarachter gebeurt.

Kies Zelf gehost (vLLM, Ollama) als provider voor de toepassing "Te auditeren model". Een zelf gehost embeddingmodel wordt op dezelfde manier ingesteld, onder de toepassing "Te auditeren embeddingmodel (bias)".

Twee velden vult u zelf in, want er is niemand aan wie u ze kunt vragen:

• Service-URL — het adres van uw server, verplicht via HTTPS. Over gewoon HTTP reist de sleutel bij elke aanroep onversleuteld mee, over een netwerk dat niet altijd het uwe is.
• API-sleutel — een geheim dat u zelf bedenkt en aan beide kanten instelt: op uw server (bij vLLM bijvoorbeeld de vlag --api-key bij het opstarten), en hier, identiek.

De knop "Testen" bevestigt dat beide kanten met elkaar kunnen praten voordat u de eerste audit start.

De agent auraagent

Sommige metingen kunnen niet vanuit het platform gebeuren: u moet zijn waar uw model draait. Dat is de rol van de agent, een opdrachtregelprogramma dat u bij uzelf installeert, onder Linux, macOS of Windows.

Vóór de installatie

• Python 3.10, 3.11, 3.12 of 3.13 is verplicht. Controleer dat met python --version (onder Windows: py --version).
• Onder Python 3.14 of 3.9 installeert pip zonder waarschuwing een oude versie van de agent, die niet werkt. Installeer in dat geval Python 3.12 en maak een aparte omgeving voor de agent aan (opdrachten hieronder).
• De agent moet versie 1.1 of hoger zijn. Installeer hem met pip install --upgrade "auraagent>=1.1" en controleer daarna met aura --version.
• Bestaat er op uw toestel een variabele AURA_SERVER_URL, verwijder ze dan vóór aura init. Ze vervangt het adres van de server.

Als uw Python geschikt is:

pip install --upgrade "auraagent>=1.1"
aura --version
aura init

Installeer anders Python 3.12 (Windows: winget install Python.Python.3.12; macOS: brew install python@3.12; Ubuntu of Debian: sudo apt install python3.12 python3.12-venv) en maak daarna de omgeving van de agent aan. Onder Windows, in PowerShell:

py -3.12 -m venv $HOME\aura-env
& $HOME\aura-env\Scripts\Activate.ps1
pip install --upgrade "auraagent>=1.1"
aura init

Onder macOS of Linux:

python3.12 -m venv ~/aura-env
source ~/aura-env/bin/activate
pip install --upgrade "auraagent>=1.1"
aura init

Activeer deze omgeving opnieuw vóór elk gebruik van aura. Wordt de activering onder Windows geweigerd (« het uitvoeren van scripts is uitgeschakeld »), voer dan eenmalig Set-ExecutionPolicy -Scope CurrentUser RemoteSigned uit.

aura init vraagt om de API-sleutel van uw account — Instellingen → API-sleutels — en schrijft ze naar ~/.aura.config, leesbaar door enkel de eigenaar.

De installatie controleren

Voer direct na aura init uit:

aura status

De verwachte uitvoer ziet er zo uit, met uw eigen identificatoren. De sleutel blijft gemaskeerd:

                      Configuration Aura
┌──────────────────────┬──────────────────────────────────────┐
│ api_endpoint         │ https://aura.cevia.ai/               │
│ api_key              │ ●●●●●●●●                             │
│ default_project      │ Aura Default Project                 │
│ default_project_id   │ 3f2b8c1e-7a4d-4e9b-9c21-5d8e6f0a1b2c │
│ default_execution_id │ 9a7c5e3b-1d2f-4a6b-8c0e-2f4d6b8a0c1e │
└──────────────────────┴──────────────────────────────────────┘

api_endpoint moet https://aura.cevia.ai zijn, met of zonder schuine streep op het einde. Toont het een ander adres, voer dan aura init opnieuw uit en antwoord y op « Voulez-vous le mettre à jour ? » (de agent vraagt in het Frans of de configuratie bijgewerkt moet worden). Verschijnt er een foutmelding, zie dan Probleemoplossing voor de agent.

Bias meten

Uw model verlaat uw infrastructuur nooit. Dat is de standaardmodus, en dat is het punt: de agent haalt de vragen op, stelt ze lokaal aan uw model, en stuurt enkel de ruwe antwoorden terug.

aura audit bias \
  --model mijn-model-v2 \
  --command "python bevragen.py {question}"

De evaluatie steunt op de dataset BBQ en op de metrieken van HELM: bias in dubbelzinnige context, in ondubbelzinnige context, nauwkeurigheid.

Een biasscore loopt van −1 tot +1, en nul is het goede resultaat:

Er bestaat geen drempel waarboven een model « conform » zou zijn. De Verordening legt er geen op, HELM evenmin. De meting documenteert; ze beslist niet.

Bias van een embeddingmodel meten (WEAT/SEAT)

Een embeddingmodel — zoekmachine, cv-matching, interne RAG — beantwoordt geen vragen: het zet woorden om in vectoren. De bijbehorende test heet WEAT/SEAT: ze meet of de vectorruimte bepaalde woorden sterker aan de ene groep koppelt dan aan de andere, in plaats van antwoorden te beoordelen.

Vanuit het platform, zonder iets te installeren. Dit is het eenvoudigste pad, en de standaardmodus voor deze as — in tegenstelling tot de generatieve biasaudit hierboven, waar lokaal de standaard is:

Embedding-bias → Nieuwe audit. Voer de identificatie van het model in en start de audit: AURA vectoriseert uw woorden via de provider die is ingesteld voor de toepassing "Te auditeren embeddingmodel (bias)", en berekent het resultaat op de achtergrond.

Lokaal, via de agent — het model verlaat uw infrastructuur nooit:

aura audit bias-embedding \
  --model mijn-embeddingmodel-v2 \
  --command "python vectoriseren.py {text}" \
  --local

Uw opdracht ontvangt een woord en schrijft de vector ervan naar de standaarduitvoer, als JSON: [0.12, -0.4, 0.07, ...]. Een woord waarvan de vectorisatie mislukt, wordt weggelaten in plaats van de berekening te vervalsen met een verzonnen vector.

Het resultaat draagt een effectgrootte (Cohen's d) en een p-waarde, per geteste categorie:

Wat deze meting niet vaststelt. Een verband in de vectorruimte is geen bewezen discriminatie in de beslissingen die uw systeem verderop produceert. Het is bewijs van onderzoek in de zin van artikel 10 §2(f)-(g) van de Verordening — het documenteert, het beslist niet, net als de generatieve audit hierboven.

De koolstofvoetafdruk meten

aura audit carbon -- python trainen.py --epochs 10

De teruggekoppelde waarden zijn die welke CodeCarbon op uw machine heeft gemeten. Een onbeschikbare metriek blijft leeg in plaats van te worden vervangen door nul — nul zou « geen uitstoot » betekenen.

De afsluitcode van de gemeten opdracht wordt doorgegeven: een continuous integration-script mislukt als wat het meet, mislukt is.

Als bibliotheek, als u liever uw eigen code instrumenteert:

from aura import AuraCarbon

with AuraCarbon(execution_id="run-2026-001") as opvolging:
    model_trainen()

print(opvolging.metrics())

Het rapport ophalen

aura report 3f2504e0-4f89-11d3-9a0c-0305e82c3301

Drie uitkomsten: 0 het rapport is opgeslagen, 1 de uitvoering is niet gevonden, 2 het rapport is nog niet samengesteld — even wachten volstaat.

Wat bij u blijft, en wat naar AURA gaat

Uw API-sleutel verschijnt nooit — niet op het scherm, niet in een logboek, niet in een foutmelding. Het bestand ~/.aura.config wordt aangemaakt met modus 0600.

Uw account beschermen

Instellingen → Mijn profiel → Beveiliging. Tweefactorauthenticatie is optioneel, en wordt per persoon ingesteld.

Eenmaal geactiveerd, volstaat uw wachtwoord niet meer: bij elke aanmelding wordt een code van uw authenticatie-app gevraagd. U ontvangt tien back-upcodes, eenmalig getoond — noteer ze. Ze dienen voor wanneer u uw telefoon niet bij de hand hebt, en elke code werkt slechts eenmaal.

Ze betreft enkel de browser. auraagent en de API blijven authenticeren met een sleutel: een machine typt geen zescijferige code.

Als er iets misgaat

De chatbot antwoordt « de aangeleverde fragmenten laten geen antwoord toe ». Dit is geen storing. Hij heeft in zijn bibliotheek gezocht, niets relevants gevonden, en zegt dat liever dan iets te verzinnen. De tekst die u zoekt, staat er misschien nog niet in geïndexeerd.

Een controle blijft « niet beoordeeld ». Er is geen bewijs aan gekoppeld. Dit is geen mislukking, en het rapport telt het niet als dusdanig.

Het rapport is nog niet beschikbaar. De samenstelling ervan loopt op de achtergrond. Het scherm zegt dat liever dan u een onvolledig document te bezorgen.

Een aanroep wordt geweigerd terwijl uw sleutel geldig is. Controleer het maandelijkse plafond van de betrokken toepassing, op het providerscherm.

Probleemoplossing voor de agent

Begin altijd met deze drie controles:

python --version
aura --version
aura status

aura status maskeert uw sleutel: u kunt de uitvoer ongewijzigd aan de support bezorgen.

De agent toont « ERR_NGROK_6008 ». Uw configuratie verwijst nog naar de vroegere ontwikkelserver, die intussen uitgeschakeld is. Bestaat er een variabele AURA_SERVER_URL, verwijder ze dan, voer aura init opnieuw uit en antwoord y op « Voulez-vous le mettre à jour ? ». Onder Windows, in PowerShell:

[Environment]::SetEnvironmentVariable("AURA_SERVER_URL", $null, "User")
Remove-Item Env:AURA_SERVER_URL -ErrorAction SilentlyContinue
aura init

Verwijder onder macOS of Linux ook elke regel export AURA_SERVER_URL=… uit ~/.bashrc of ~/.zshrc:

unset AURA_SERVER_URL
aura init

pip weigert auraagent>=1.1 te installeren. Het toont:

ERROR: Ignored the following versions that require a different python version: 1.0.0 Requires-Python >=3.10,<3.14; 1.1.0 Requires-Python >=3.10,<3.14
ERROR: Could not find a version that satisfies the requirement auraagent>=1.1 (from versions: 0.1.0, …, 0.3)
ERROR: No matching distribution found for auraagent>=1.1

Uw Python-versie wordt niet ondersteund — meestal 3.14 of 3.9. Installeer Python 3.12 en maak de aparte omgeving aan die beschreven staat in De agent auraagent.

De agent krijgt een 404-fout op een adres in //api/…. De agents 1.0.0 en 1.1.0 voegden een schuine streep te veel toe aan het serveradres. Het platform aanvaardt deze adressen sinds 23 oktober 2026: voer de opdracht eerst gewoon opnieuw uit. Blijft de fout bestaan, werk de agent dan bij.

pip install --upgrade "auraagent>=1.1"

aura --version toont 0.x. Er is een oude versie van de agent geïnstalleerd, bijna altijd omdat uw Python 3.14 of 3.9 is: pip kiest dan zonder waarschuwing de laatste compatibele versie, die naar de uitgeschakelde server verwijst. Installeer Python 3.12, maak de aparte omgeving aan die beschreven staat in De agent auraagent, en verwijder de oude configuratie vóór aura init — onder Windows Remove-Item $HOME\.aura.config, onder macOS of Linux rm -f ~/.aura.config.