Einrichten von Gemini API-Schlüsseln für Discourse AI
Einführung
Dieser Thread behandelt die Einrichtung Ihres Google Gemini API-Schlüssels mit einem bestehenden Google Cloud-Kontoprojekt. Gemini ist kein kostenloser Dienst, daher müssen Sie sicherstellen, dass in Ihrer Google Cloud-Verwaltung die Abrechnung konfiguriert ist.
Auf der Seite zur Generierung von Schlüsseln im Gemini Developer Studio finden Sie wichtige Informationen dazu mit Links:
Lassen Sie uns beginnen!
HINWEIS: Administratorzugriff auf Google Cloud und Ihr Discourse-Forum sind erforderlich.
Schritt 1: Einrichten eines Google Cloud-Projekts
Für die ordnungsgemäße Einrichtung eines Gemini API-Schlüssels benötigen Sie Administratorzugriff auf Ihr Google Cloud-Konto und müssen dort ein Abrechnungsprojekt erstellen, das Sie für die Nutzung Ihres Gemini API-Schlüssels verwenden können.
Sie können Ihren Schlüssel im Gemini Studio erstellen und sich mit Ihrer Google Cloud verbinden, aber es ist etwas einfacher, alles über die Google Cloud-Konsole zu erledigen, damit Sie nicht hin und her wechseln müssen.
Rufen Sie die Google Cloud-Verwaltung für APIs für Ihre Organisation auf und stellen Sie sicher, dass Sie sich in der übergeordneten Organisation befinden (Sie sehen dies im Feld oben neben dem Google Cloud-Logo).
Sie müssen ein Projekt für Ihren Gemini-Schlüssel erstellen, falls Sie noch keines haben, das Sie verwenden möchten (beachten Sie, dass sich der Link zum Auswählen oder Erstellen eines neuen Projekts oben links auf der Seite befindet).
Vervollständigen Sie für ein neues Projekt die Seite zur Projekterstellung (stellen Sie sicher, dass Ihre Organisation im entsprechenden Dropdown-Feld ausgewählt ist).
Für die Verwaltung der Abrechnung für Ihr Projekt müssen Sie ein Abrechnungskonto für das Projekt unter Google Cloud-Abrechnung einrichten, vorausgesetzt, die Abrechnung ist für Ihre Organisation konfiguriert. Sie (oder Ihr Abrechnungskontoverwalter) sollten dies später tun können, nachdem der Schlüssel erstellt wurde. Beachten Sie, dass es je nach Google Cloud-Konto Ihrer Organisation Einschränkungen für Projekte und Abrechnungsprojekte gibt. Um die Abrechnung für Ihr Projekt zu aktivieren, gehen Sie zur Registerkarte „Abrechnung“ im Google Cloud-Navigationsmenü, verknüpfen Sie ein Abrechnungskonto (siehe den Link „Abrechnungskonten verwalten“) und aktivieren Sie die Abrechnung für das Projekt über die Seite Abrechnungsprojekte.
Schritt 2: Erstellen eines Gemini API-Schlüssels
WICHTIG! Denken Sie daran, Ihre API-Schlüssel sicher zu verwenden. Bitte lesen Sie sorgfältig API-Schlüssel sicher aufbewahren und Bewährte Verfahren für die sichere Verwendung von API-Schlüsseln durch, bevor Sie fortfahren.
Nun sind Sie bereit, einen API-Schlüssel im Projekt zu erstellen. Rufen Sie die Anmeldeinformationen für dieses Projekt auf, klicken Sie oben auf den Link „+ Anmeldeinformationen erstellen“ und wählen Sie „API-Schlüssel“ aus den Dropdown-Optionen.
Es wird ein neuer API-Schlüssel für Sie erstellt. Kopieren Sie ihn und bewahren Sie ihn an einem sicheren Ort auf, z. B. in einer Passwort-Tresor-Anwendung. Teilen Sie Schlüssel nicht. Dies ist der Schlüssel, den Sie in Ihren Discourse AI-Einstellungen eingeben müssen.
Der Schlüssel sollte nun in Ihren API-Schlüsseln aufgeführt sein. Klicken Sie darauf, um den API-Schlüssel zu bearbeiten.
Geben Sie dem Schlüssel einen geeigneten Namen und gehen Sie dann zum Abschnitt „API-Einschränkungen“ und wählen Sie „Schlüssel einschränken“ und dann „Generative Language API“.
Speichern Sie Ihren aktualisierten Schlüssel. Klicken Sie auf den Link „Schlüssel anzeigen“ für Ihren neuen Schlüssel und kopieren Sie ihn.
Schritt 3: Konfigurieren von Gemini in den Discourse AI-Einstellungen
Discourse AI verwendet jetzt ein zentralisiertes Anmeldeinformationen-System zur Verwaltung von API-Schlüsseln. Anstatt Ihren Schlüssel direkt in jede LLM-Konfiguration einzufügen, erstellen Sie zuerst eine Anmeldeinformation und wählen diese dann bei der Konfiguration Ihres Gemini-Modells aus.
Schritt 3a: Erstellen einer Anmeldeinformation
Gehen Sie zu Admin > Plugins > AI > Credentials und klicken Sie auf Neue Anmeldeinformation. Geben Sie ihr einen beschreibenden Namen (z. B. „Gemini API Key“) und fügen Sie den API-Schlüssel ein, den Sie aus Google Cloud kopiert haben. Speichern Sie die Anmeldeinformation.
Tipp: Sie können eine Anmeldeinformation auch inline erstellen – wenn Sie im nächsten Schritt eine neue LLM hinzufügen, klicken Sie auf die Schaltfläche + neben der Anmeldeinformationsauswahl, um eine Ad-hoc-Erstellung vorzunehmen.
Schritt 3b: Hinzufügen einer Gemini LLM
Gehen Sie nun zu Admin > Plugins > AI > LLMs. Klicken Sie auf Hinzufügen und wählen Sie eines der vorkonfigurierten Gemini-Modelle aus (z. B. Gemini 3 Flash oder Gemini 3 Pro). Der Modellname, die Endpunkt-URL und andere Einstellungen werden für Sie vorausgefüllt. Verwenden Sie das Dropdown-Menü Credential, um die im vorherigen Schritt erstellte Anmeldeinformation auszuwählen, und speichern Sie dann.
Hinweis: Dieselbe Anmeldeinformation kann für mehrere LLM-Konfigurationen wiederverwendet werden, sodass Sie Ihren Gemini API-Schlüssel nur einmal eingeben müssen.
Schritt 4: Nachverfolgung der Gemini API-Schlüssel-Nutzung
Ihre Gemini API-Schlüssel-Nutzung können Sie in Ihrem Google Cloud-Dashboard unter Abrechnung unter „Abrechnungskonto verwalten“ nachverfolgen.
Wählen Sie dann Ihr spezifisches Projekt aus der Liste der Abrechnungsprojekte aus, und es wird der Abrechnungsbericht angezeigt, in dem Sie das Projekt/die Projekte und verschiedene andere Details angeben können, die Sie zur Nachverfolgung Ihrer API-Schlüsselprojekte verwenden möchten (Sie können hier auch andere Google API-Schlüssel verfolgen, die mit Ihrem Google Cloud-Konto verknüpft sind, beispielsweise wenn Sie Google Custom Search API und Programmable Search Engine konfiguriert haben).
