KI-gestützte E-Mail-Antworten mit Hugging Face entwerfen

Hol dir deinen digitalen Schlüssel (API-Token)

Zuerst besorgen wir uns deinen einzigartigen digitalen Schlüssel, bekannt als API-Token. Eine API (Application Programming Interface) ist wie das digitale Menü- und Bestellsystem eines Restaurants, das es verschiedenen Computerprogrammen ermöglicht, miteinander zu kommunizieren. Dein API-Token ist wie dein persönlicher, geheimer VIP-Pass, der dem „Kellner“ von Hugging Face (der API) mitteilt, dass du berechtigt bist, eine Bestellung aufzugeben.

Öffne deinen Webbrowser und gehe zur Hugging Face-Website. Melde dich bei deinem Konto an. Nach dem Einloggen siehst du normalerweise eine übersichtliche Seite, vielleicht mit deinem Aktivitäts-Feed. Suche nach deinem Profilbild (meist ein Kreis mit deinem Initial oder einem von dir gewählten Bild) in der oberen rechten Ecke des Bildschirms. Klicke darauf. Ein Menü wird sich öffnen oder herunterklappen und Optionen wie „Profil“, „Einstellungen“ und „Abmelden“ anzeigen. Wähle aus diesem Menü „Einstellungen“ aus. Auf dem nächsten Bildschirm siehst du eine Seitenleiste links mit verschiedenen Kontoeinstellungen. Klicke auf „Access Tokens“. Du siehst dann eine Schaltfläche mit der Aufschrift „New token.“ Klicke darauf. Ein kleines Fenster öffnet sich und fragt nach Details. Gib deinem Token einen aussagekräftigen Namen, z. B. „Email-Reply-Bot“, und setze die Role auf „read.“ Diese „read“-Rolle bedeutet, dass der Token dir nur erlaubt, Informationen zu empfangen (wie KI-generierten Text), aber nichts an deinem Konto zu ändern. Klicke auf „Generate a token.“ Eine sehr lange, zufällige Zeichenfolge (dein API-Token) wird auf dem Bildschirm angezeigt. Kopiere diesen Token sofort! Du kannst auf das Kopier-Symbol daneben klicken. Behandle diesen Token wie ein Passwort – du wirst ihn nicht wiedersehen, sobald du diese Seite verlassen hast. Speichere ihn vorübergehend an einem sicheren Ort, z. B. in einem einfachen Textdokument, da du ihn bald benötigen wirst.

Falls es anders aussieht: Wenn sich dein Profilbild nicht oben rechts befindet, suche nach einem allgemeinen Kontosymbol (wie eine Personensilhouette) oder einem Menü-Button (oft drei horizontale Linien, manchmal als „Hamburger-Menü“ bezeichnet). Die „Einstellungen“ oder „Access Tokens“ könnten unter leicht abweichenden Namen zu finden sein, aber im Allgemeinen sind sie in deinem Kontoverwaltungsbereich zu finden.

Du weißt, dass es funktioniert hat, wenn du eine lange Zeichenfolge, die mit hf_ beginnt (z. B. hf_ABCDEF1234567890), erfolgreich kopiert und sicher gespeichert hast.

Finde einen KI-„Koch“ (Modell) für deine E-Mail

Jetzt musst du ein KI-Modell auswählen, was so ist, als würdest du einen bestimmten Koch für dein Gericht auswählen. Jedes Modell ist ein einzigartiges Computerprogramm, das für verschiedene Aufgaben trainiert wurde. Für das Verfassen von E-Mails benötigst du ein „text generation“-Modell – eines, das speziell dafür entwickelt wurde, neuen Text basierend auf deinen Anweisungen zu erzeugen.

Öffne einen neuen Browser-Tab und navigiere zum Hugging Face Hub. Auf dieser Seite siehst du eine auffällige Suchleiste, normalerweise in der Mitte oder oben. Gib in diese Suchleiste text-generation ein. Während du tippst, erscheint möglicherweise eine Liste von Modellen, oder du musst Enter drücken, um die Ergebnisse zu sehen. Du siehst dann viele verschiedene KI-Modelle. Für Anfänger ist gpt2 ein guter Ausgangspunkt, da es bekannt und im Allgemeinen effektiv für verschiedene Textaufgaben ist. Möglicherweise siehst du auch distilgpt2 (eine kleinere, schnellere Version) oder microsoft/DialoGPT-medium. Klicke auf das von dir gewählte Modell (z. B. klicke auf die gpt2-Modellkarte). Auf der spezifischen Seite des Modells siehst du ganz oben dessen Model ID. Für gpt2 ist die Model ID einfach gpt2. Notiere dir diese Model ID – du wirst sie für den nächsten Schritt benötigen.

Falls es anders aussieht: Wenn text-generation keine guten Ergebnisse liefert, versuche, auf der linken Seite nach Filtern zu suchen und wähle „Text Generation“ unter „Tasks“ aus. Die beliebtesten Modelle werden oft zuerst aufgelistet oder deutlich gekennzeichnet.

Du weißt, dass es funktioniert hat, wenn du die Model ID (z. B. gpt2) deines ausgewählten KI-Modells zur Textgenerierung erfolgreich notiert hast.

Bereite deine „Bestellung“ (API-Anfrage) vor

Jetzt formulierst du die spezifische Anweisung, die du an die KI senden möchtest. Diese Anweisung wird als Prompt bezeichnet. Du kombinierst deinen API-Token, die Model ID und deinen Prompt zu einem Befehl mithilfe eines Tools namens curl (ausgesprochen „körl“). curl ist eine gängige Methode, um Anfragen von deinem Computer-Terminal an Webdienste wie die API von Hugging Face zu senden.

Öffne das Terminal deines Computers. Unter Windows kannst du im Startmenü nach „Eingabeaufforderung“ oder „PowerShell“ suchen. Auf dem Mac oder unter Linux suche nach „Terminal“. Sobald es geöffnet ist, siehst du ein Fenster mit einem blinkenden Cursor, bereit für deine Eingabe. Wir verwenden einen curl-Befehl, der eine spezifische Codezeile ist, die deine Anfrage sendet. Dein Befehl wird Folgendes beinhalten:

• -X POST: Dies teilt Hugging Face mit, dass du Daten sendest (wie eine Bestellung aufgeben).
• -H "Authorization: Bearer YOUR_API_TOKEN": Dies beinhaltet deinen VIP-Pass (API-Token), um zu bestätigen, dass du die Anfrage stellen darfst.
• -H "Content-Type: application/json": Dies teilt Hugging Face mit, dass du Informationen im JSON (JavaScript Object Notation)-Format sendest, einer strukturierten Methode für Computerprogramme, Daten auszutauschen.
• -d '{ "inputs": "YOUR PROMPT", "parameters": { "max_new_tokens": 50, "return_full_text": false } }': Dies sind die tatsächlichen Daten, die du sendest. "inputs" enthält deinen Prompt (die Anweisung für die KI). "parameters" sind zusätzliche Anweisungen, wie "max_new_tokens": 50 (fordert etwa 50 neue Textteile an, sogenannte Tokens – ein Token sind ungefähr vier Zeichen) und "return_full_text": false (was sicherstellt, dass die KI nur ihre generierte Antwort zurücksendet, nicht auch deinen ursprünglichen Prompt).
• https://api-inference.huggingface.co/models/YOUR_MODEL_ID: Dies ist die Webadresse der KI-„Küche“, in der dein ausgewähltes Modell wartet.

Du musst YOUR_API_TOKEN durch deinen tatsächlichen Token aus Schritt 1 und YOUR_MODEL_ID durch die Model ID aus Schritt 2 ersetzen.

Falls es anders aussieht: Stelle sicher, dass dein Terminal bereit ist, Befehle zu akzeptieren. Einige Unternehmensnetzwerke könnten curl-Befehle blockieren. Wenn du Fehlermeldungen wie „command not found“ erhältst, musst du möglicherweise deine IT-Abteilung kontaktieren oder einen anderen Computer ausprobieren.

Du weißt, dass es funktioniert hat, wenn du eine vollständige curl-Befehlszeile (wie im Beispiel unten) hast, die deinen tatsächlichen API-Token und die gewählte Model ID enthält und bereit ist, in dein Terminal kopiert und eingefügt zu werden.

curl -X POST \
  -H "Authorization: Bearer hf_YOURUNIQUEKEY123" \
  -H "Content-Type: application/json" \
  -d '{ "inputs": "Der Kunde ist mit dem Service unzufrieden und möchte eine Rückerstattung. Verfasse eine höfliche und einfühlsame Antwort.", "parameters": { "max_new_tokens": 80, "return_full_text": false } }' \
  https://api-inference.huggingface.co/models/gpt2

Sende deine Bestellung an die KI-„Küche“

Sobald dein vollständiger curl-Befehl bereit ist, ist es Zeit, ihn zu senden. Kopiere den gesamten Befehl sorgfältig, einschließlich curl am Anfang und der Modell-URL am Ende. Gehe dann zurück zu deinem geöffneten Terminalfenster.

Füge den gesamten curl-Befehl im Terminalfenster am blinkenden Cursor ein. Nach dem Einfügen drücke die Enter-Taste auf deiner Tastatur. Was als Nächstes passiert, ist, dass dein Computer diese Anfrage über das Internet an Hugging Face sendet. Die KI verarbeitet dann deine Anfrage – dieser Prozess wird Inferenz genannt. Dies kann einige Sekunden dauern, besonders wenn du ein bestimmtes Modell zum ersten Mal verwendest oder wenn Hugging Face das Modell für dich auf seinen Servern „laden“ muss. Das Terminalfenster bleibt in der Regel für einen kurzen Moment leer, während es auf eine Antwort wartet.

Falls es anders aussieht: Wenn lange Zeit nichts passiert (länger als 20-30 Sekunden) oder du sofort eine Fehlermeldung wie „Connection refused“ siehst, überprüfe deine Internetverbindung und stelle sicher, dass dein curl-Befehl genau wie angegeben geschrieben ist, ohne fehlende Anführungszeichen oder Zeichen. Eine langsame Antwort könnte einfach bedeuten, dass das Modell einen Moment zum Laden benötigt.

Du weißt, dass es funktioniert hat, wenn nach kurzer Wartezeit neuer Text im Terminalfenster angezeigt wird. Dieser Text beginnt typischerweise mit einer eckigen Klammer [ oder einer öffnenden geschweiften Klammer {, was darauf hinweist, dass Daten empfangen wurden.

Lies die „Antwort“ der KI (E-Mail-Entwurf)

Nach kurzer Wartezeit siehst du Text in deinem Terminal erscheinen. Dieser Text wird im JSON (JavaScript Object Notation)-Format sein, einer standardisierten, organisierten Methode, wie Programme Daten miteinander austauschen. Es mag auf den ersten Blick etwas komplex aussehen, aber keine Sorge – du suchst nach einem bestimmten Teil davon.

Die JSON-Ausgabe zeigt typischerweise eine Liste (angezeigt durch []), die ein oder mehrere Objekte (angezeigt durch {}) enthält. Innerhalb eines dieser Objekte findest du den Schlüssel "generated_text". Der Text, der unmittelbar auf diesen Schlüssel folgt und in doppelten Anführungszeichen steht, ist deine von der KI entworfene E-Mail-Antwort. Zum Beispiel könntest du so etwas sehen wie \"generated_text\": \"Sehr geehrte/r [Kundenname],\\n\\nVielen Dank, dass Sie sich an uns gewendet haben...\" (das \n bedeutet eine neue Zeile, und \\ bedeutet ein einzelnes \-Zeichen). Lies diesen generierten Text durch. Du kannst den Text innerhalb der Anführungszeichen nach "generated_text" markieren und kopieren.

Falls es anders aussieht: Wenn du Fehlermeldungen anstelle von JSON siehst, gehe zurück und überprüfe Schritt 3 sorgfältig auf Tippfehler in deinem API-Token, der Model ID oder der Struktur der JSON-Daten (insbesondere bei Anführungszeichen). Manchmal kann ein sehr kurzes max_new_tokens zu einer sehr knappen oder unvollständigen Antwort führen.

Du weißt, dass es funktioniert hat, wenn du den von der KI generierten E-Mail-Text innerhalb des Abschnitts \"generated_text\": der Terminalausgabe klar identifizieren und kopieren kannst. Du kannst diesen Text dann in dein E-Mail-Programm einfügen, ihn mit Namen, spezifischen Details und der Stimme deiner Marke anpassen, da die KI nur einen allgemeinen Entwurf liefert.