Dagelijks werk

De werkruimtebot gebruiken

Start Archibot in code-server en zet hem aan het werk: wat hij weet over je Archibus-omgeving, wat hij wel en niet kan, kant-en-klare prompts en hoe hij verschilt van Console-chat.

KlantledenKlantbeheerdersPlatformoperators

Laatst bijgewerkt 19 juni 2026

Elke Archibus-werkruimte wordt geleverd met Archibot, een beheerde AI-assistent die in de werkruimte draait en je Archibus-omgeving al begrijpt. Hij kan je code lezen, AXVW-weergaven valideren, alleen-lezen query’s uitvoeren tegen de werkruimtedatabase, dingen opzoeken in de Archibus-referentie en de actieve app aansturen — allemaal zonder dat je sleutels of context hoeft in te stellen. Deze handleiding is voor iedereen die in code-server werkt, wat je rol ook is.

Voor de rest van de omgeving eromheen — de editor, de app, de database — zie Werken in je werkruimte.

De bot starten

Je hebt twee manieren om binnen te komen:

• Terminal. Open een terminal in code-server (Terminal → New Terminal) en voer archibot start uit. Dat start een beheerde sessie — onder de motorkap is het een beheerde Codex CLI die is afgestemd op Archibus.
• Editorpaneel. Open het Archibot-paneel vanuit de zijbalk van de editor en typ in het berichtveld — geen terminal nodig. Start Archibot in het paneel begint een sessie.

Je hoeft niet in te loggen. De werkruimte bevat al een beheerde sleutel, dus de bot is klaar zodra de werkruimte dat is. Als archibot niet wordt gevonden, bevat je werkruimtesjabloon mogelijk geen beheerde Archibot — overleg met je accountbeheerder.

Chatten vanuit het editorpaneel

Blijf je liever in de editor in plaats van een terminal? Open het Archibot-paneel vanuit de zijbalk en gebruik het berichtveld onderaan. Het paneel heeft de modi Chat, Agent en Full Access: gebruik Chat voor vragen over het bestand of project waarin je zit, Agent om Archibot wijzigingen te laten maken in je werkruimte, en Full Access om hem ruimere toegang tot de werkruimte te geven. Hij praat met dezelfde beheerde bot, met dezelfde Archibus-vaardigheden, als de terminal — kies wat op het moment het beste past.

Wat hij weet en kan

Archibot is ingericht als de assistent van een Archibus- en WebCentral-ontwikkelaar. Standaard kan hij:

• Werken met AXVW-weergaven — een nieuwe weergave opzetten, een bestaande uitleggen en deze valideren tegen de Archibus-regels, met opgave van de specifieke problemen die je moet oplossen.
• De database veilig lezen — SELECT-achtige query’s uitvoeren tegen de werkruimtedatabase om schema te controleren, naar voorbeeldrijen te kijken of een datasource te bevestigen. Resultaten zijn rij-begrensd en respecteren weergavebeperkingen.
• Datasources, workflowregels en formulieren maken — en deze controleren tegen Archibus-conventies voordat je ze koppelt.
• Dingen opzoeken — de meegeleverde Archibus-referentie en producthelp doorzoeken in plaats van te gokken.
• De actieve app bekijken — de live app openen in een headless browser om te bevestigen dat een weergave wordt weergegeven of om een probleem te reproduceren.
• Build- en uitvoerklusjes afhandelen — logboeken lezen, Tomcat herstarten en je door uitrol- of migratiestappen leiden.

Hij stuurt werk door een grote bibliotheek met Archibus-vaardigheden (ruimte, assets, leases, verhuizingen, projecten, rapporten, beveiliging en meer), zodat hij doorgaans dezelfde patronen volgt die je team al gebruikt.

Wat hij niet zal doen

• Hij wijzigt de database niet. Zijn querytool is alleen-lezen — geen UPDATE, INSERT of DELETE. Schema- en gegevenswijzigingen lopen nog steeds via migraties en je normale beoordeling.
• Hij lekt geen geheimen. Providersleutels worden geredigeerd en het teruglezen van ruwe inloggegevens staat uit, en hij heeft de instructie om tokens, sleutels en ruwe klantgegevens buiten bestanden, notities en alles wat hij opslaat te houden. Houd je aan dezelfde lijn.
• Hij handelt op je werkruimtebestanden — beoordeel zijn bewerkingen zoals je die van een teamlid zou beoordelen voordat je commit.

Recepten

Concrete prompts om uit te proberen. Wees specifiek en wijs hem naar het bestand of de tabel die je bedoelt; hoe nauwkeuriger je bent, hoe beter het resultaat.

Een AXVW-weergave bouwen

“Maak een AXVW-weergave die ruimten toont voor een geselecteerd gebouw, met een gebouwfilter en kolommen voor ruimtenaam, oppervlakte en categorie. Valideer hem en los eventuele problemen op voordat je klaar bent.”

Een bestaande weergave valideren en repareren

“Valideer schema/ab-products/.../my-view.axvw en loods me door het oplossen van elke fout die je vindt.”

Gegevens inspecteren voordat je bouwt

“Toon me de kolommen van de rm-tabel en geef daarna 20 voorbeeldruimten terug met hun gebouw en verdieping.”

Een workflowregel toevoegen

“Voeg een workflowregel toe die de ruimtebeheerder e-mailt wanneer de categorie van een ruimte verandert, en toon me waar deze is geregistreerd.”

Aan een formulier werken

“Voeg op dit formulier een documentveld voor plattegronden toe en valideer de formulierbesturingselementen.”

Een datasource traceren

“Vind de datasource achter dit paneel en voeg een beperking toe zodat alleen actieve records worden getoond.”

Uitzoeken waarom een wijziging niet zichtbaar is

“Mijn weergavewijziging verschijnt niet in de app. Controleer de Tomcat-logboeken, vertel me wat er mis is en herstart Tomcat als dat de oplossing is.”

Bevestigen dat hij rendert

“Open de nieuwe ruimtelijst in de browser en bevestig dat hij zonder fouten laadt.”

Iets opzoeken

“Hoe behandelt Archibus multivaluta op leaserecords? Citeer de referentie.”

Naar beoordeling sturen

“Vat de wijzigingen die ik heb gemaakt samen en dien ze in voor CI-beoordeling.”

Die laatste gebruikt archibot-submit-review, dat je wijzigingen verpakt voor de CI Review-flow van Console — zie Persistente omgevingen en CI Review.

Validatie en database-opzoekingen lopen via de ingebouwde Archibus-tools van Archibot — hier valideert hij een AXVW-weergave:

Wanneer je hem vraagt iets te wijzigen, bewerkt Archibot de bestanden ter plekke en verschijnt de wijziging in Source Control, klaar voor jou om te beoordelen zoals elke andere bewerking.

Je sessie behouden

Een gesprek is gekoppeld aan de werkruimteruntime. Toon eerdere sessies met archibot sessions list en heropen er een met archibot start --session <name>; archibot start op zichzelf begint een nieuw gesprek. Een sessie overleeft een stop/start of rebuild van een werkruimte niet, dus wanneer de bot iets oplevert dat je belangrijk vindt — een samenvatting, een plan, een gegenereerd bestand — bewaar het: commit het naar git of kopieer het naar Shared Drive. Vertrouw niet op terugscrollen in een terminal die een herstart zal wissen.

Werkruimtebot versus Console-chat

Archibot bestaat ook als browserchat in Console (ArchibotChat gebruiken). Ze delen dezelfde vaardigheden en Archibus-kennis, maar ze werken op verschillende plekken:

• De werkruimtebot heeft handen op je werkruimte — hij leest je bestanden, voert query’s uit tegen je database, herstart je app en bewerkt code ter plekke.
• Console-chat is browsergebaseerd en geschikt voor vragen, planning en naslag wanneer je niet in een werkruimte zit.

Gebruik het een of het ander voor een bepaalde taak. Beide tegelijk inzetten voor hetzelfde werk verbruikt simpelweg dubbel zoveel credits.

Andere commando’s

• archibot status en archibot doctor — controleer of de beheerde sessie en de bijbehorende tooling gezond zijn.
• archibot capabilities — toon wat de beheerde bot in deze werkruimte kan.
• archibot skills list — bekijk de Archibus-vaardigheden die hem ter beschikking staan.
• archibot versions — toon de gebruikte beheerde tool- en imageversies.
• archibot feedback — stuur geanonimiseerde feedback naar het platformteam.
• archibot-v2, archibot-cc en cursor-agent — beheerde Cursor-achtige en Claude-achtige assistenten, als je die interfaces prefereert. Ze gebruiken dezelfde beheerde toegang.

Gerelateerde handleidingen

• Werken in je werkruimte — de editor, app, database en logboeken waartegen de bot werkt.
• ArchibotChat gebruiken — de browserchatversie en de bijbehorende contextbronnen.
• Werkruimte-Archibot en Shared Drive — waar je bewaart wat de bot oplevert.
• Persistente omgevingen en CI Review — wat er gebeurt nadat je wijzigingen ter beoordeling indient.
• Probleemoplossing — eerste stappen wanneer de bot of de app zich misdraagt.