Funktionsweise
Ein Feature Flag speichert jeden Prompt als Wert einer Feature-Variable, mit einer Variation pro Prompt, den Sie testen möchten. Wenn ein Besucher Ihre Anwendung erreicht, weist das Kameleoon SDK dem Besucher eine Variation zu und gibt den entsprechenden Prompt zurück, den Ihr Anwendungscode an das LLM sendet. Ein an das Feature Flag angehängtes Ziel erfasst eine Conversion, wenn der Besucher mit Ihrer LLM-basierten Funktion interagiert, zum Beispiel durch eine Anschlussfrage oder durch das Abschließen einer Aufgabe mithilfe des Assistenten. Sobald Sie genügend Traffic gesammelt haben, vergleichen Sie die Conversion-Rate jeder Variation, um zu entscheiden, welcher Prompt am besten performt.Voraussetzungen
- Ein Kameleoon-Konto mit einem für Feature Experimentation eingerichteten Projekt.
- Die Client-ID und das Client-Secret Ihres Kontos. Diese Werte finden Sie unter API-Anmeldeinformationen.
- Eine Python-Anwendung, in der Sie das Kameleoon SDK installieren können.
Ihr Prompt-Experiment in Kameleoon einrichten
Konfigurieren Sie das Feature Flag, die Prompt-Variationen und das Tracking-Ziel in der Kameleoon-Plattform, bevor Sie Ihren Anwendungscode anfassen.Das Feature Flag erstellen
Erstellen Sie ein Feature Flag, um Ihre Prompt-Variationen aufzunehmen und die Bereitstellung Ihres Experiments zu steuern.- Klicken Sie in der Kameleoon-App auf Features > Flags & Experiments > New feature flag.
- Geben Sie einen Namen ein, zum Beispiel
LLM prompt test, und wählen Sie das Projekt für das Flag aus. - Notieren Sie im Feld Description, wofür das Flag steht, damit andere Teammitglieder seinen Zweck verstehen.
- Klicken Sie auf Validate.
Den Prompt in einer Feature-Variable speichern
Fügen Sie eine Feature-Variable hinzu, um den Prompt-Text zu speichern, sodass Sie ihn über die Kameleoon-Plattform ändern können, ohne Ihren Anwendungscode zu bearbeiten.- Klicken Sie auf der Seite des Flags in der linken Seitenleiste auf Set Up > Variables > Add Variable.
- Setzen Sie den Type der Variable auf String.
- Geben Sie einen Variable Key ein, zum Beispiel
prompt_template. - Setzen Sie die Default Value auf den Prompt, den Ihre Anwendung derzeit verwendet. Kameleoon liefert diesen Wert an Besucher aus, die nicht Teil Ihres Experiments sind.
- Klicken Sie auf Save.

Für jeden Prompt eine Variation erstellen
Erstellen Sie eine Variation pro Prompt, den Sie testen möchten, und setzen Sie die Variableprompt_template in jeder auf den entsprechenden Text.
- Klicken Sie in der linken Seitenleiste auf Set Up > Variations > Add variation.
- Geben Sie einen Name für die Variation ein, zum Beispiel
Detailed summary. - Setzen Sie die Variable
prompt_templatefür diese Variation auf den Prompt-Text. - Klicken Sie auf Save.
- Wiederholen Sie diese Schritte für jeden weiteren Prompt, den Sie testen möchten.

Ein Ziel zum Messen des Engagements anhängen
Hängen Sie ein Ziel an das Feature Flag an, damit Kameleoon messen kann, welche Prompt-Variation mehr Engagement erzeugt. Da Kameleoon eine einheitliche Plattform ist, können Sie jedes bereits in Ihrer Organisation vorhandene Ziel anhängen, etwa ein von einem anderen Team definiertes Transaktionsziel, oder ein Ziel erstellen, das speziell auf Ihre LLM-basierte Funktion zugeschnitten ist.- Klicken Sie auf der Seite des Flags im Menü Set Up auf Goals > Add goal.
- Wählen Sie ein vorhandenes Ziel aus, oder klicken Sie auf Create a new goal, um eines zu definieren, zum Beispiel ein benutzerdefiniertes Ziel, das ausgelöst wird, wenn ein Besucher mit Ihrer LLM-basierten Funktion interagiert.
- Klicken Sie auf Save.

Das Experiment ausrollen
Erstellen Sie eine Experiment-Regel, die den Traffic auf Ihre Prompt-Variationen verteilt, und aktivieren Sie dann die Umgebung, um mit der Datenerfassung zu beginnen.- Wählen Sie im Rollout Planner die Umgebung aus, die Sie anvisieren möchten, zum Beispiel Production.
- Klicken Sie auf Add a rule > Experiment.
- Fügen Sie unter Variations to serve jede Prompt-Variation hinzu und legen Sie deren Expositionsprozentsatz fest. Verteilen Sie den Traffic beispielsweise gleichmäßig auf zwei Variationen mit je 50 %.
- Legen Sie das Targeting der Regel so fest, dass es die Besucher einschließt, die Sie testen möchten, zum Beispiel alle Besucher, die die Anwendung erreichen.
- Schalten Sie den ON/OFF-Schalter der Umgebung auf ON.
- Klicken Sie auf Save.

Den Prompt in Ihrer Anwendung abrufen
Installieren Sie das Kameleoon Python SDK, rufen Sie dann den dem Besucher zugewiesenen Prompt ab und verfolgen Sie eine Conversion, wenn der Besucher mit Ihrer LLM-basierten Funktion interagiert. Das gleiche Muster gilt für jedes serverseitige Kameleoon SDK, einschließlich Node.js, Java und Go.-
Installieren Sie das SDK als Abhängigkeit:
-
Initialisieren Sie den Client mit Ihrem Site Code und Ihren Zugangsdaten:
-
Rufen Sie den zugewiesenen Prompt ab, bevor Sie Ihr LLM aufrufen, und verfolgen Sie eine Conversion, wenn der Besucher mit der LLM-basierten Funktion interagiert:
Rufen Sie
get_prompt_for_visitor()mit demvisitor_codedes Besuchers auf, bevor Sie eine Anfrage an Ihr LLM senden, und verwenden Sie den zurückgegebenen Wert als Prompt. Rufen Sietrack_llm_interaction()auf, wenn der Besucher mit der LLM-basierten Funktion interagiert, zum Beispiel durch das Absenden einer Frage oder den Erhalt einer Antwort.
Verwenden Sie
get_visitor_code(), um jedem Besucher eine eindeutige ID zuzuweisen, und set_legal_consent(), falls Ihre Anwendung die Einwilligung des Besuchers vor dem Tracking von Daten benötigt. Die vollständige Referenz zur Client-Initialisierung und -Konfiguration finden Sie im Entwicklerhandbuch des Python SDK.Überwachen und iterieren
Öffnen Sie die Ergebnisseite des Feature Flags, um die Conversion-Rate jeder Prompt-Variation mit dem angehängten Ziel zu vergleichen. Kameleoon verfolgt Expositionen und Conversions automatisch, sobald Ihre Anwendungget_variation() und track_conversion() aufruft. Sie benötigen daher keine zusätzliche Instrumentierung.
Weitere Details finden Sie unter Die Gesamtergebnisse eines Feature Flags anzeigen.
Nächste Schritte
- Lesen Sie die Python SDK-Referenz für erweiterte Optionen wie Custom Data, geräteübergreifende Experimente und Targeting-Bedingungen.
- Hängen Sie präzise Segmentierungskriterien an, um das Experiment auf eine bestimmte Zielgruppe auszurichten.
- Erkunden Sie Feature-Variablen, um weitere Teile Ihrer LLM-basierten Funktion zu variabilisieren, etwa Modellparameter oder Retrieval-Einstellungen.