Een codeeragent plannen in Open WebUI op een homeserver

Met Open WebUI v0.13.3 kun je een codeeragent plannen voor een geselecteerde terminal en werkmap. Begin met een taak die alleen rapporteert in een wegwerpcheckout: voer een bekende testopdracht uit, vat fouten samen en stuur het resultaat terug naar een chat. Met die test controleer je de planner, machtigingen en afleverroute voordat je een terugkerende taak toegang geeft tot belangrijke bestanden.

Je hebt een compatibele Open WebUI-installatie nodig, een bereikbare terminalintegratie die de gewenste agent aanbiedt en een toegankelijke werkruimte. In de releaseopmerkingen van v0.13.3 staat dat geplande uitvoeringen controleren of de opgeslagen terminal en agent nog beschikbaar zijn. Beschouw de terminal, het bestandssysteem en de onderliggende modelverbinding als afzonderlijke onderdelen van de configuratie.

Wat is er veranderd in de release van november?

In de automatiseringseditor kun je een terminal en map selecteren en vervolgens een agent kiezen die door die terminal wordt aangeboden. De ingestelde terminal en map worden meegenomen in de geplande uitvoering. De resultaten van agentautomatisering worden naar een chat gestuurd, terwijl andere typen automatisering mogelijk andere bestemmingsopties hebben. De eerdere release v0.13.1 introduceerde codeeragents in de modelkiezer wanneer een verbonden terminal deze aanbiedt.

Een geselecteerde terminal kan draaien op dezelfde host als Open WebUI of een afzonderlijke, bereikbare service zijn. Voor de taak is het bestandssysteem van die terminal van belang. Een map die op je laptop zichtbaar is, is mogelijk niet aanwezig in een container. Een bestand dat beschikbaar is voor de ene terminal, bestaat mogelijk niet in een andere. Controleer het pad in precies de terminal die voor de automatisering is geselecteerd.

Hoe bereid je de werkruimte voor?

Maak een aparte testcheckout, bij voorkeur voor een kleine repository zonder productiegeheimen. Leg een bekende revisie vast en voeg bij de installatie een onschuldige test die slaagt en een test waarvan bekend is dat die faalt. Stel voor het eerste rapport de invoercheckout alleen-lezen beschikbaar, als de testrunner dat ondersteunt. Bied een beschrijfbare scratchmap voor testcaches en logbestanden. Sommige buildtools moeten in de boomstructuur schrijven; configureer ze daarom om ergens anders te schrijven of gebruik een wegwerpkopie met schrijfrechten.

Als meerdere taken dezelfde repository gebruiken, maak dan één worktree per agent of taak. Houd back-ups en de werkmap gescheiden. Lees waarom back-ups kunnen mislukken bij gedeelde toegang voordat je een taak ruime schrijfrechten op een bestandsserver geeft.

Hoe configureer je de eerste geplande taak?

Open de automatiseringseditor in een versie met agentautomatisering. Selecteer je terminal, kies de map die vanuit die terminal zichtbaar is en selecteer vervolgens de agent. Kies voor de eerste test een eenmalige uitvoering op korte termijn, als je installatie die planningsoptie biedt. Lees het schema af in de geconfigureerde tijdzone. Stel met de beschikbare instellingen voor je agent en implementatie een bescheiden limiet in voor de uitvoeringsduur of het aantal stappen.

Geef de taak een concrete invoer, opdracht en resultaatindeling. Bijvoorbeeld:

Inspecteer de checkout in de geselecteerde werkmap.
Voer de bestaande lokale rooktestopdracht één keer uit.
Vermeld de opdracht, de afsluitstatus en de eerste mislukte test.
Meld die fout als de opdracht of map niet beschikbaar is.
Installeer geen afhankelijkheden, wijzig de repository niet en neem geen contact op met externe diensten.

Instructies sturen de agent aan. Beperkingen voor het bestandssysteem en het netwerk moeten afzonderlijk worden afgedwongen via de terminal- en containerconfiguratie. Controleer of een ontbrekende afhankelijkheid tot een duidelijke foutmelding leidt en niet tot een onverwachte installatie. De documentatie van Open WebUI is het startpunt voor terminal- en beheerdersinstellingen.

Wat moet je na de eerste uitvoering controleren?

Open het resulterende gesprek en controleer de identiteit van de agent, het werkpad, de testopdracht, de afsluitstatus en welke revisie is getest. Vergelijk het resultaat met een handmatige uitvoering van dezelfde opdracht in die terminal. Een voltooide automatisering laat alleen zien dat de workflow is afgerond. Het rapport moet nog steeds aantonen dat de bedoelde test daadwerkelijk is uitgevoerd.

Test bewust een foutscenario. Laat een testtaak verwijzen naar een onschadelijk ontbrekend invoerbestand of stop de tijdelijke terminal kort en bekijk de resulterende status. Zet de terminal na de test weer aan. Een beheerder moet een niet-beschikbare agent, een ontbrekende map, een mislukte test en een time-out van het model van elkaar kunnen onderscheiden zonder een volledig chatgesprek te lezen. Controleer of de volgende legitieme uitvoering niet ongemerkt verouderde uitvoer hergebruikt.

Houdt zelfhosting van Open WebUI code lokaal?

Open WebUI en de terminal kunnen zelfgehost zijn, terwijl de geselecteerde codeeragent een extern model gebruikt. Ga na waar de agent systeemprompts, fragmenten uit bestanden en testlogboeken naartoe stuurt. Controleer de providerconfiguratie voordat je een privérepository aansluit. Sla providergegevens op in de daarvoor bestemde geheime configuratie van de service en deel ze niet via prompts of logboeken.

Begin met een lokaal modeleindpunt als je eisen externe verwerking verbieden. Controleer het eindpunt en de terugvalconfiguratie van de agent en controleer vervolgens de netwerkbeperkingen die voor de terminal gelden. Gebruik voor meer informatie over het beperken van blootstelling deze gids voor AI-triage van kwetsbaarheden en geheimen.

Hoe maak je van een taak die alleen rapporten oplevert een terugkerende workflow?

Voeg, zodra je de eerste geslaagde en mislukte uitvoeringen allebei begrijpt, een terugkerend schema toe dat niet overlapt met andere taken die dezelfde directory gebruiken. Voorzie rapporten van een tijdstempel en de revisie van de repository. Houd waarschuwingen eenvoudig: meld fouten die actie vereisen en bewaar genoeg context om ze te kunnen reproduceren. Controleer regelmatig na upgrades of de agentgegevens, terminalverbinding en geplande directory nog werken.

Als je later patches toestaat, houd ze dan in een geïsoleerde branch en eis een beoordeling voordat je ze samenvoegt. Een nieuwe poging door de planner kan anders neveneffecten dupliceren. Een taak die alleen rapporten oplevert, is makkelijker opnieuw uit te voeren omdat die alleen een resultaat wegschrijft, terwijl afhankelijkheidsupdates en implementatieopdrachten de status wijzigen. Beschouw die overgang als een afzonderlijke machtigingsbeslissing.

Veelgestelde vragen

In welke versie zijn agentautomatiseringen toegevoegd?

De betreffende functie wordt vermeld in Open WebUI v0.13.3. De agentkiezerfunctie in v0.13.1 is verwant, maar staat er los van.

Waarom verschijnt de agent niet in de keuzelijst?

Controleer of de geselecteerde terminal bereikbaar is en aangeeft die agent te ondersteunen, en of je geïnstalleerde versie en accountmachtigingen de functie beschikbaar maken.

Kan ik een map op mijn laptop kiezen?

Kies een pad op de terminal waarop de taak daadwerkelijk wordt uitgevoerd. Koppel de checkout daar zo nodig aan of kopieer deze ernaartoe.

Wordt een automatiseringsresultaat naar een kanaal gestuurd?

In de opmerkingen bij v0.13.3 staat dat agentautomatiseringen resultaten via chat afleveren. Controleer de opties van de huidige versie voordat je vertrouwt op een andere bestemming dan die chat.

Wat moet ik doen als twee uitvoeringen elkaar overlappen?

Gebruik aparte worktrees of kies een schema en runtimebudget die overlap voorkomen. Controleer elke uitvoering met de verkeerde revisie voordat je het rapport vertrouwt.

Conclusie

Gebruik één terminal, één afgebakende werkdirectory en één kleine taak die alleen rapporten oplevert om het volledige proces te valideren. Controleer de modelprovider, test zowel succes als mislukking en houd productiegegevens buiten de terminal. Zodra het resultaat herhaalbaar is, kan dezelfde configuratie terugkerende repositorycontroles uitvoeren.