> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Voorstellen en validatie

## Overzicht

Wanneer ElevenAgents Architect een wijziging voltooit, geeft het die aan je door als een **voorstel**: een branch met de wijziging, tests die aantonen dat deze werkt, en een [mergevoorstel](/docs/nl/eleven-agents/operate/merge-proposals) met het verzoek om die branch samen te voegen met `main`. Op deze pagina lees je hoe elk onderdeel werkt, waar je het vindt en hoe een voorstel van een gesprek naar live traffic gaat.

## Wat een voorstel is

Een voorstel is gebaseerd op het bestaande model voor [versiebeheer](/docs/nl/eleven-agents/operate/versioning):

| Onderdeel     | Wat het is                                                                                                                                                                              |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Branch        | Een branch die Architect voor de wijziging heeft gemaakt, zodat `main` en live bellers niet worden beïnvloed terwijl je werkt.                                                          |
| Concept       | De bewerkingen van Architect, voorbereid in je niet-gepubliceerde concept op die branch.                                                                                                |
| Versie        | Wanneer je het concept publiceert, wordt het een nieuwe versie op de branch.                                                                                                            |
| Tests         | De tests die Architect voor de wijziging heeft geschreven, gekoppeld aan de agent en uitgevoerd op de branch.                                                                           |
| Mergevoorstel | Een verzoek om de branch samen te voegen met `main` (of een andere branch die je kiest), met een beschrijving van de wijziging, de uitgevoerde tests en aandachtspunten voor reviewers. |

Het mergevoorstel is een standaardmergevoorstel van ElevenAgents, hetzelfde type dat een teamgenoot handmatig opent. Het is geen afzonderlijk objecttype.

Een mergevoorstel omvat precies één bronbranch en één doelbranch, dus één voorstel bevat één mogelijke oplossing. Vraag Architect om elk alternatief op een eigen branch te plaatsen als je alternatieven wilt vergelijken. Elke branch krijgt dan een eigen voorstel en je kunt traffic tussen de branches verdelen als [experiment](/docs/nl/eleven-agents/operate/experiments).

> **Note**
>
> Architect handelt namens jou, dus een mergevoorstel dat het opent, wordt onder jouw naam als auteur geregistreerd. Geen
> enkel veld geeft aan dat Architect het heeft gemaakt. Vermeld het in de beschrijving van het voorstel als je team dat wil
> weten.

## Hoe een voorstel wordt gemaakt

Architect maakt een voorstel wanneer je het vraagt iets te herstellen of te verbeteren, of wanneer je het een falende test, een Spotlight-bevinding of een triageticket geeft. De volledige reeks, met de tools die Architect bij elke stap aanroept, staat in het [uitgewerkte voorbeeld](/docs/nl/eleven-agents/operate/architect/how-it-works#worked-example-improving-refund-resolutions). Kort samengevat:

1. Architect onderzoekt het probleem, maakt een branch en bereidt de wijziging voor in je concept op die branch.
2. Architect schrijft tests en simulaties voor de wijziging en voert deze uit in het gesprek voordat het je het resultaat laat zien.
3. Architect opent het publicatievenster. Je controleert de diff en selecteert **Publiceren**, waarmee de wijziging wordt vastgelegd als een nieuwe versie op de branch.
4. Architect opent een mergevoorstel naar `main` en schrijft de beschrijving op basis van de daadwerkelijke commits en testruns van de branch.
5. Architect biedt aan om tijdens de beoordeling van het voorstel een klein deel van live traffic naar de branch te sturen. Hiervoor is je goedkeuring nodig.

Je kunt bij elke stap stoppen. Een branch met een gepubliceerde versie maar zonder mergevoorstel is nog steeds nuttig: je kunt deze zelf testen of later een voorstel openen.

### Validatie in het gesprek

Architect schrijft en voert tests uit als onderdeel van het maken van de wijziging, niet als afzonderlijke stap die je daarna start. Voor een oplossing is het een nuttig patroon om te laten zien dat de nieuwe tests zonder de wijziging falen en ermee slagen. Architect kan dezelfde tests uitvoeren op de oorspronkelijke branch en op het concept dat de wijziging bevat.

Architect voert deze voor-en-na-controle niet automatisch uit bij elke wijziging. Vraag erom wanneer het belangrijk is, bijvoorbeeld: "Laat me zien dat de nieuwe simulatie faalt op main en slaagt op de branch, en open daarna een voorstel."

Een test **slaagt** wanneer aan alle succesvoorwaarden is voldaan. Bij een LLM-test voldoet het antwoord van de agent aan de succescriteria. Bij een tool-calltest wordt de verwachte tool aangeroepen met de verwachte parameters. Bij een simulatie voldoet het gesimuleerde gesprek aan de succesvoorwaarden. Vraag Architect om tests meerdere keren uit te voeren om te controleren op wisselende resultaten. Het kan elke test maximaal 50 keer herhalen en het slagingspercentage rapporteren.

Zie [Testen](/docs/nl/eleven-agents/customization/agent-testing) voor de definitie van elk testtype.

## Waar je voorstellen vindt

Open de agent en ga vervolgens naar **Versiebeheer** > **Voorstellen**. Je kunt de lijst filteren op status, auteur (**Gemaakt door**) en reviewer (**Wacht op beoordeling van**, **Beoordeeld door**). Een voorstel dat Architect in je gesprek heeft geopend, staat met jou als auteur in de lijst.

Architect stuurt ook een link naar het voorstel in het gesprek zodra het dit maakt.

![Lijst met voorstellen op de pagina Branches](/docs/_fern-img/bfdb23ad1edb31c89c2ff2a137fa3028bf3f9fbcf31e236de142e207b5d54cd0.webp)

## Anatomie van een voorstel

De pagina van een voorstel toont de bron- en doelbranch, de status, of het kan worden samengevoegd en hoe ver de bronbranch achter of voorloopt op de doelbranch. Deze bevat de volgende tabbladen:

#### Overzicht

De beschrijving, een activiteitentijdlijn met commits op de bronbranch, beoordelingen en opmerkingen, en een opmerkingenveld. De zijbalk toont reviewers, aanbevolen reviewers en eventuele gekoppelde triagetickets.

Een beschrijving die Architect schrijft, heeft altijd drie secties: **Samenvatting** (elke betekenisvolle wijziging en waarom), **Testen** (welke tests zijn uitgevoerd en de resultaten daarvan, of de vermelding dat er geen zijn uitgevoerd) en **Hoe te beoordelen** (waar je op moet letten en een uit te voeren test of te proberen gesprek).

![Tabblad Overzicht van een mergevoorstel](/docs/_fern-img/569eccd1750f90cd5ec8121411e8effd3a38e924e0f03f06f6216a9fcc160e08.webp)

#### Wijzigingen

De configuratie-diff: hoe de doelbranch er na de merge uit zal zien, vergeleken met de huidige status. Als beide branches hetzelfde veld hebben gewijzigd, toont een weergave **Conflicten** elk conflict en welke kant voorrang krijgt.

Nadat het voorstel is samengevoegd, toont dit tabblad de doelbranch voor en na de merge.

![Tabblad Wijzigingen van een mergevoorstel](/docs/_fern-img/cd06c0f93240d7c973101b896599542290437a6dcbfa6d288a25db0c1bfcd566.webp)

#### Testruns

Het slagingspercentage en de geschiedenis van testruns voor de bronbranch, inclusief de runs die Architect in het gesprek heeft gestart. Schakel naar de doelbranch om het slagingspercentage te vergelijken. Selecteer **Tests uitvoeren** om elke gekoppelde test opnieuw op een van beide branches uit te voeren, eventueel meerdere keren per test.

Testruns zijn gekoppeld aan de branch, niet aan het voorstel. Voor het samenvoegen hoeven tests niet te slagen. Reviewers beslissen op basis van wat dit tabblad toont.

![Tabblad Testruns van een mergevoorstel](/docs/_fern-img/58e28b31cb3408fe5bf8e9193f4a4edb5e716e6023c56f29d5a4f924c70a0f7a.webp)

#### Gesprekken

Elk gesprek dat op de bronbranch is uitgevoerd, inclusief live traffic die via een trafficverdeling daarheen is gestuurd. Selecteer een gesprek om het transcript te openen. Terwijl een branch gefaseerd wordt uitgerold, kun je hier volgen hoe echte bellers de wijziging gebruiken.

![Tabblad Gesprekken van een mergevoorstel](/docs/_fern-img/f6345ff5beaee9a22732c7322995a7e889245cda7901682ab390790ef3849690.webp)

## Beoordelen en samenvoegen

### Statussen

Een mergevoorstel heeft een van deze statussen:

| Status       | Betekenis                                                                                                                                                      |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Open         | Wacht op beoordeling of merge.                                                                                                                                 |
| Samengevoegd | De branch is samengevoegd met het doel.                                                                                                                        |
| Gesloten     | Ingetrokken door de auteur, afgewezen door iemand anders of gesloten omdat de branch is gearchiveerd. Gesloten voorstellen kunnen niet opnieuw worden geopend. |

Zolang een voorstel open is, is de meest recente beoordeling van elke reviewer **Goedgekeurd** of **Wijzigingen aangevraagd**. Er zijn geen afzonderlijke statussen voor "getest" of "klaar voor beoordeling". Testresultaten staan in plaats daarvan op het tabblad **Testruns**.

Beoordelingen en opmerkingen verschijnen in de activiteitentijdlijn op het tabblad **Overzicht**, naast elke nieuwe versie die is vastgelegd op de bronbranch.

![Activiteitentijdlijn van een mergevoorstel](/docs/_fern-img/522012341d0089ff418032a34bae6653d2b883934b64a0b6a12de887646b2f5f.webp)

### Wie kan goedkeuren en samenvoegen

* Iedereen met editorrechten voor de agent kan een voorstel beoordelen, behalve de auteur. Omdat Architect namens jou handelt, kun je een voorstel dat Architect in jouw gesprek heeft geopend niet goedkeuren. Dat moet een teamgenoot doen.
* Een voorstel kan worden samengevoegd zodra het ten minste één goedkeuring heeft van iemand anders dan de auteur en de meest recente beoordeling van geen enkele reviewer **Wijzigingen aangevraagd** is. Workspacebeheerders kunnen zonder goedkeuring samenvoegen.
* Samenvoegen met een [beschermde branch](/docs/nl/eleven-agents/operate/versioning) vereist beheerdersrechten of goedkeuring van een beheerder.

Architect kan een mergevoorstel niet goedkeuren, erop reageren, samenvoegen of sluiten. Die stappen worden altijd door mensen uitgevoerd. Zie [Mergevoorstellen](/docs/nl/eleven-agents/operate/merge-proposals) voor de volledige beoordelingsregels.

> **Warning**
>
> Architect kan een branch rechtstreeks samenvoegen, zonder voorstel, wanneer je dat vraagt en je rol de
> merge toestaat. In de modus **Goedkeuring vereist** vraagt het dit eerst. In de modus **Automatisch goedkeuren** doet het dat niet. Gebruik
> branchbescherming op `main` als elke wijziging via een beoordeeld voorstel moet gaan.

### Wat er gebeurt bij een merge

Na een merge is er geen afzonderlijke publicatiestap. Door samenvoegen wordt een nieuwe versie op de doelbranch vastgelegd, en die versie verwerkt meteen live traffic voor het deel van de traffic dat het doel ontvangt. Als het doel `main` is en er geen trafficverdeling is ingesteld, betekent dat alle bellers.

Samenvoegen doet ook het volgende:

* Verplaatst elk deel van live traffic dat de bronbranch had naar het doel.
* Archiveert de bronbranch standaard.
* Sluit alle andere open voorstellen van dezelfde branch.
* Lost het gekoppelde triageticket op, als dat er is.

## Gefaseerde uitrol

Voordat een voorstel wordt samengevoegd, kun je een deel van live traffic naar de bijbehorende branch sturen, zodat echte bellers de wijziging gebruiken.

#### Start de verdeling

Vraag Architect bijvoorbeeld: "Stuur 5% van de traffic naar deze branch." Architect toont je de volledige
resulterende verdeling, inclusief het aandeel van `main`, en vraagt om goedkeuring voordat deze wordt toegepast. Je kunt
dit ook zelf instellen: selecteer in **Versiebeheer** > **Branches** de optie **Deployen** op de branch.

#### Bekijk de resultaten

Open het tabblad **Gesprekken** van het voorstel om gesprekken op de branch te lezen, of vraag Architect
de resultaten van de branch te vergelijken met die van `main`.

#### Promoveer of draai terug

Voeg het voorstel samen om te promoveren. Het traffic-aandeel van de branch verhuist mee naar `main`. Vraag Architect om terug
te draaien het aandeel van de branch op 0% te zetten, of bewerk de deployment zelf. Live
traffic keert onmiddellijk terug naar `main`.

Traffic-aandelen moeten altijd samen 100% zijn en routing is deterministisch per gesprek. Het wijzigen van het aandeel van een beschermde branch, waaronder het weghalen van traffic bij een beschermde `main`, vereist een beheerder. Zie [Trafficdeployment](/docs/nl/eleven-agents/operate/versioning#traffic-deployment).

## Proactieve voorstellen

> **Note**
>
> Architect maakt voorstellen wanneer je erom vraagt, of wanneer je het een falende test, een Spotlight-
> bevinding, een waarschuwing of een triageticket geeft. Het scant je agents nog niet volgens een schema en opent
> niet zelfstandig voorstellen.

De proactieve route is nu [Spotlight](/docs/nl/eleven-agents/dashboard/spotlight), gevolgd door overdracht. Spotlight volgt de gesprekken van je agent continu. Het maakt een wekelijkse samenvatting met voorgestelde onderzoeken, geeft realtime waarschuwingen en beveelt configuratiewijzigingen aan. Zo maak je van een Spotlight-bevinding een voorstel:

#### Open Spotlight

Open de agent. De overzichtspagina is Spotlight.

#### Kies een bevinding

Open de wekelijkse samenvatting en bekijk **Voorgestelde volgende stappen**, of open een realtime waarschuwing.

#### Draag het over aan ElevenAgents Architect

Selecteer **Openen in Architect** bij een suggestie, **Analyseren met Architect** bij de samenvatting of
**Onderzoeken met Architect** bij een waarschuwing. Architect ontvangt de bevinding en krijgt de instructie om deze
te verifiëren aan de hand van echte gesprekken en vast te stellen welke branch wordt beïnvloed, voordat
het een wijziging voorstelt.

#### Vraag om een voorstel

Bekijk de bevindingen van Architect. Als je het eens bent met de hoofdoorzaak, vraag het probleem dan op een
branch op te lossen, de oplossing te testen en een voorstel te openen.

Triagetickets werken op dezelfde manier. Je live agent kan tijdens gesprekken [problemen markeren voor beoordeling](/docs/nl/eleven-agents/customization/tools/system-tools/flag-issue-for-review), en **Bespreken met Architect** op een ticket start een onderzoek ernaar.

Geplande automatiseringen, met rapporten die worden geleverd aan een Architect-inbox, zijn in ontwikkeling. Het tabblad **Inbox** op de Architect-pagina is hiervoor een tijdelijke aanduiding.