Hoe je de AI-assistent instelt

Koppel Agon aan een AI-provider naar keuze, en de AI-ondersteuningsassistent, de AI-actiemodus en de antwoorden van de zakelijk adviseur gaan werken. De snelste manier is een gratis Google Gemini-API-sleutel, en dat kost ongeveer 3 minuten.

Hoe de AI-assistent in Agon werkt

Agon draait op je eigen computer, en de instelling van de AI-assistent ook. De assistent gebruikt een AI-providersleutel die van je studio is: je maakt de sleutel aan bij de provider, plakt hem in Agon, en Agon communiceert rechtstreeks met die provider. Agon beheert geen eigen AI-dienst, en er zit geen AI-dienst bij Agon inbegrepen.

Je hebt drie opties:

Optie	Wat je nodig hebt	Geschikt voor
Google Gemini (aanbevolen om mee te beginnen)	Een Google-account	Binnen een paar minuten aan de slag
Groq	Een Groq-account	Een alternatieve provider met snelle antwoorden
Een lokaal model met Ollama	Een redelijk krachtige computer	Alle prompts op je eigen machine houden

Als je niets instelt, werkt de assistent nog steeds in basismodus (zie hieronder).

Wat is basismodus?

Zonder AI-provider wordt het assistentpaneel een zoekfunctie in de documentatie. Je typt een paar trefwoorden en Agon toont de helpartikelen die het best passen, rechtstreeks uit deze documentatie. Basismodus:

• werkt volledig op je computer, zonder internetverbinding en zonder AI;
• kan geen vrije vragen beantwoorden, geen AI-acties uitvoeren en geen zakelijk advies geven;
• toont een knop AI instellen in Instellingen die je terugbrengt naar deze instelling.

Instellingen → AI-assistent toont Niet geconfigureerd · basismodus zolang er geen provider is gekoppeld.

Voordat je begint

• Alleen het studiomanager-account kan de AI-assistent instellen.
• Lees hieronder Privacy: waar je prompts naartoe gaan, vooral als je van plan bent klantgegevens in de chat te noemen.
• Behandel een API-sleutel als een wachtwoord. Iedereen die hem heeft, kan je account bij de provider gebruiken.

Maak in 3 minuten een Gemini-API-sleutel aan

1. Open de API-sleutelpagina van Google AI Studio in je browser en log in met je Google-account.
2. Klik op Create API key (Google noemt het misschien Get API key; met een Nederlandstalige interface is de naam vertaald). Vraagt Google je een project te kiezen of aan te maken, accepteer dan de standaardkeuze.
3. Klik op het kopieerpictogram naast je nieuwe sleutel. Het is een lange reeks letters en cijfers.
4. Open in Agon Instellingen → AI-assistent. [SCREENSHOT: Instellingen → AI-assistent met de providerlijst en het veld API-sleutel]
5. Kies onder AI-provider voor Google Gemini.
6. Plak de sleutel in het veld API-sleutel en klik op Verifiëren & opslaan.
7. Agon test de sleutel meteen bij Google. Werkt hij, dan zie je API-sleutel opgeslagen en geverifieerd. en een label Sleutel actief · Google Gemini.

Klaar: open de assistent en stel hem een vraag.

De schermen van Google veranderen af en toe. Heeft een knop een andere naam, zoek dan naar "API keys" in het menu van Google AI Studio. De link Haal een Google Gemini-API-sleutel op naast de providerlijst in Agon opent altijd de juiste pagina.

Groq gebruiken in plaats daarvan

1. Open de API-sleutelpagina van de Groq-console en log in of maak een account aan.
2. Klik op Create API Key, geef hem een naam (bijvoorbeeld "Agon") en kopieer de sleutel. Groq toont hem maar één keer.
3. Open in Agon Instellingen → AI-assistent, kies Groq onder AI-provider, plak de sleutel in API-sleutel en klik op Verifiëren & opslaan.

Een label Sleutel actief · Groq bevestigt dat het werkt.

Een lokaal model gebruiken met Ollama

Met Ollama draait het AI-model op je eigen computer, dus prompts verlaten die nooit. Je hebt een computer nodig met genoeg geheugen om een model te draaien. Antwoorden zijn meestal trager dan bij een cloudprovider, en de kwaliteit hangt af van het model dat je kiest. Dit is een geavanceerde optie.

1. Download en installeer Ollama via ollama.com en download daarna een model, bijvoorbeeld door ollama pull llama3.1 in een terminal uit te voeren. Ollama moet draaien wanneer je de assistent gebruikt.

2. Sluit Agon af.

3. Open de gegevensmap van Agon:

   • macOS: ~/Library/Application Support/Agon
   • Windows: %APPDATA%\Agon

4. Open het bestand .env in een teksteditor voor platte tekst (op macOS is het verborgen: druk in de Finder op Cmd + Shift + . om het te tonen). Wijzig of verwijder de regels die er al in staan niet: die bevatten de geheime sleutels die de gegevens van je studio beschermen. Voeg deze twee regels aan het einde toe, met de naam van het model dat je hebt gedownload:

   LLM_PROVIDER=ollama
   LLM_MODEL=ollama_chat/llama3.1

5. Sla het bestand op en start Agon opnieuw.

Instellingen → AI-assistent toont nu Actief · lokaal model. Sla je later een providersleutel op met In plaats daarvan je eigen providersleutel gebruiken, dan krijgt die sleutel voorrang op het lokale model.

Privacy: waar je prompts naartoe gaan

• Rechtstreeks van je computer naar de provider die je hebt gekozen. Als je Gemini of Groq gebruikt, gaan je vraag en de informatie die de assistent nodig heeft om te antwoorden rechtstreeks van de computer waarop Agon draait naar die provider. Ze gaan nooit via de ontwikkelaar van Agon of via een server die voor Agon wordt beheerd.
• Met Ollama verlaat er niets je computer.
• Je sleutel blijft op je computer. Agon slaat hem versleuteld op in de lokale database van je studio en toont hem na het opslaan nooit meer. Sleutel verwijderen in Instellingen → AI-assistent wist hem op elk moment.
• Gratis niveaus kunnen je gegevens gebruiken. Bij sommige providers kunnen gratis niveaus de gegevens die je verstuurt gebruiken om hun modellen te trainen of te verbeteren. Gebruik voor vragen met gegevens van je klanten een betaald niveau of een lokaal model. Voorwaarden veranderen, dus controleer de actuele voorwaarden en het privacybeleid van je provider voordat je begint: voorwaarden van de Gemini-API · privacybeleid van Groq.
• Je studio houdt de regie. Je studio heeft de overeenkomst met de provider, dus onder de AVG is die provider een verwerker van je studio. De AVG-gids legt uit wat dat voor je betekent.

Een goede gewoonte: plak geen gevoelige klantgegevens (bijvoorbeeld gezondheidsnotities) in de chat, tenzij je je prettig voelt bij de voorwaarden van je provider.

Als je intensief gebruik verwacht

Elke provider beperkt hoeveel verzoeken een sleutel per minuut en per dag mag doen. Gratis niveaus hebben lage limieten. Als meerdere mensen de assistent tegelijk gebruiken, of als je de AI-actiemodus op drukke momenten gebruikt, kun je een melding zien dat je AI-provider verzoeken beperkt.

Los dit op door je limieten bij de provider te verhogen:

• Google Gemini: schakel facturering in voor het Google Cloud-project waar je sleutel bij hoort. Google AI Studio toont je huidige niveau en hoe je kunt upgraden.
• Groq: bekijk je limieten en upgrademogelijkheden in de Groq-console.

Dezelfde sleutel blijft na de upgrade werken in Agon. Je hebt geen nieuwe sleutel nodig en er hoeft niets te veranderen in Agon. De provider factureert alles boven zijn gratis niveau rechtstreeks aan jou. Een betaald niveau is ook de aanbevolen keuze voor klantgegevens (zie het privacygedeelte hierboven).

Wat als er iets misgaat?

Agon zegt dat mijn sleutel ongeldig is Controleer of je de hele sleutel zonder extra spaties hebt gekopieerd en of de gekozen provider bij de sleutel past: een Groq-sleutel werkt niet als Gemini-sleutel. Zorg dat de sleutel niet is verwijderd in de console van de provider. Een gloednieuwe sleutel kan een minuut nodig hebben voordat hij werkt, dus wacht even en klik opnieuw op Verifiëren & opslaan.

De assistent zegt dat mijn AI-provider verzoeken beperkt Je hebt de limiet van je provider bereikt. Wacht een minuut en probeer het opnieuw, of verhoog je limieten (zie Als je intensief gebruik verwacht).

De assistent toont alleen helpartikelen De assistent staat in basismodus omdat er geen provider is gekoppeld. Volg de stappen hierboven om een sleutel toe te voegen. Instellingen → AI-assistent toont Niet geconfigureerd · basismodus als er geen provider actief is.

Ik krijg midden in een actie "Voor deze actie is Agon AI nodig, maar dat staat uit" De AI-actiemodus kan een verzoek niet afronden zonder provider. Voeg een sleutel toe in Instellingen → AI-assistent en vraag het dan opnieuw.

Mijn sleutel werkte en nu faalt de assistent De sleutel is misschien verwijderd, verlopen of zijn quotum is op aan de kant van de provider. Maak een nieuwe sleutel aan en sla die op met Wijzigen in Instellingen → AI-assistent.

Ik wil van provider wisselen of mijn sleutel vervangen Klik in Instellingen → AI-assistent op Wijzigen naast het label Sleutel actief, kies de provider, plak de nieuwe sleutel en klik op Verifiëren & opslaan.

Ik wil mijn sleutel niet meer gebruiken Klik in Instellingen → AI-assistent op Sleutel verwijderen en bevestig. Agon verwijdert de sleutel uit de database van je studio en de assistent schakelt meteen over naar basismodus, zonder herstart. Denk je dat de sleutel mogelijk is uitgelekt, verwijder (trek in) hem dan ook in de console van je provider (Google AI Studio of de Groq-console), zodat niemand anders hem kan gebruiken.

Het lokale model werkt niet Controleer of Ollama draait en of de modelnaam in het bestand .env overeenkomt met een model dat je hebt gedownload (ollama list toont ze). Start Agon opnieuw na elke wijziging in het bestand .env.

Veelgestelde vragen

Kost de AI-assistent iets? Agon rekent er niets voor. Je provider mogelijk wel: gratis niveaus hebben gebruikslimieten, en alles daarboven factureert de provider rechtstreeks aan jou.

Kan de ontwikkelaar van Agon mijn vragen zien? Nee. Prompts gaan van je computer rechtstreeks naar de provider die je hebt gekozen, of blijven op je computer met Ollama.

Welke provider moet ik kiezen? Gemini is het snelst ingesteld. Voor klantgegevens is een betaald niveau van welke provider dan ook, of een lokaal model, de veiligere keuze.

Gerelateerde pagina's

• AI-ondersteuningsassistent
• AI-actiemodus
• AVG-gids voor studiomanagers
• Instellingen