Organisatie-instellingen¶

Deze pagina laat zien wat je op het scherm Instellingen van je organisatie kunt instellen, wie dat mag, welke grenzen de organisatie erboven stelt en wat je doet als een waarde wordt geweigerd. Je vindt het scherm onder Organisatiebeheer, Instellingen. De huisstijl van de organisatie staat op een eigen scherm: Huisstijl.

Wie wat mag¶

Het scherm lezen en wijzigen kan wie de organisatie mag beheren, dus een org-admin van de organisatie (Rollen beheren). Je ziet het scherm alleen als je de instellingen mag wijzigen.

De instellingen zijn van de organisatie zelf. De sectie Limieten is dat niet: die stelt een beheerder van de organisatie erboven. Zie Limieten van de organisatie erboven.

Algemeen¶

Tijdzone. De tijdzone waarin tijden in prompts worden gelezen. Vul een naam uit de lijst in, bijvoorbeeld Europe/Amsterdam. Een organisatie begint op UTC.

Gegevensbewaring¶

De termijn voor opnames geldt voor elke opname die er nog is. Verkort je hem, dan verwijdert OS binnen een uur de opnames die ouder zijn. Een lid kan zijn eigen opname altijd eerder verwijderen (Een overleg vastleggen met de notulist).

Het gebruik van de organisatie (hoeveel er is verbruikt) blijft altijd bewaard, ook als je hier iets kort instelt. Hoe lang precies, bepaalt de beheerder van OS, niet de organisatie.

Kies Instellingen opslaan om de algemene instellingen en de gegevensbewaring samen op te slaan.

Hulpmodel¶

Hulpmodel is het model dat een voorzet maakt als iemand bij Beschrijf wat je nodig hebt omschrijft wat hij nodig heeft, bijvoorbeeld de parameters van een tool in de AI Toolbox als JSON Schema. Kies een model uit de lijst, of kies Standaard volgen om de standaard van de installatie te gebruiken. Onder het veld staat welk model nu in gebruik is en of de organisatie het koos of het de standaard is. Is er geen model in gebruik, dan staat Beschrijf wat je nodig hebt uit.

Elke voorzet is een betaalde modelaanroep van de organisatie. Een voorzet wordt pas gebruikt als iemand hem overneemt en opslaat. Het hulpmodel sla je op met Instellingen opslaan. Mogen de beheerders van de organisatie geen sleutels beheren (zie Limieten), dan wordt een nieuwe keuze geweigerd.

Kosten¶

Wie kosten en tokengebruik ziet bepaalt wie bij een run in de AI Toolbox ziet hoeveel tokens die gebruikte en wat hij kostte in euro:

• Niemand. Niemand ziet kosten of tokengebruik. Zo begint elke organisatie.
• Alleen de beheerders van de organisatie. Wie deze instellingen mag wijzigen, ziet ze; de andere leden niet.
• Iedereen in de organisatie. Elk lid ziet de kosten van zijn eigen runs.

Wie de instellingen mag wijzigen, mag ook dit veld wijzigen, ook een beheerder van de organisatie erboven. Sla de keuze op met Instellingen opslaan. Wie de kosten niet mag zien, krijgt ze ook niet van OS: ze worden niet alleen verborgen op het scherm. Alleen met de sleutel die zijn eigen browser bij Artific Core gebruikt, kan iemand zijn eigen gebruik daar nog opvragen; OS toont dat niet.

Redacteuren van assistenten¶

Wie de rol assistant-editor heeft, wijzigt assistenten. Zonder meer zijn dat alle assistenten. Wil je dat de redacteuren van HR alleen de assistenten van HR wijzigen, kies dan een eigenschap, bijvoorbeeld afdeling, en geef elke assistent de waarden van die eigenschap waarvoor hij is:

curl -s -X PATCH "$OS/api/v1/organisations/$ORG/settings" -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json" -d '{"assistant_editor_attribute": "afdeling"}'
curl -s -X PATCH "$OS/api/v1/organisations/$ORG/assistants/$AGENT" \
    -H "Authorization: Bearer $TOKEN" -H "If-Match: $ETAG" \
    -H "Content-Type: application/json" -d '{"editor_scope": ["HR"]}'

Een redacteur met afdeling: HR wijzigt dan de assistenten met HR en die met everyone, en geen andere; ze geeft een assistent alleen haar eigen waarden of everyone. Een nieuwe assistent krijgt everyone. any is geen waarde van de gekozen eigenschap: OS weigert die. Kies je een andere eigenschap, dan houden de assistenten hun waarden; waarden die niemand meer heeft, bereiken alleen beheerders. null heft de keuze op.

Werken vanuit AI-apps¶

Een lid kan een AI-app zoals Claude Code, Claude Desktop of Cursor met OS verbinden en er met zijn eigen rechten mee werken: leden opzoeken, een assistent maken, een groep wijzigen. Het lid logt daarvoor in vanuit de app (hoe). Een AI-app werkt altijd met de rechten van de persoon die hem verbond, nooit met meer. Onder Wat AI-apps in deze organisatie mogen kies je wat zo'n app in deze organisatie kan:

• Uit. AI-apps kunnen niets in deze organisatie. Zo begint elke organisatie.
• Alleen lezen. Een AI-app mag bekijken wat de persoon zelf mag zien, maar niets wijzigen.
• Lezen en wijzigen. Een AI-app mag alles wat de persoon zelf mag, ook uitnodigen, wijzigen en verwijderen.

Sla de keuze op met Instellingen opslaan. De keuze geldt alleen voor deze organisatie, niet voor de organisaties eronder. Zet je haar op Uit, dan weigert OS de volgende aanroep van elke verbonden app meteen. De verbindingen blijven; zet je het weer aan, dan werken ze weer.

Wat de aanbieder van de app ziet: de aanbieder, zoals Anthropic of Cursor, krijgt te zien wat de app leest, net als wat iemand er zelf in plakt. Wat een app wijzigt, staat in het logboek met de naam van de persoon en van de app.

Welke leden een AI-app gebruiken. Onder Gebruikersbeheer, Leden toont de kolom AI-app welke app een lid het laatst in deze organisatie gebruikte, en filtert AI-app op leden met of zonder app. Kies in het menu van een lid AI-apps verbreken om de apps van dat lid te zien en er een te verbreken. Dat geldt alleen in deze organisatie: in de andere organisaties van het lid blijft de app werken. Dit kan wie de leden mag wijzigen.

Een eigen agent als serviceaccount. Een programma dat zelf MCP spreekt, kan als serviceaccount met OS werken. Op het tabblad Algemeen van het serviceaccount staat onder Gebruiken via MCP het MCP-adres, het Tokenadres en hoe de agent met de client-ID en het geheim van een sleutel een token ophaalt. Ook een serviceaccount krijgt elke aanroep geweigerd zolang deze instelling op Uit staat.

Limieten van de organisatie erboven¶

Onder Limieten staat wat de organisatie erboven voor deze organisatie bepaalt:

• Maandplafond (euro). Het meeste dat de organisatie per kalendermaand mag uitgeven. Leeg betekent: geen eigen plafond. Een plafond kan nooit hoger zijn dan dat van de organisatie erboven.
• Het plafond telt. Alleen deze organisatie, of deze organisatie en alle organisaties eronder.
• Blijf tellen wat een verwijderde organisatie gebruikte. Wat een organisatie onder deze verbruikte, blijft meetellen voor het plafond nadat die organisatie is verwijderd.
• Beheerders van deze organisatie mogen niet. Het gebruik van de organisatie inzien, het auditlog inzien, sleutels beheren. Een vinkje haalt dat recht bij de beheerders van de organisatie weg.

Voor de organisatie zelf zijn deze velden alleen te lezen, met de melding dat de organisatie erboven ze bepaalt. Ze veranderen kan alleen een beheerder van de organisatie erboven met bereik descendants (Rollen beheren), op het scherm Instellingen van de organisatie onder haar. De organisatie bovenaan de boom heeft geen organisatie erboven: haar limieten stelt de beheerder van OS. Kies Limieten opslaan om de limieten op te slaan.

Als een waarde wordt geweigerd¶

Een veld dat niet klopt, krijgt een melding bij het veld en er wordt niets opgeslagen. Dat gebeurt bijvoorbeeld bij een tijdzone die niet bestaat, een aantal dagen buiten het toegestane bereik, een bedrag dat geen bedrag is. Verbeter het veld en sla opnieuw op. Lukt opslaan niet om een andere reden, dan zie je de melding dat de instellingen niet konden worden opgeslagen; probeer het dan opnieuw.

Twee beheerders kunnen tegelijk verschillende velden wijzigen: beiden houden hun wijziging. Wijzigen ze hetzelfde veld, dan geldt de laatste.

Elke wijziging komt in het logboek, met wie wijzigde en vanuit welke organisatie, maar zonder de waarde.