So richtest du den KI-Assistenten ein

Verbinde Agon mit einem KI-Anbieter deiner Wahl, und der KI-Support-Assistent, der KI-Aktionsmodus und die Antworten der Geschäftsberatung funktionieren. Am schnellsten geht es mit einem kostenlosen Google-Gemini-API-Schlüssel, und das dauert etwa 3 Minuten.

So funktioniert der KI-Assistent in Agon

Agon läuft auf deinem eigenen Computer, und das gilt auch für die Einrichtung des KI-Assistenten. Der Assistent nutzt einen KI-Anbieter-Schlüssel, der deinem Studio gehört: Du erstellst den Schlüssel beim Anbieter, fügst ihn in Agon ein, und Agon kommuniziert direkt mit diesem Anbieter. Agon betreibt keinen eigenen KI-Dienst, und es ist kein KI-Dienst in Agon enthalten.

Du hast drei Möglichkeiten:

Option	Was du brauchst	Gut für
Google Gemini (zum Einstieg empfohlen)	Ein Google-Konto	In wenigen Minuten loslegen
Groq	Ein Groq-Konto	Einen alternativen Anbieter mit schnellen Antworten
Ein lokales Modell mit Ollama	Einen ausreichend leistungsstarken Computer	Alle Prompts auf deinem eigenen Rechner behalten

Wenn du nichts einrichtest, funktioniert der Assistent trotzdem im Basismodus (siehe unten).

Was ist der Basismodus?

Ohne KI-Anbieter wird das Assistenten-Panel zu einer Dokumentationssuche. Du gibst ein paar Stichwörter ein und Agon zeigt die am besten passenden Hilfeartikel direkt aus dieser Dokumentation. Der Basismodus:

• läuft vollständig auf deinem Computer, ohne Internetverbindung und ohne KI;
• kann keine frei formulierten Fragen beantworten, keine KI-Aktionen ausführen und keine Geschäftsratschläge geben;
• zeigt eine Schaltfläche KI in den Einstellungen einrichten, die dich zu dieser Einrichtung zurückbringt.

Einstellungen → KI-Assistent zeigt Nicht konfiguriert · Basismodus, solange kein Anbieter verbunden ist.

Bevor du beginnst

• Nur das Studio-Manager-Konto kann den KI-Assistenten einrichten.
• Lies unten Datenschutz: Wohin deine Prompts gehen, besonders wenn du im Chat Angaben zu Kunden machen willst.
• Behandle einen API-Schlüssel wie ein Passwort. Wer ihn hat, kann dein Anbieter-Konto nutzen.

Einen Gemini-API-Schlüssel in 3 Minuten erstellen

1. Öffne die API-Schlüssel-Seite von Google AI Studio im Browser und melde dich mit deinem Google-Konto an.
2. Klicke auf Create API key (Google nennt es eventuell Get API key; bei deutscher Oberfläche ist die Beschriftung übersetzt). Wenn Google dich bittet, ein Projekt auszuwählen oder zu erstellen, übernimm die Voreinstellung.
3. Klicke auf das Kopiersymbol neben deinem neuen Schlüssel. Er ist eine lange Folge aus Buchstaben und Ziffern.
4. Öffne in Agon Einstellungen → KI-Assistent. [SCREENSHOT: Einstellungen → KI-Assistent mit der Anbieterliste und dem Feld API-Schlüssel]
5. Wähle unter KI-Anbieter den Eintrag Google Gemini.
6. Füge den Schlüssel in das Feld API-Schlüssel ein und klicke auf Prüfen & Speichern.
7. Agon testet den Schlüssel sofort bei Google. Wenn er funktioniert, siehst du API-Schlüssel gespeichert und verifiziert. und ein Abzeichen Schlüssel aktiv · Google Gemini.

Das war's: Öffne den Assistenten und stell ihm eine Frage.

Die Bildschirme von Google ändern sich von Zeit zu Zeit. Wenn eine Schaltfläche anders heißt, such im Menü von Google AI Studio nach „API keys“. Der Link Google Gemini-API-Schlüssel holen neben der Anbieterliste in Agon öffnet immer die richtige Seite.

Stattdessen Groq verwenden

1. Öffne die API-Schlüssel-Seite der Groq-Konsole und melde dich an oder erstelle ein Konto.
2. Klicke auf Create API Key, gib ihm einen Namen (zum Beispiel „Agon“) und kopiere den Schlüssel. Groq zeigt ihn nur einmal an.
3. Öffne in Agon Einstellungen → KI-Assistent, wähle unter KI-Anbieter den Eintrag Groq, füge den Schlüssel in API-Schlüssel ein und klicke auf Prüfen & Speichern.

Ein Abzeichen Schlüssel aktiv · Groq bestätigt, dass es funktioniert.

Ein lokales Modell mit Ollama verwenden

Mit Ollama läuft das KI-Modell auf deinem eigenen Computer, sodass Prompts ihn nie verlassen. Du brauchst einen Computer mit genug Arbeitsspeicher, um ein Modell auszuführen. Die Antworten sind meist langsamer als bei einem Cloud-Anbieter, und ihre Qualität hängt vom gewählten Modell ab. Das ist eine Option für Fortgeschrittene.

1. Lade Ollama von ollama.com herunter, installiere es und lade dann ein Modell herunter, zum Beispiel mit ollama pull llama3.1 in einem Terminal. Ollama muss immer laufen, wenn du den Assistenten nutzt.

2. Beende Agon.

3. Öffne den Datenordner von Agon:

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

4. Öffne die Datei .env in einem reinen Texteditor (unter macOS ist sie versteckt: Drücke im Finder Cmd + Umschalt + ., um sie anzuzeigen). Ändere oder lösche die bereits vorhandenen Zeilen nicht: Sie enthalten die geheimen Schlüssel, die die Daten deines Studios schützen. Füge am Ende diese zwei Zeilen hinzu, mit dem Namen des Modells, das du heruntergeladen hast:

   LLM_PROVIDER=ollama
   LLM_MODEL=ollama_chat/llama3.1

5. Speichere die Datei und starte Agon neu.

Einstellungen → KI-Assistent zeigt jetzt Aktiv · lokales Modell. Wenn du später mit Stattdessen eigenen Anbieter-Schlüssel verwenden einen Anbieter-Schlüssel speicherst, hat dieser Schlüssel Vorrang vor dem lokalen Modell.

Datenschutz: Wohin deine Prompts gehen

• Direkt von deinem Computer zum gewählten Anbieter. Wenn du Gemini oder Groq nutzt, gehen deine Frage und die Informationen, die der Assistent für die Antwort braucht, direkt von dem Computer, auf dem Agon läuft, an diesen Anbieter. Sie laufen nie über den Entwickler von Agon oder einen für Agon betriebenen Server.
• Mit Ollama verlässt nichts deinen Computer.
• Dein Schlüssel bleibt auf deinem Computer. Agon speichert ihn verschlüsselt in der lokalen Datenbank deines Studios und zeigt ihn nach dem Speichern nie wieder an. Schlüssel entfernen unter Einstellungen → KI-Assistent löscht ihn jederzeit.
• Kostenlose Stufen können deine Daten verwenden. Die kostenlosen Stufen mancher Anbieter können die gesendeten Daten nutzen, um ihre Modelle zu trainieren oder zu verbessern. Für Fragen mit Daten deiner Kunden nutze eine kostenpflichtige Stufe oder ein lokales Modell. Bedingungen ändern sich, also prüfe vor dem Start die aktuellen Bedingungen und die Datenschutzerklärung deines Anbieters: Gemini-API-Bedingungen · Datenschutzerklärung von Groq.
• Dein Studio hat die Kontrolle. Dein Studio hat die Vereinbarung mit dem Anbieter, daher ist dieser Anbieter nach der DSGVO ein Auftragsverarbeiter deines Studios. Der DSGVO-Leitfaden erklärt, was das für dich bedeutet.

Eine gute Gewohnheit: Füge keine sensiblen Kundendaten (zum Beispiel Gesundheitsnotizen) in den Chat ein, wenn du mit den Bedingungen deines Anbieters nicht einverstanden bist.

Wenn du mit intensiver Nutzung rechnest

Jeder Anbieter begrenzt, wie viele Anfragen ein Schlüssel pro Minute und pro Tag stellen kann. Kostenlose Stufen haben niedrige Limits. Wenn mehrere Personen den Assistenten gleichzeitig nutzen oder du den KI-Aktionsmodus zu Stoßzeiten verwendest, kann eine Meldung erscheinen, dass dein KI-Anbieter Anfragen begrenzt.

Um das zu beheben, erhöhe deine Limits beim Anbieter:

• Google Gemini: Aktiviere die Abrechnung für das Google-Cloud-Projekt, zu dem dein Schlüssel gehört. Google AI Studio zeigt deine aktuelle Stufe und wie du upgradest.
• Groq: Prüfe deine Limits und die Upgrade-Optionen in der Groq-Konsole.

Derselbe Schlüssel funktioniert in Agon nach dem Upgrade weiter. Du brauchst keinen neuen Schlüssel und musst in Agon nichts ändern. Der Anbieter stellt dir alles, was über seine kostenlose Stufe hinausgeht, direkt in Rechnung. Eine kostenpflichtige Stufe ist auch die empfohlene Wahl für Kundendaten (siehe Abschnitt zum Datenschutz oben).

Was tun, wenn etwas schiefgeht?

Agon sagt, mein Schlüssel sei ungültig Prüfe, ob du den ganzen Schlüssel ohne zusätzliche Leerzeichen kopiert hast und ob der gewählte Anbieter zum Schlüssel passt: Ein Groq-Schlüssel funktioniert nicht als Gemini-Schlüssel. Stelle sicher, dass der Schlüssel in der Konsole des Anbieters nicht gelöscht wurde. Ein brandneuer Schlüssel kann eine Minute brauchen, bis er funktioniert; warte also und klicke erneut auf Prüfen & Speichern.

Der Assistent meldet, dass mein KI-Anbieter Anfragen begrenzt Du hast das Limit deines Anbieters erreicht. Warte eine Minute und versuche es erneut, oder erhöhe deine Limits (siehe Wenn du mit intensiver Nutzung rechnest).

Der Assistent zeigt nur Hilfeartikel Der Assistent ist im Basismodus, weil kein Anbieter verbunden ist. Folge den Schritten oben, um einen Schlüssel hinzuzufügen. Einstellungen → KI-Assistent zeigt Nicht konfiguriert · Basismodus, wenn kein Anbieter aktiv ist.

Mitten in einer Aktion erhalte ich „Diese Aktion benötigt Agon AI, das ausgeschaltet ist“ Der KI-Aktionsmodus kann eine Anfrage ohne Anbieter nicht abschließen. Füge unter Einstellungen → KI-Assistent einen Schlüssel hinzu und frag dann erneut.

Mein Schlüssel hat funktioniert und jetzt schlägt der Assistent fehl Der Schlüssel wurde beim Anbieter möglicherweise gelöscht, ist abgelaufen oder hat sein Kontingent aufgebraucht. Erstelle einen neuen Schlüssel und speichere ihn über Ändern unter Einstellungen → KI-Assistent.

Ich möchte den Anbieter wechseln oder meinen Schlüssel ersetzen Klicke unter Einstellungen → KI-Assistent neben dem Abzeichen Schlüssel aktiv auf Ändern, wähle den Anbieter, füge den neuen Schlüssel ein und klicke auf Prüfen & Speichern.

Ich möchte meinen Schlüssel nicht mehr verwenden Klicke unter Einstellungen → KI-Assistent auf Schlüssel entfernen und bestätige. Agon löscht den Schlüssel aus der Datenbank deines Studios und der Assistent wechselt sofort in den Basismodus, ohne Neustart. Wenn du glaubst, dass der Schlüssel in fremde Hände geraten sein könnte, lösche (widerrufe) ihn zusätzlich in der Konsole deines Anbieters (Google AI Studio oder die Groq-Konsole), damit niemand sonst ihn nutzen kann.

Das lokale Modell funktioniert nicht Stelle sicher, dass Ollama läuft und dass der Modellname in der Datei .env zu einem Modell passt, das du heruntergeladen hast (ollama list zeigt sie an). Starte Agon nach jeder Änderung an der Datei .env neu.

Häufig gestellte Fragen

Kostet der KI-Assistent etwas? Agon berechnet dafür nichts. Dein Anbieter eventuell schon: Kostenlose Stufen haben Nutzungslimits, und alles darüber hinaus stellt dir der Anbieter direkt in Rechnung.

Kann der Entwickler von Agon meine Fragen sehen? Nein. Prompts gehen von deinem Computer direkt an den gewählten Anbieter oder bleiben mit Ollama auf deinem Computer.

Welchen Anbieter soll ich wählen? Gemini ist am schnellsten eingerichtet. Für Kundendaten ist eine kostenpflichtige Stufe eines beliebigen Anbieters oder ein lokales Modell die sicherere Wahl.

Verwandte Seiten

• KI-Support-Assistent
• KI-Aktionsmodus
• DSGVO-Leitfaden für Studio-Manager
• Einstellungen