User Manual
awaBerry | Google API-Schlüsseleinrichtung
Konfigurieren Sie Ihren Google Gemini API-Schlüssel in awaBerry. Erforderlich zur Aktivierung des Smart Automation Framework, Smart Terminal und...
Einrichtung des Google API-Schlüssels
Zusammenfassung
Diese Seite bietet einen dedizierten Bereich innerhalb der awaBerry-Anwendung zur Verwaltung Ihres Google Gemini API-Schlüssels. Sie können entscheiden, ob Sie Ihren eigenen persönlichen Google API-Schlüssel für erweiterte Intelligenzfunktionen verwenden oder sich auf die Standardeinstellungen der Anwendung verlassen möchten. Wenn Sie sich für die Verwendung Ihres eigenen Schlüssels entscheiden, führt Sie die Seite durch die Eingabe, das Testen und die sichere Speicherung, um sicherzustellen, dass Ihre awaBerry-Intelligenzroutinen effektiv arbeiten.
Seitenaufruf
Sie können diese Seite aufrufen, indem Sie zu Folgendem navigieren: /user_googleapikey
Seitenfunktionen
- Schalter ("Google Studio API-Schlüssel einrichten"): Dieser Schalter ermöglicht es Ihnen, zwischen der Verwendung Ihres eigenen Google Gemini API-Schlüssels und der Verwendung der Standardeinstellungen von awaBerry zu wechseln.
- Wenn aktiviert, erscheint ein Eingabefeld, in das Sie Ihren persönlichen Google Gemini API-Schlüssel eingeben können.
- Wenn deaktiviert, verschwindet das Eingabefeld und das System greift auf seine Standard-Intelligenzeinstellungen zurück.
- Textfeld ("Google Studio API-Schlüssel"): Dieses Feld erscheint, wenn Sie den Schalter "Google Studio API-Schlüssel einrichten" aktivieren. Hier geben Sie Ihren eindeutigen Google Gemini API-Schlüssel ein.
- Validierung: Das Feld wird Sie benachrichtigen, wenn Sie versuchen, es leer zu übermitteln.
- Sicherheit: Ihr eingegebener Schlüssel wird verschlüsselt und sicher in der awaBerry-Cloud gespeichert, verknüpft mit Ihrer Zwei-Faktor-Authentifizierung.
- Schaltfläche "Schlüssel testen und speichern": Diese Schaltfläche erscheint, wenn "Google Studio API-Schlüssel einrichten" aktiviert ist. Ein Klick darauf führt zwei Hauptaktionen aus:
- Zuerst wird Ihr eingegebener Google API-Schlüssel getestet, um sicherzustellen, dass er gültig ist und korrekt mit Google Gemini-Diensten funktioniert.
- Wenn der Schlüssel gültig ist, wird er anschließend verschlüsselt und sicher in der awaBerry-Cloud für die zukünftige Verwendung gespeichert.
- Schaltfläche "Aktualisieren": Diese Schaltfläche erscheint, wenn "Google Studio API-Schlüssel einrichten" deaktiviert ist. Ein Klick darauf finalisiert Ihre Wahl, die Standard-Intelligenzeinstellungen von awaBerry zu verwenden, und löscht jeden zuvor gespeicherten persönlichen Google API-Schlüssel.
- Informationstexte: Mehrere Textblöcke erklären, wie awaBerry-Intelligenz Google Gemini nutzt, die Vorteile der Bereitstellung Ihres eigenen Schlüssels (z. B. die Verwendung von "Gemini 2.5 Flash Lite") und die sichere Speicherung Ihres Schlüssels.
- Fehlermeldungsfeld: Wenn der Test Ihres Google API-Schlüssels fehlschlägt, wird die Fehlermeldung "Test des Schlüssels hat nicht funktioniert - bitte überprüfen Sie den Schlüssel und versuchen Sie es erneut." prominent angezeigt.
Szenarioausführungen
Mögliche Nutzungsschritte auf dieser Seite
- Einrichtung Ihres eigenen Google API-Schlüssels:
- Navigieren Sie zur Seite "Einrichtung des Google API-Schlüssels".
- Suchen Sie den Schalter mit der Bezeichnung "Google Studio API-Schlüssel einrichten" und schalten Sie ihn ein.
- Ein Textfeld wird angezeigt. Geben Sie sorgfältig Ihren eindeutigen Google Gemini API-Schlüssel in dieses Feld ein.
- Klicken Sie auf die Schaltfläche "Schlüssel testen und speichern".
- Das System überprüft Ihren Schlüssel. Bei Erfolg sehen Sie eine Bestätigungsnachricht "Google API-Schlüssel gespeichert" und werden zur vorherigen Seite zurückgeleitet.
- Aktualisierung eines bestehenden Google API-Schlüssels:
- Wenn Sie zuvor einen Schlüssel gespeichert haben, wird dieser beim Besuch dieser Seite mit aktiviertem Schalter "Google Studio API-Schlüssel einrichten" vorausgefüllt im Textfeld angezeigt.
- Ändern Sie den Schlüssel im Textfeld zu Ihrem neuen Google Gemini API-Schlüssel.
- Klicken Sie auf die Schaltfläche "Schlüssel testen und speichern".
- Nach erfolgreicher Validierung wird Ihr neuer Schlüssel gespeichert und eine Bestätigungsnachricht angezeigt.
- Deaktivierung der Verwendung Ihres eigenen Google API-Schlüssels:
- Navigieren Sie zur Seite "Einrichtung des Google API-Schlüssels".
- Suchen Sie den Schalter mit der Bezeichnung "Google Studio API-Schlüssel einrichten" und schalten Sie ihn aus.
- Das Textfeld für den Schlüssel verschwindet.
- Klicken Sie auf die Schaltfläche "Aktualisieren".
- Ihre Präferenz zur Verwendung der Standardeinstellungen wird gespeichert und jeder zuvor gespeicherte persönliche API-Schlüssel wird aus dem System gelöscht. Sie werden dann zur vorherigen Seite zurückgeleitet.
Mögliche Fehler, die auf dieser Seite auftreten können
- Leere API-Schlüssel-Übermittlung:
- Fehler: "Bitte geben Sie Ihren Google Studio API-Schlüssel an."
- Grund: Dieser Fehler tritt auf, wenn Sie versuchen, "Schlüssel testen und speichern" mit aktiviertem Schalter "Google Studio API-Schlüssel einrichten" auszuführen, aber das Textfeld für den Google Studio API-Schlüssel leer gelassen haben. Das System benötigt einen API-Schlüssel, bevor es mit dem Testen und Speichern fortfahren kann.
- Lösung: Stellen Sie sicher, dass Sie einen gültigen Google Gemini API-Schlüssel in das vorgesehene Textfeld eingeben, bevor Sie auf die Schaltfläche klicken.
- Ungültiger oder nicht funktionierender API-Schlüssel:
- Fehler: "Test des Schlüssels hat nicht funktioniert - bitte überprüfen Sie den Schlüssel und versuchen Sie es erneut."
- Grund: Diese Meldung erscheint, wenn das System versucht, Ihren bereitgestellten Google Gemini API-Schlüssel zu testen (indem es einen kleinen Testbefehl an Google Gemini sendet) und der Test fehlschlägt. Dies kann auf einen falsch eingegebenen Schlüssel, einen abgelaufenen Schlüssel, einen Schlüssel mit unzureichenden Berechtigungen oder ein Problem mit dem Google API-Dienst zum Zeitpunkt des Tests zurückzuführen sein.
- Lösung: Überprüfen Sie sorgfältig, ob der von Ihnen eingegebene API-Schlüssel korrekt ist. Möglicherweise müssen Sie einen neuen Schlüssel in Ihrer Google Cloud Console generieren oder sicherstellen, dass der vorhandene Schlüssel die erforderlichen Berechtigungen für die Google Gemini API hat. Versuchen Sie es nach Überprüfung des Schlüssels erneut.
