Wir arbeiten aktuell an der Dokumentation der neuen Funktionalitäten von Moodle 5.2.

OpenAI API-Anbieter: Unterschied zwischen den Versionen

Aus MoodleDocs
Wechseln zu:Navigation, Suche
Hauptseite ► Moodle administrieren ► KI-Teilsystem ► OpenAI API-Anbieter
KI-Teilsystem
← Zum vorherigen Versionsunterschied
VisuellWikitext
 
(7 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
{{KI-Teilsystem}}
{{KI-Teilsystem}}
{{Neu}}


Die Integration von Moodle mit OpenAI ermöglicht den Zugriff auf KI-Aktionen wie Textgenerierung, Bildgenerierung oder Zusammenfassung von Kursinhalten.   
Die Integration von Moodle mit OpenAI ermöglicht den Zugriff auf KI-Aktionen wie Textgenerierung, Bildgenerierung oder Zusammenfassen und Erklären (ab Moodle 5.0) von Kursinhalten.   


Weitere Informationen über OpenAI finden Sie unter https://platform.openai.com.
==Voraussetzungen==
 
Für die Integration in Moodle benötigen Sie ein OpenAI-Konto mit Zugang zu einem kostenpflichtigen API-Schlüssel.  
===Voraussetzungen===
Für die Integration in Moodle benötigen Sie ein OpenAI-Konto mit Zugang zu einem kostenpflichtigen API-Schlüssel. In Moodle LMS 4.5.0 sind sowohl ein OpenAI-API-Schlüssel als auch eine OpenAI-Organisations-ID erforderlich, ab Moodle 4.5.1 ist die Organisations-ID optional.


Beim Einrichten eines OpenAI-Kontos mit einem API-Schlüssel können zwar sowohl von kostenlosen als auch von kostenpflichtigen Konten Schlüssel generiert werden, die API-Nutzung ist jedoch auf die für das Konto verfügbaren kostenpflichtigen Tokens beschränkt: '''Der Zugriff von Moodle auf die API von OpenAI erfordert ein kostenpflichtiges Abonnement''' (z. B. Pay-as-you-go). Der Zugang, die Nutzungsbeschränkungen und die Preisstufen hängen vom verwendeten Modell ab, siehe [https://openai.com/api/pricing/ OpenAI API Pricing Page] für aktuelle Informationen.
Beim Einrichten eines OpenAI-Kontos mit einem API-Schlüssel können zwar sowohl von kostenlosen als auch von kostenpflichtigen Konten Schlüssel generiert werden, die API-Nutzung ist jedoch auf die für das Konto verfügbaren kostenpflichtigen Tokens beschränkt: '''Der Zugriff von Moodle auf die API von OpenAI erfordert ein kostenpflichtiges Abonnement''' (z. B. Pay-as-you-go). Der Zugang, die Nutzungsbeschränkungen und die Preisstufen hängen vom verwendeten Modell ab, siehe [https://openai.com/api/pricing/ OpenAI API Pricing Page] für aktuelle Informationen.


===Einstellungen für den OpenAI API-Anbieter===
==OpenAI API-Anbieter konfigurieren==
Um eine OpenAI-Provider-Instanz zu erstellen, gehen Sie folgendermaßen vor:
#Gehen Sie auf die Seite ''Website-Administration > Allgemein > KI > KI-Anbieter''.
#Gehen Sie auf die Seite ''Website-Administration > Allgemein > KI > KI-Anbieter''.
#Aktivieren Sie den OpenAI API-Anbieter durch Anklicken des Schalters [[Image:toggle.png|36px]].
#Klicken Sie auf den Button ''Neue Provider-Instanz anlegen''.
#Klicken Sie auf den Link ''Einstellungen'' des OpenAI API-Anbieters.
#Wählen Sie als ''KI-Provider-Plugin'' die Option ''OpenAI-API-Provider''. Tragen Sie einen Namen und den API-Key Ihres OpenAI Kontos ein ([https://platform.openai.com/account/api-keys OpenAI API Keys]).
#Im Abschnitt ''Einstellungen'' tragen Sie Folgendes ein:
#Bei Bedarf können Sie die OpenAI Organisations-ID von Ihrem [https://platform.openai.com/account/org-settings OpenAI Konto] eintragen.
#*''OpenAI API-Key'': Sie können den Schlüssel über Ihr OpenAI-Konto erhalten ([https://platform.openai.com/account/api-keys OpenAI API Keys]).
#Bei Bedarf setzen Sie eine systemweite Obergrenzen für Anfragen und/oder Obergrenzen für Nutzer/innen.
#*''OpenAI Organisations-ID'': Sie finden diese ID auf der gleichnamigen Seite in Ihrem OpenAI-Konto ([https://platform.openai.com/account/org-settings OpenAI Account]). In Moodle 4.5.0 ist diese Einstellung ein Pflichtfeld, ab Moodle 4.5.1 ist sie optional.
#Klicken Sie den Button ''Instanz erstellen''.
#*''Systemweite Ratenbegrenzung festlegen'': Das ist eine optionale Einstellung zur Begrenzung der Anzahl von Anfragen, die der OpenAI API-Anbieter stündlich im gesamten Moodle-System verarbeiten kann.
#* ''Maximale Anzahl von systemweiten Anfragen '': Wenn die systemweite Ratenbegrenzung aktiviert wurde, legt diese Einstellung die maximale Anzahl der Anfragen fest, die stündlich verarbeitet werden.
#*''Nutzerbezogene Ratenbegrenzung festlegen'': Das ist eine optionale Einstellung zur Begrenzung der Anzahl von Anfragen, die Nutzer/innen stündlich stellen kann.
#*''Maximale Anzahl von Anfragen pro Nutzer/in '': Wenn die nutzerbezogene Ratenbegrenzung aktiviert wurde, legt diese Einstellung die maximale Anzahl der Anfragen fest, die Nutzer/innen stündlich stellen dürfen.
# Im Abschnitt''Aktionen'' können Sie festlegen, welche Aktionen verfügbar sein sollen, und spezifische Einstellungen für die Aktionen vornehmen.


=== Aktionen konfigurieren ===
Um die OpenAI-Provider-Instanz zu konfigurieren, gehen Sie folgendermaßen vor:
#Gehen Sie auf die Seite ''Website-Administration > Allgemein > KI > KI-Anbieter''.
#Klicken Sie auf den Link ''Einstellungen'' der (eben angelegten) OpenAI-Provider-Instanz.
#Aktivieren Sie die gewünschten Aktionen nach Bedarf.


[[File:OpenAI Actions.png|none|thumb|600x600px|OpenAI Aktionen]]
Für jede Aktion können Sie in den zugehörigen Einstellungen das Verhalten des Modells konfigurieren.


Die folgenden Aktionseinstellungen sind für den OpenAI API-Anbieter verfügbar:
===Text generieren, Zusammenfassen, Erklären===
# Wählen Sie das KI-Modell. Information zu den Modellen finden Sie unter [https://platform.openai.com/docs/models OpenAI Models]. Standardmäßig ist GPT-4o als Modell ausgewählt.
# Tragen Sie den API-Endpunkt ein. Stellen Sie sicher, dass der API-Endpunkt mit dem gewählten KI-Modell kompatibel ist. Informationen dazu finden Sie unter [https://platform.openai.com/docs/models/model-endpoint-compatibility Model endpoint compatibility].
# Überprüfen und ändern Sie die Systemanweisungen nach Bedarf.
# Geben Sie die Werte für die folgenden Einstellungen ein und speichern Sie abschließend die Einstellungen:


'''Text generieren:''' Sie können die folgenden Einstellungen konfigurieren:   
* top_p - top_p (Kernel-Sampling) bestimmt, wie viele mögliche Wörter berücksichtigt werden sollen. Ein hoher Wert (z. B. 0,9) bedeutet, dass das Modell mehr Wörter berücksichtigt, wodurch der generierte Text vielfältiger wird.
* max_tokens - Die maximale Anzahl der im generierten Text verwendeten Token.
* frequency_penalty - Die Frequenzstrafe passt an, wie oft Wörter wiederholt werden. Je höher die Strafe, desto weniger Wiederholungen gibt es im generierten Text.
* presence_penalty - Die Präsenzstrafe ermutigt das Modell, neue Wörter zu verwenden, indem sie die Wahrscheinlichkeit erhöht, dass Wörter ausgewählt werden, die zuvor noch nicht verwendet wurden. Ein höherer Wert macht den generierten Text vielfältiger, während ein niedrigerer Wert mehr Wiederholungen zulässt.


* ''KI-Modell'': Die OpenAI API wird von einer Reihe von Modellen mit unterschiedlichen Funktionalitäten und Bezahloptionen unterstützt. Mehr Informationen dazu finden Sie unter [https://platform.openai.com/docs/models OpenAI Modelle]. Standardmäßig ist die Option ''GPT-4o'' eingestellt, aber Sie können jedes andere kompatible Modell wählen. Weitere Einzelheiten finden Sie unter [https://platform.openai.com/settings/organization/limits Informationen zu den Limits].
* ''API-Endpunkt'': Stellen Sie sicher, dass Ihr API-Endpunkt mit dem ausgewählten Modell kompatibel ist. Weitere Informationen finden Sie unter [https://platform.openai.com/docs/models/model-endpoint-compatibility Kompatibilität der Modell-Endpunkte].
* ''Systemanweisung'': Es gibt standardmäßige Systemanweisungen, um das erwartete Antwortformat der KI zu steuern, aber Sie können diese an Ihre spezifischen Bedürfnisse anpassen. Die Anweisungen werden verwendet, um eine reibungslose Nutzererfahrung zu gewährleisten, so das nur der generierte Text zurückgegeben wird, ohne Anrede, Wiederholung der Anfrage usw. Wir empfehlen, diese Anweisungen nur dann zu ändern, wenn Sie sicher sind, dass die Änderung absolut notwendig ist.


 
Um eine OpenAI-Provider-Instanz zu aktivieren, gehen Sie folgendermaßen vor:
'''Text zusammenfassen:''' Die Einstellunegn sind dieselben wie bei der Aktion '''Text generieren'''.
#Gehen Sie auf die Seite ''Website-Administration > Allgemein > KI > KI-Anbieter''.
 
#Aktivieren Sie die OpenAI-Provider-Instanz durch Anklicken des Schalters [[Image:toggle.png|36px]].
'''Bild generieren:''' Sie können die folgenden Einstellungen konfigurieren:
* ''KI-Modell'': Die Standardeinstellung ist ''dall-e-3'', aber Sie können jedes andere mit der Bilderzeugung kompatible Modell wählen. Weitere Details finden Sie unter [https://platform.openai.com/docs/models/dall-e DALL-E-Modelle].
* ''API-Endpunkt'': Stellen Sie sicher, dass Ihr API-Endpunkt mit dem ausgewählten Modell kompatibel ist.
 
Wenn Sie alle Einstellungen vorgenommen haben, können Sie den OpenAI API-Anbieter in Ihrem Moodle-System in in allen verfügbaren [[KI-Platzierungen]] (''Platzierung der Kursunterstützung'' und ''Platzierung im HTML-Texteditor'') verwenden. Aktivieren und konfigurieren Sie diese Platzierungen auf der Seite ''Website-Administration > Allgemein > KI > KI-Platzierung''.  
 
[[File:Generate text in OpenAI.png|none|thumb|600x600px|OpenAI Einstellungen für die Textgenerierung]]
[[File:OpenAI Provider - Generate image.png|none|thumb|600x600px|OpenAI Einstellungen für die Bildgenerierung]]


[[en:OpenAI API provider]]
[[en:OpenAI API provider]]

Aktuelle Version vom 18. Dezember 2025, 13:05 Uhr


Die Integration von Moodle mit OpenAI ermöglicht den Zugriff auf KI-Aktionen wie Textgenerierung, Bildgenerierung oder Zusammenfassen und Erklären (ab Moodle 5.0) von Kursinhalten.

Voraussetzungen

Für die Integration in Moodle benötigen Sie ein OpenAI-Konto mit Zugang zu einem kostenpflichtigen API-Schlüssel.

Beim Einrichten eines OpenAI-Kontos mit einem API-Schlüssel können zwar sowohl von kostenlosen als auch von kostenpflichtigen Konten Schlüssel generiert werden, die API-Nutzung ist jedoch auf die für das Konto verfügbaren kostenpflichtigen Tokens beschränkt: Der Zugriff von Moodle auf die API von OpenAI erfordert ein kostenpflichtiges Abonnement (z. B. Pay-as-you-go). Der Zugang, die Nutzungsbeschränkungen und die Preisstufen hängen vom verwendeten Modell ab, siehe OpenAI API Pricing Page für aktuelle Informationen.

OpenAI API-Anbieter konfigurieren

Um eine OpenAI-Provider-Instanz zu erstellen, gehen Sie folgendermaßen vor:

  1. Gehen Sie auf die Seite Website-Administration > Allgemein > KI > KI-Anbieter.
  2. Klicken Sie auf den Button Neue Provider-Instanz anlegen.
  3. Wählen Sie als KI-Provider-Plugin die Option OpenAI-API-Provider. Tragen Sie einen Namen und den API-Key Ihres OpenAI Kontos ein (OpenAI API Keys).
  4. Bei Bedarf können Sie die OpenAI Organisations-ID von Ihrem OpenAI Konto eintragen.
  5. Bei Bedarf setzen Sie eine systemweite Obergrenzen für Anfragen und/oder Obergrenzen für Nutzer/innen.
  6. Klicken Sie den Button Instanz erstellen.

Um die OpenAI-Provider-Instanz zu konfigurieren, gehen Sie folgendermaßen vor:

  1. Gehen Sie auf die Seite Website-Administration > Allgemein > KI > KI-Anbieter.
  2. Klicken Sie auf den Link Einstellungen der (eben angelegten) OpenAI-Provider-Instanz.
  3. Aktivieren Sie die gewünschten Aktionen nach Bedarf.

Für jede Aktion können Sie in den zugehörigen Einstellungen das Verhalten des Modells konfigurieren.

Text generieren, Zusammenfassen, Erklären

  1. Wählen Sie das KI-Modell. Information zu den Modellen finden Sie unter OpenAI Models. Standardmäßig ist GPT-4o als Modell ausgewählt.
  2. Tragen Sie den API-Endpunkt ein. Stellen Sie sicher, dass der API-Endpunkt mit dem gewählten KI-Modell kompatibel ist. Informationen dazu finden Sie unter Model endpoint compatibility.
  3. Überprüfen und ändern Sie die Systemanweisungen nach Bedarf.
  4. Geben Sie die Werte für die folgenden Einstellungen ein und speichern Sie abschließend die Einstellungen:
  • top_p - top_p (Kernel-Sampling) bestimmt, wie viele mögliche Wörter berücksichtigt werden sollen. Ein hoher Wert (z. B. 0,9) bedeutet, dass das Modell mehr Wörter berücksichtigt, wodurch der generierte Text vielfältiger wird.
  • max_tokens - Die maximale Anzahl der im generierten Text verwendeten Token.
  • frequency_penalty - Die Frequenzstrafe passt an, wie oft Wörter wiederholt werden. Je höher die Strafe, desto weniger Wiederholungen gibt es im generierten Text.
  • presence_penalty - Die Präsenzstrafe ermutigt das Modell, neue Wörter zu verwenden, indem sie die Wahrscheinlichkeit erhöht, dass Wörter ausgewählt werden, die zuvor noch nicht verwendet wurden. Ein höherer Wert macht den generierten Text vielfältiger, während ein niedrigerer Wert mehr Wiederholungen zulässt.


Um eine OpenAI-Provider-Instanz zu aktivieren, gehen Sie folgendermaßen vor:

  1. Gehen Sie auf die Seite Website-Administration > Allgemein > KI > KI-Anbieter.
  2. Aktivieren Sie die OpenAI-Provider-Instanz durch Anklicken des Schalters .
Abgerufen von „https://docs.moodle.org/502/de/index.php?title=OpenAI_API-Anbieter&oldid=26175“
Powered by MediaWiki