Exercise: Chuck Norris Joke GPT

Ziel der Übung

In dieser Übung lernst du, wie man einen Custom GPT mit Actions erstellt, der externe APIs nutzt. Du wirst einen "Chuck Norris Joke GPT" bauen, der auf Anfrage zufällige Chuck Norris Witze von der Chuck Norris API abruft.

Was du lernen wirst

• ✅ OpenAPI-Schemas für Actions erstellen

• ✅ APIs ohne Authentifizierung anbinden

• ✅ Query-Parameter für API-Requests nutzen

• ✅ Actions testen und debuggen

• ✅ GPT-Instructions für Action-Nutzung schreiben

---

Voraussetzungen

• ChatGPT Plus, Pro oder Team Account

• Zugang zum GPT Builder

• Grundverständnis von APIs und JSON

---

Die Chuck Norris API verstehen

Verfügbare Endpoints

Die Chuck Norris API bietet mehrere Endpoints:

Endpoint	Beschreibung	Beispiel
/jokes/random	Zufälliger Witz	GET https://api.chucknorris.io/jokes/random
/jokes/random?category=dev	Witz aus Kategorie	GET https://api.chucknorris.io/jokes/random?category=dev
/jokes/categories	Liste aller Kategorien	GET https://api.chucknorris.io/jokes/categories
/jokes/search?query=kung	Suche nach Stichwort	GET https://api.chucknorris.io/jokes/search?query=kung

Beispiel-Response

{
  "categories": [],
  "created_at": "2020-01-05 13:42:19.324003",
  "icon_url": "https://assets.chucknorris.host/img/avatar/chuck-norris.png",
  "id": "yDR5hJKETSaMPP8QcgWzzg",
  "updated_at": "2020-01-05 13:42:19.324003",
  "url": "https://api.chucknorris.io/jokes/yDR5hJKETSaMPP8QcgWzzg",
  "value": "Chuck Norris can divide by zero."
}

Die wichtigsten Felder:

• value – Der Witz-Text

• categories – Kategorien (z.B. ["dev", "movie"])

• id – Eindeutige ID des Witzes

---

Aufgabe 1: Basis-GPT mit zufälligen Witzen

Schritt 1: GPT erstellen

1. Gehe zu ChatGPT → Explore GPTs → Create a GPT

2. Gib dem GPT einen Namen: "Chuck Norris Joke Master"

3. Beschreibung: "Delivers the funniest Chuck Norris jokes on demand, powered by the official Chuck Norris API."

Schritt 2: Instructions schreiben

Wechsle zum Configure-Tab und füge folgende Instructions ein:

Du bist der Chuck Norris Joke Master, ein unterhaltsamer Bot, der die besten
Chuck Norris Witze liefert.

## Deine Aufgabe
- Wenn der User nach einem Chuck Norris Witz fragt, nutze die getRandomJoke Action
- Präsentiere den Witz in Anführungszeichen
- Füge am Ende ein passendes Emoji hinzu (💪, 🥋, 🔥, ⚡)
- Sei enthusiastisch und unterhaltsam

## Tonalität
- Humorvoll und energiegeladen
- Kurz und knackig
- Verwende gelegentlich Ausrufe wie "Boom!", "Legend!", "Epic!"

## Verhalten
- Frage NICHT, ob der User einen Witz hören möchte – liefere einfach
- Bei mehreren Anfragen hintereinander: Liefere jedes Mal einen neuen Witz
- Wenn die API nicht antwortet: Entschuldige dich höflich und schlage vor, es später nochmal zu versuchen

Schritt 3: OpenAPI-Schema erstellen

Scrolle zu Actions → Create new action und füge folgendes Schema ein:

{
  "openapi": "3.1.0",
  "info": {
    "title": "Chuck Norris Jokes API",
    "description": "Ruft zufällige Chuck Norris Witze von der offiziellen Chuck Norris API ab",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.chucknorris.io"
    }
  ],
  "paths": {
    "/jokes/random": {
      "get": {
        "description": "Gibt einen zufälligen Chuck Norris Witz zurück",
        "operationId": "getRandomJoke",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Erfolgreicher API-Call mit Witz-Daten",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "value": {
                      "type": "string",
                      "description": "Der Witz-Text"
                    },
                    "id": {
                      "type": "string",
                      "description": "Eindeutige ID des Witzes"
                    },
                    "url": {
                      "type": "string",
                      "description": "URL zum Witz"
                    },
                    "categories": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Liste der Kategorien"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Schritt 4: Authentication konfigurieren

Die Chuck Norris API benötigt keine Authentifizierung. Stelle sicher, dass bei Authentication die Option "None" ausgewählt ist.

Schritt 5: Testen

Klicke auf Test und stelle folgende Fragen im Test-Chat:

• "Tell me a Chuck Norris joke"

• "Another one!"

• "Give me a random Chuck Norris fact"

Erwartetes Verhalten:

• Der GPT ruft die getRandomJoke Action auf

• Du siehst die Meldung "Used getRandomJoke"

• Der Witz wird in Anführungszeichen mit Emoji präsentiert

Schritt 6: Speichern und Veröffentlichen

1. Klicke auf Save (oben rechts)

2. Wähle Only me (oder Anyone with a link, wenn du teilen möchtest)

3. Bestätige mit Confirm

---

Aufgabe 2: Erweitert mit Kategorien

Jetzt erweitern wir den GPT um die Fähigkeit, Witze aus spezifischen Kategorien abzurufen.

Schritt 1: Verfügbare Kategorien verstehen

Die Chuck Norris API hat folgende Kategorien:

animal, career, celebrity, dev, explicit, fashion, food, history,
money, movie, music, political, religion, science, sport, travel

Schritt 2: OpenAPI-Schema erweitern

Bearbeite dein bestehendes Schema und füge einen Query-Parameter hinzu:

{
  "openapi": "3.1.0",
  "info": {
    "title": "Chuck Norris Jokes API",
    "description": "Ruft zufällige Chuck Norris Witze von der offiziellen Chuck Norris API ab",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.chucknorris.io"
    }
  ],
  "paths": {
    "/jokes/random": {
      "get": {
        "description": "Gibt einen zufälligen Chuck Norris Witz zurück, optional aus einer bestimmten Kategorie",
        "operationId": "getRandomJoke",
        "parameters": [
          {
            "name": "category",
            "in": "query",
            "description": "Filter nach Kategorie (z.B. dev, movie, food, sport). Wenn nicht angegeben, wird ein komplett zufälliger Witz zurückgegeben.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "animal", "career", "celebrity", "dev", "explicit",
                "fashion", "food", "history", "money", "movie",
                "music", "political", "religion", "science", "sport", "travel"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Erfolgreicher API-Call mit Witz-Daten",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "value": {
                      "type": "string",
                      "description": "Der Witz-Text"
                    },
                    "id": {
                      "type": "string",
                      "description": "Eindeutige ID des Witzes"
                    },
                    "url": {
                      "type": "string",
                      "description": "URL zum Witz"
                    },
                    "categories": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Liste der Kategorien"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Wichtige Änderung: Das parameters-Array enthält jetzt den category-Parameter mit allen verfügbaren Kategorien im enum.

Schritt 3: Instructions erweitern

Aktualisiere die Instructions:

Du bist der Chuck Norris Joke Master, ein unterhaltsamer Bot, der die besten
Chuck Norris Witze liefert.

## Deine Aufgabe
- Wenn der User nach einem Chuck Norris Witz fragt, nutze die getRandomJoke Action
- Wenn der User eine Kategorie erwähnt (z.B. "einen Programmierer-Witz" oder "über Filme"),
  nutze den category-Parameter (z.B. "dev" für Programmierung, "movie" für Filme)
- Präsentiere den Witz in Anführungszeichen
- Füge am Ende ein passendes Emoji hinzu (💪, 🥋, 🔥, ⚡)
- Sei enthusiastisch und unterhaltsam

## Kategorien-Mapping
- Programmieren/Coding/Tech = "dev"
- Filme = "movie"
- Sport = "sport"
- Essen = "food"
- Tiere = "animal"
- Geschichte = "history"
- Reisen = "travel"
- Musik = "music"
- Wissenschaft = "science"
(Weitere: career, celebrity, explicit, fashion, money, political, religion)

## Tonalität
- Humorvoll und energiegeladen
- Kurz und knackig
- Verwende gelegentlich Ausrufe wie "Boom!", "Legend!", "Epic!"

## Verhalten
- Frage NICHT, ob der User einen Witz hören möchte – liefere einfach
- Bei mehreren Anfragen hintereinander: Liefere jedes Mal einen neuen Witz
- Wenn der User eine ungültige Kategorie nennt, schlage verfügbare Kategorien vor
- Wenn die API nicht antwortet: Entschuldige dich höflich und schlage vor, es später nochmal zu versuchen

Schritt 4: Testen mit Kategorien

Teste mit folgenden Anfragen:

• "Tell me a programming joke" → sollte category=dev nutzen

• "Give me a movie joke" → sollte category=movie nutzen

• "Random sports joke" → sollte category=sport nutzen

• "Any Chuck Norris joke" → sollte keinen category-Parameter senden

---

Aufgabe 3: Conversation Starters hinzufügen

Mache es Usern einfacher, den GPT zu nutzen, indem du Conversation Starters hinzufügst.

Im Configure-Tab unter "Conversation starters":

💪 Tell me a random Chuck Norris joke

🥋 Give me a martial arts joke

💻 Programming joke, please!

🎬 Movie joke about Chuck Norris

---

Aufgabe 4: Profilbild und Beschreibung optimieren

Profilbild erstellen

Nutze DALL-E, um ein passendes Bild zu generieren:

Prompt:

Create a minimalist icon of Chuck Norris in a humorous, cartoon style.
He should have his iconic beard, sunglasses, and a confident pose.
Style: Bold lines, simple colors, suitable as an app icon.
Background: solid color.

Lade das generierte Bild als Profilbild hoch.

Öffentliche Beschreibung

Falls du den GPT teilen möchtest, schreibe eine einladende Beschreibung:

🥋 The ultimate Chuck Norris joke machine!

Get instant access to hundreds of legendary Chuck Norris jokes,
facts, and wisdom from the official Chuck Norris API.

Features:
✅ Random jokes on demand
✅ Filter by category (dev, movie, sport, food, and more)
✅ Always fresh, never repetitive
✅ 100% Chuck Norris approved

Warning: Side effects may include uncontrollable laughter and an
urge to do roundhouse kicks. 💪

---

Bonus-Aufgaben

Bonus 1: Mehrere Actions hinzufügen

Erweitere den GPT um eine zweite Action für Joke-Suche:

Endpoint: GET /jokes/search?query={query}

Beispiel-Schema-Ergänzung:

"/jokes/search": {
  "get": {
    "description": "Sucht nach Chuck Norris Witzen, die ein bestimmtes Stichwort enthalten",
    "operationId": "searchJokes",
    "parameters": [
      {
        "name": "query",
        "in": "query",
        "description": "Suchbegriff (z.B. 'kung fu', 'texas', 'computer')",
        "required": true,
        "schema": {
          "type": "string"
        }
      }
    ],
    "responses": {
      "200": {
        "description": "Liste von Witzen, die den Suchbegriff enthalten",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "total": {
                  "type": "integer",
                  "description": "Anzahl gefundener Witze"
                },
                "result": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "value": { "type": "string" },
                      "id": { "type": "string" }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Test: "Find Chuck Norris jokes about 'kung fu'"

Bonus 2: Error Handling

Teste, was passiert, wenn:

• Die API offline ist (Tipp: teste mit falschem URL)

• Eine ungültige Kategorie übergeben wird

• Der User nach etwas fragt, das nicht API-bezogen ist

Verbessere die Instructions, um diese Fälle elegant zu handhaben.

Bonus 3: Statistik-Feature

Erweitere den GPT um die Fähigkeit, zu tracken, wie viele Witze in einer Session abgerufen wurden:

## Statistik
- Zähle intern mit, wie viele Witze du in dieser Conversation geliefert hast
- Wenn der User fragt "How many jokes so far?", antworte mit der Zahl
- Bei jedem 10. Witz, zeige eine Feier-Message: "🎉 That's your 10th joke! Chuck approves!"

---

Reflexion

Beantworte nach Abschluss der Übung folgende Fragen:

1. Wie entscheidet der GPT, wann er die Action aufrufen soll?

   • Ist die description im Schema ausschlaggebend?

   • Spielen die Instructions eine Rolle?

2. Was passiert, wenn der User eine Frage stellt, die nichts mit Chuck Norris zu tun hat?

   • Ruft der GPT trotzdem die API auf?

   • Wie verhindert man unnötige API-Calls?

3. Wie würdest du den GPT erweitern, um auch andere Joke-APIs zu integrieren?

   • z.B. Dad Jokes, Puns, etc.

   • Wie würdest du dem GPT beibringen, die richtige API zu wählen?

4. Welche Herausforderungen gibt es bei APIs mit Authentifizierung?

   • Wie würdest du einen API-Key sicher speichern?

   • Was sind die Unterschiede zwischen API-Key und OAuth?

---

Weiterführende Aufgaben

• Multi-API-GPT: Kombiniere mehrere Joke-APIs (Chuck Norris, Dad Jokes, Cat Facts)

• API mit POST: Baue einen GPT, der Daten sendet (z.B. Formular-Submission)

• Authentifizierte API: Integriere eine API, die einen API-Key benötigt (z.B. Weather API)

• Complex Response Parsing: Arbeite mit APIs, die verschachtelte JSON-Strukturen zurückgeben

---

Ressourcen

• Chuck Norris API Dokumentation

• OpenAPI 3.1.0 Specification

• Actions and API Integration

• Public APIs Collection – 1000+ öffentliche APIs zum Experimentieren

---

Erfolgskriterien

Du hast die Übung erfolgreich abgeschlossen, wenn:

• ✅ Dein GPT auf "Tell me a joke" mit einem Chuck Norris Witz antwortet

• ✅ Die Action im Chat sichtbar aufgerufen wird ("Used getRandomJoke")

• ✅ Kategorien korrekt erkannt und genutzt werden

• ✅ Der GPT auch ohne Action-Aufruf auf normale Fragen antwortet

• ✅ Das Verhalten den Instructions entspricht (Tonalität, Format, Emojis)