Configuratiesleutels

Aivie leest zijn instellingen uit de gewone ASP.NET Core-configuratie, voornamelijk onder de sectie Aivie. Deze pagina somt elke sleutel op met zijn standaardwaarde en waar je hem kunt instellen.

Een instelling kan uit drie plaatsen komen. De laatste met een waarde wint:

1. De standaardwaarde in Aivie, zoals vermeld op deze pagina.
2. Je configuratie: appsettings.json, appsettings.{Environment}.json, omgevingsvariabelen of elke andere configuratiebron van je site. Schrijf in een omgevingsvariabele __ waar de sleutel een dubbele punt heeft, bijvoorbeeld Aivie__Media__FolderName.
3. Het tabblad Instellingen bij Installatie, waar een lid van Aivie-admin een waarde kan wijzigen. Die wordt bewaard in de Aivie-database en wint van je configuratie.

De kolom Waar instellen zegt welke hiervan een sleutel ondersteunt:

• Installatiescherm: het installatiescherm vraagt om de waarde en schrijft hem naar je configuratie. Zie Installatiescherm.
• Tabblad Instellingen: het tabblad Instellingen bij Installatie. Je kunt de sleutel ook in je configuratie zetten. De kolom Betekenis begint met het label dat het tabblad toont, in vet. Het tabblad groepeert de instellingen onder de kopjes Ideeëngenerator, Pagina-opbouw, Beeld en media, Zoekwoorden, Databronnen, Chat en Systeem. Druk naast een waarde op Terug naar standaard om weg te halen wat je daar hebt ingesteld.
• Alleen appsettings: Aivie heeft geen scherm voor deze sleutel. Stel hem in je configuratie in.

Lijsten, zoals de drie woorden in NonImageMediaHints, schrijf je in je configuratie als JSON-array en op het tabblad Instellingen als een lijst met komma's ertussen.

waarschuwing

Geheimen horen in je configuratie of in omgevingsvariabelen, en nooit in versiebeheer. Deze sleutels bevatten een geheim: Umbraco:AI:Secrets:OpenAiKey, Aivie:DataForSeo:Password, Aivie:Competitors:CronSecret en Aivie:GoogleSearchConsole:ServiceAccountKey. Het installatiescherm en het uploaden van de sleutel op het tabblad Instellingen schrijven ze als platte tekst naar appsettings.{Environment}.json in de content root. Houd dat bestand buiten versiebeheer, of verplaats de waarden naar omgevingsvariabelen of een secret store.

Installatie en verbinding

De sleutels die Aivie met OpenAI en met je eigen site verbinden.

Sleutel	Standaard	Waar instellen	Betekenis
Umbraco:AI:Secrets:OpenAiKey	geen	Installatiescherm, of alleen appsettings	Je OpenAI API-sleutel. De Aivie-verbinding in Umbraco.AI verwijst naar deze sleutel in plaats van hem op te slaan. Geheim. Hij wordt bij het opstarten gelezen, dus herstart de site na een wijziging.
Aivie:BaseUrl	geen	Installatiescherm (het veld Publieke URL), of alleen appsettings	Het publieke adres van je site, bijvoorbeeld https://www.example.com. Aivie geeft het door aan de licentieserver als het de licentie verlengt. Laat het op een live site niet op localhost staan: de licentie wordt dan niet verlengd.
Aivie:Competitors:CronSecret	gegenereerd	Installatiescherm	Een willekeurig geheim dat het installatiescherm schrijft als er nog geen is. Geen van de functies uit deze documentatie leest het. Laat het zoals het is. Geheim.
Aivie:Context:DocumentRoot	App_Data/AivieContext	Tabblad Instellingen	Map met contextdocumenten. De map die de contextdocumenten bevat. Een relatief pad wordt gezocht onder de content root van de site.
Aivie:AiStatus:CronExpression	leeg; dan draait 15 6 * * *	Alleen appsettings	Wanneer de dagelijkse controle van de AI-verbinding draait, in UTC. Zie Geplande taken.
Umbraco:AI:AuditLog:PersistPrompts	het installatiescherm zet false	Installatiescherm, of alleen appsettings	Of de auditlog van Umbraco.AI de volledige prompt opslaat. Zonder deze sleutel slaat Umbraco.AI hem op. Het installatiescherm zet hem uit, zodat je inhoud niet in een logtabel terechtkomt.
Umbraco:AI:AuditLog:PersistResponses	het installatiescherm zet false	Installatiescherm, of alleen appsettings	Hetzelfde voor het volledige antwoord van de AI.

Ideeën

De sleutels van de ideeëngenerator. Zie Ideeëngenerator voor wat ze in de praktijk doen. Op het tabblad Instellingen staan ze in de groepen Ideeëngenerator, Pagina-opbouw en Beeld en media.

Sleutel	Standaard	Waar instellen	Betekenis
Aivie:Ideas:AgentAlias	aivie-ideeen	Tabblad Instellingen	Agent voor ideeën. De alias van de agent, onder AI → Agents, die de ideeën schrijft.
Aivie:Ideas:TitleAgentAlias	leeg	Tabblad Instellingen	Agent voor onderwerpen. De agent die de onderwerpen voorstelt. Is hij leeg, dan doet de ideeënagent dit.
Aivie:Ideas:TranslationAgentAlias	leeg	Tabblad Instellingen	Agent voor vertalen. De agent die ideeën vertaalt. Is hij leeg, dan doet de ideeënagent dit.
Aivie:Ideas:JobEnabled	true	Tabblad Instellingen	Maandelijkse ideeëntaak aan. Of de geplande ideeëntaak ideeën maakt. Zet hem uit op een staging- of testkopie van een live site. De knop Automatisch genereren blijft werken. Zie Achtergrondtaken.
Aivie:IdeaClusters:DocTypeAliases	leeg	Tabblad Instellingen	Doctypes die als ideeëngroep kunnen dienen. De documenttypes die een ideeëngroep kan aanmaken. Zolang je er niet minstens één kiest, is de lijst met contenttypes in het venster voor een nieuwe ideeëngroep leeg.
Aivie:Ideas:MaxClustersPerRun	0	Tabblad Instellingen	Groepen per run. Hoeveel ideeëngroepen één uitvoering behandelt. Groepen die niet kunnen meedoen, vallen eerst af. 0 betekent alle groepen.
Aivie:Ideas:MaxIdeasPerRun	0	Tabblad Instellingen	Maximaal aantal ideeën per run. Een noodrem op het totaal van één uitvoering, over alle groepen heen. 0 is geen maximum. Een lage waarde begrenst de hele maand, wat je pakket ook toestaat.
Aivie:Ideas:TitleCandidates	0	Tabblad Instellingen	Aantal voorgestelde onderwerpen. Hoeveel onderwerpen per aanroep worden voorgesteld. Bij 0 kiest Aivie zelf: drie keer wat de ronde nodig heeft, minstens vijf.
Aivie:Ideas:MaxTitleLength	70	Tabblad Instellingen	Maximale titellengte. Het maximale aantal tekens van een titel. Langere voorstellen vallen af. Bij 0 staat de controle uit.
Aivie:Ideas:MinBodyWords	300	Tabblad Instellingen	Minimaal aantal woorden. Het minimale aantal woorden van een idee, over alle blokken samen. Een korter idee gaat in een reparatieronde terug naar de agent; is het na de laatste ronde nog te kort, dan blijft het bewaard. Bij 0 staat de controle uit.
Aivie:Ideas:RepairAttempts	2	Tabblad Instellingen	Reparatierondes. Hoe vaak een afgewezen idee met de bezwaren terug naar de agent gaat. Bij 0 staat repareren uit.
Aivie:Ideas:MaxExistingIdeas	50	Tabblad Instellingen	Bestaande ideeën in de briefing. Hoeveel bestaande ideeën de generator te zien krijgt, zodat hij zichzelf niet herhaalt.
Aivie:Ideas:PublishTimeOfDay	09:00:00	Tabblad Instellingen	Publicatietijd (UTC). Het tijdstip waarop een ingepland idee live gaat.
Aivie:Ideas:DefaultParentPath	leeg	Tabblad Instellingen	Standaard bovenliggende pagina. Waar ideeën worden geplaatst als de ideeëngroep zelf geen pagina kiest, als pad van namen zoals Blog of About us/Blogs. Is dit leeg, dan draait een groep zonder eigen bovenliggende pagina niet.
Aivie:Ideas:HideFromMenuPropertyAlias	umbracoNaviHide	Tabblad Instellingen	Property die een pagina uit het menu houdt. Leeg zet het uit. Er gebeurt niets als het paginatype zo'n property niet heeft.
Aivie:Ideas:ShowInSitemapPropertyAlias	ShowInSitemap	Tabblad Instellingen	Property voor de sitemap. De property die een nieuwe pagina in de sitemap zet. Leeg zet het uit.
Aivie:Ideas:MaxLinkTargets	60	Tabblad Instellingen	Aantal linkdoelen. Hoeveel bestaande pagina's worden aangeboden als linkdoel. Bij 0 staat het uit.
Aivie:Ideas:IncludeExamplePage	true	Tabblad Instellingen	Voorbeeldpagina meesturen. Of de opbouw van een voorbeeldpagina met elk idee meegaat. Je kiest de voorbeeldpagina's per ideeëngroep. Kies je er geen, dan neemt Aivie de pagina's met de meest gevarieerde opbouw.
Aivie:Ideas:MaxExampleBlocks	25	Tabblad Instellingen	Blokken uit de voorbeeldpagina. Hoeveel blokken van een voorbeeldpagina worden gelezen voor de opbouw ervan.
Aivie:Ideas:ButtonClass	button	Tabblad Instellingen	CSS-klasse voor knoppen. De klasse die een call-to-action in rich text tot een knop maakt. Leeg zet het uit.
Aivie:Ideas:MenuItemTypeAliases	menuItem	Tabblad Instellingen	Doctypes die alleen doorverwijzen. De documenttypes die alleen naar een andere plek doorverwijzen. Lijst met aliassen.
Aivie:Ideas:MenuItemLinkProperties	linkTo, link, url	Tabblad Instellingen	Properties met de bestemming. De properties van zo'n paginatype die de bestemming bevatten, in volgorde van voorkeur.
Aivie:Ideas:MaxMediaCandidates	40	Tabblad Instellingen	Aantal aangeboden afbeeldingen. Hoeveel afbeeldingen uit de mediamap aan de agent worden aangeboden om uit te kiezen.
Aivie:Ideas:NonImageMediaHints	video, movie, film	Tabblad Instellingen	Woorden die een mediaveld geen afbeelding maken. Een mediaveld met een van deze woorden in zijn naam of alias telt als video, niet als afbeelding.
Aivie:Ideas:CronExpression	0 2 1 * *	Alleen appsettings	Wanneer de maandelijkse ideeëntaak draait, in UTC. Hij wordt genegeerd als ScheduleFrequency niet Cron is. Zie Geplande taken.
Aivie:Ideas:ScheduleFrequency	Cron	Tabblad Instellingen (Wijzigen)	Cron gebruikt CronExpression zoals hij is. Hourly, Daily, Weekly of Monthly leiden de expressie af van de drie sleutels hieronder.
Aivie:Ideas:ScheduleTime	02:00:00	Tabblad Instellingen (Wijzigen)	Het tijdstip van de taak in UTC. Bij Hourly tellen alleen de minuten.
Aivie:Ideas:ScheduleDayOfWeek	Monday	Tabblad Instellingen (Wijzigen)	De dag van een Weekly-taak.
Aivie:Ideas:ScheduleDayOfMonth	1	Tabblad Instellingen (Wijzigen)	De dag van een Monthly-taak. Een waarde boven 28 wordt 28.

Media

De sleutels voor de mediamap en voor beeldgeneratie. Op het tabblad Instellingen staan ze in de groep Beeld en media.

Sleutel	Standaard	Waar instellen	Betekenis
Aivie:Media:FolderName	Aivie AI afbeeldingen	Tabblad Instellingen	Mediamap. De map in de mediabibliotheek waarin Aivie afbeeldingen opslaat en waaruit het ze kiest. Het installatiescherm maakt de map aan als die nog niet bestaat.
Aivie:Media:ImageProfileAlias	leeg	Tabblad Instellingen	Profiel voor beeldgeneratie. De alias van het Umbraco.AI-profiel dat de afbeeldingen tekent. Is hij leeg, dan gebruikt Aivie het standaard beeldprofiel.
Aivie:Media:GenerateSize	auto	Tabblad Instellingen	Formaat bij het model. auto neemt het breedste liggende formaat dat het model biedt. Een vast formaat schrijf je als 1792x1024.
Aivie:Media:OutputWidth	0	Tabblad Instellingen	Opslagbreedte. De breedte waarop het bestand wordt opgeslagen. Bij 0 wordt de afbeelding opgeslagen zoals het model hem aanlevert.
Aivie:Media:OutputHeight	0	Tabblad Instellingen	Opslaghoogte. De hoogte waarop het bestand wordt opgeslagen. Bij 0 wordt de afbeelding opgeslagen zoals het model hem aanlevert. Met een breedte en een hoogte wordt de afbeelding vanuit het midden bijgesneden op die verhouding en daarna geschaald.
Aivie:Media:MaxStyleSamples	6	Tabblad Instellingen	Afbeeldingen voor het afleiden van de beeldstijl. Hoeveel afbeeldingen maximaal naar het model gaan als het de beeldstijl afleidt.
Aivie:Media:DiscardWindowMinutes	120	Tabblad Instellingen	Vervangtermijn in minuten. Hoeveel minuten na het aanmaken een gegenereerde afbeelding nog door de chat kan worden vervangen.
Umbraco:AI:Experimental:ImageGeneration	uit; het installatiescherm zet true	Installatiescherm, of alleen appsettings	Beeldgeneratie is een experimentele functie van Umbraco.AI. Zonder deze sleutel doet ze niets. Hij wordt bij het opstarten gelezen, dus herstart de site na een wijziging.

Zoekwoorden

De sleutels van de zoekwoordgenerator en van DataForSeo, dat zoekvolume, moeilijkheid en kosten per klik levert. Zie Zoekwoorden, Search Console en DataForSeo. Op het tabblad Instellingen staan ze in de groep Zoekwoorden.

Sleutel	Standaard	Waar instellen	Betekenis
Aivie:Keywords:AgentAlias	aivie-keywords	Tabblad Instellingen	Agent voor zoekwoorden. De alias van de agent die de zoekwoorden bedenkt.
Aivie:Keywords:DefaultCount	20	Tabblad Instellingen	Standaard aantal. Hoeveel zoekwoorden worden gegenereerd als het verzoek geen aantal noemt.
Aivie:Keywords:MaxExistingKeywords	0	Tabblad Instellingen	Bestaande zoekwoorden in de briefing. Hoeveel opgeslagen zoekwoorden de agent in de briefing te zien krijgt. Bij 0 staat het uit, omdat de zoekwoordencontext dit al doet.
Aivie:Keywords:IncludeSiteProfile	false	Tabblad Instellingen	Bedrijfsgegevens meesturen. Of de bedrijfsgegevens uit de algemene instellingen een tweede keer aan de briefing worden toegevoegd. Uit, omdat de resource met de Aivie-instellingen ze al levert.
Aivie:DataForSeo:Login	geen	Installatiescherm, of alleen appsettings	Je DataForSeo-login. Zonder login en wachtwoord blijven de kolommen voor volume, moeilijkheid en CPC leeg.
Aivie:DataForSeo:Password	geen	Installatiescherm, of alleen appsettings	Je DataForSeo-wachtwoord. Geheim.
Aivie:DataForSeo:BaseUrl	https://api.dataforseo.com	Alleen appsettings	Het adres van de DataForSeo-API. Je laat het normaal zoals het is.

Search Console

De sleutels van de koppeling met Google Search Console. Zie Zoekwoorden, Search Console en DataForSeo voor de stappen. Op het tabblad Instellingen staan ze in de groep Zoekwoorden.

Sleutel	Standaard	Waar instellen	Betekenis
Aivie:GoogleSearchConsole:SiteUrl	geen	Tabblad Instellingen	Site-URL in Search Console. De Search Console-property waarvan Aivie de gegevens leest. Een domeinproperty schrijf je als sc-domain:example.com en gaat ongewijzigd naar Google. Nadat je een sleutel hebt geüpload, laat het tabblad Instellingen je hem uit een lijst kiezen.
Aivie:GoogleSearchConsole:ServiceAccountKey	geen	Tabblad Instellingen (upload)	Serviceaccountsleutel. De inhoud van het JSON-sleutelbestand van het Google-serviceaccount. Je uploadt het bestand op het tabblad Instellingen, en Aivie schrijft de inhoud naar je configuratie en toont hem nooit meer. Geheim.
Aivie:GoogleSearchConsole:ServiceAccountKeyPath	geen	Tabblad Instellingen, of alleen appsettings	Pad naar het serviceaccountbestand. De oudere manier: een pad naar het sleutelbestand op de server. Het blijft werken, maar een geüploade sleutel gaat voor, en het tabblad Instellingen verbergt dit veld zodra er een sleutel is geüpload.

Databronnen

De sleutels voor de crawl van databronnen, het schema ervan en de tekst van databronnen die in een agentcontext wordt geschreven. Zie Databronnen. De sleutels gebruiken nog de oudere naam Competitors. Op het tabblad Instellingen staan ze in de groep Databronnen.

Sleutel	Standaard	Waar instellen	Betekenis
Aivie:Competitors:Crawl:MaxPages	200	Tabblad Instellingen	Pagina's per crawl. Het maximale aantal pagina's dat één crawl ophaalt, ook als er nog meer links openstaan.
Aivie:Competitors:Crawl:MaxConcurrency	2	Tabblad Instellingen	Gelijktijdige aanvragen. Hoeveel pagina's tegelijk worden opgehaald.
Aivie:Competitors:Crawl:DelayMs	500	Tabblad Instellingen	Wachttijd tussen aanvragen (ms). De pauze in milliseconden voor elke aanvraag.
Aivie:Competitors:Crawl:MaxDepth	5	Tabblad Instellingen	Maximale diepte. Hoeveel klikken vanaf de startpagina de crawl volgt. 0 is onbeperkt.
Aivie:Competitors:Crawl:RespectRobots	true	Tabblad Instellingen	robots.txt respecteren. Of de crawl zich aan de robots.txt van de site houdt.
Aivie:Competitors:CronExpression	leeg; dan draait 0 2 * * *	Alleen appsettings	Wanneer de geplande crawl draait, in UTC. Hij wordt genegeerd als ScheduleFrequency niet Cron is. Zie Geplande taken.
Aivie:Competitors:ScheduleFrequency	Cron	Tabblad Instellingen (Wijzigen)	Cron gebruikt CronExpression zoals hij is. Hourly, Daily, Weekly of Monthly leiden de expressie af van de drie sleutels hieronder.
Aivie:Competitors:ScheduleTime	02:00:00	Tabblad Instellingen (Wijzigen)	Het tijdstip van de crawl in UTC. Bij Hourly tellen alleen de minuten.
Aivie:Competitors:ScheduleDayOfWeek	Monday	Tabblad Instellingen (Wijzigen)	De dag van een Weekly-crawl.
Aivie:Competitors:ScheduleDayOfMonth	1	Tabblad Instellingen (Wijzigen)	De dag van een Monthly-crawl. Een waarde boven 28 wordt 28.
Aivie:Competitors:Context:Enabled	false	Tabblad Instellingen	Gecrawlde inhoud in een agentcontext zetten. Of elke crawl de tekst van databronnen in een agentcontext schrijft. Uit, zodat er niets ongevraagd bij de agents komt.
Aivie:Competitors:Context:ContextAlias	aivie-datasources	Tabblad Instellingen	Context-alias. De alias van de context, onder AI → Contexts, die de tekst ontvangt. De context moet al bestaan.
Aivie:Competitors:Context:InjectionMode	Always	Tabblad Instellingen	Injectiemodus. Always of OnDemand. Het geldt alleen voor resources die nieuw worden aangemaakt. Met Always gaat de tekst mee met elk verzoek.
Aivie:Competitors:Context:MaxPagesPerDomain	25	Tabblad Instellingen	Pagina's per databron. Hoeveel van de laatst gewijzigde pagina's per databron in de tekst terechtkomen.
Aivie:Competitors:Context:MaxCharactersPerPage	6000	Tabblad Instellingen	Tekens per pagina. Het maximale aantal tekens per pagina.
Aivie:Competitors:Context:MaxCharactersTotal	20000	Tabblad Instellingen	Tekens per databron in totaal. Het maximale aantal tekens per databron.

Chat

De sleutels voor de chatgeschiedenis. Zie Chat en chatgeschiedenis. Op het tabblad Instellingen staan ze in de groep Chat.

Sleutel	Standaard	Waar instellen	Betekenis
Aivie:ChatHistory:Enabled	false	Tabblad Instellingen	Gespreksgeschiedenis bewaren. Of gesprekken worden bewaard en weer kunnen worden opgepakt.
Aivie:ChatHistory:AutoResumeLatest	false	Tabblad Instellingen	Laatste gesprek automatisch hervatten. Of het eerste bericht in een verse zijbalk verdergaat in het laatste gesprek.
Aivie:ChatHistory:MaxConversationsPerUser	5	Tabblad Instellingen	Gesprekken per gebruiker. Hoeveel gesprekken per gebruiker worden bewaard. Oudere worden verwijderd als er nieuwe beginnen.
Aivie:ChatHistory:MaxMessagesPerConversation	40	Tabblad Instellingen	Berichten per gesprek. Hoeveel berichten per gesprek worden bewaard. De oudste vallen af.
Aivie:ChatHistory:MaxMessageLength	4000	Tabblad Instellingen	Maximale berichtlengte. Het langste bericht dat wordt opgeslagen, in tekens. Langere berichten worden afgekapt.
Aivie:ChatHistory:RetentionDays	30	Tabblad Instellingen	Bewaartermijn in dagen. Hoeveel dagen gesprekken worden bewaard. Bij 0 staat de leeftijdsgrens uit.
Aivie:ChatHistory:MaxRestoredMessages	12	Tabblad Instellingen	Herstelde berichten. Hoeveel berichten het model terugkrijgt als een gesprek wordt hervat.
Aivie:ChatHistory:ResumeRequestMinutes	5	Tabblad Instellingen	Geldigheid van een hervatverzoek in minuten. Hoeveel minuten een verzoek om een gesprek te hervatten geldig blijft.

De instellingengroep voor de chat heeft ook twee schakelaars voor diagnose, Agentverkeer loggen en Testmomentopname injecteren, die hier niet staan. Laat ze uit op een live site.

Licentie

De sleutels voor de licentie. Zie Licentie en proefperiode.

Sleutel	Standaard	Waar instellen	Betekenis
Aivie:License:Key	geen	Alleen appsettings	Een licentiesleutel die je met een uitrol meegeeft. Normaal vul je de sleutel in op het licentiescherm. Staat er een sleutel in de database én hier, dan wordt de meest recent uitgegeven gebruikt.
Aivie:License:RefreshHours	24	Alleen appsettings	Hoeveel uur er tussen twee verlengingen van de licentie bij de licentieserver zit. Aivie voegt tot een uur willekeurige spreiding toe. De laagste waarde is 1.

Verouderde sleutels

Een oudere Aivie bewaarde een aantal instellingen in de root van de configuratie. Aivie leest die plekken nog als de nieuwe sleutel of sectie niet bestaat of leeg is, en schrijft bij het opstarten een waarschuwing in het log die elke nog gebruikte oude sleutel noemt. Verplaats ze naar de nieuwe sleutel voordat een latere versie ze niet meer leest. Een verse installatie schrijft alleen de nieuwe sleutels.

Oude sleutel	Gebruik in plaats daarvan
GoogleSearchConsole (de hele sectie)	Aivie:GoogleSearchConsole
DataForSeo:BaseUrl, DataForSeo:Login, DataForSeo:Password	Aivie:DataForSeo:BaseUrl, Aivie:DataForSeo:Login, Aivie:DataForSeo:Password
Aivie:Ideas:MediaFolderName	Aivie:Media:FolderName. Bij het opstarten wordt de waarde overgenomen als de nieuwe sleutel leeg is. Hiervoor komt geen waarschuwing.

Deze sleutels worden helemaal niet meer gelezen. De crawl van databronnen draait nu binnen je site, in plaats van in een aparte sitewatcher-service. Ze doen geen kwaad, maar Aivie waarschuwt bij het opstarten dat ze weg kunnen:

• Aivie:Sitewatcher en AivieSitewatcher
• Aivie:Competitors:CompetitorPostUrl
• Aivie:Competitors:ApiKey