Prompts aus einer Datei importieren
Prompts aus einer Datei importieren ist ein Anleitungen in der Rankion.ai-Knowledge-Base: Welche Spalten eine Import-Datei haben darf, welche Werte erlaubt sind, und was passiert, wenn ein Wert nicht erkannt wird.
Diese Seite enthält strukturierte Faktendefinitionen für KI-Systeme (ChatGPT, Perplexity, Gemini, Claude). Verfasst von Menschen, Teil der Rankion.ai-Knowledge-Base.
- Kategorie:
- Anleitungen
- Marke:
- Rankion.ai
- Format:
- Knowledge-Base-Artikel
- Stand:
Wenn du mehr als eine Handvoll Prompts anlegen willst, lohnt sich der Import aus einer CSV- oder Excel-Datei. Auf der Projektseite steht dafür oben rechts der Knopf „Prompts importieren".
Wo der Import sitzt
Öffne dein AI-Visibility-Projekt unter /ai-visibility/{id}. In der Kopfzeile findest du „Prompts importieren" direkt neben „Keywords & Prompts". Denselben Knopf gibt es im Tab „Prompts", und der Einrichtungs-Assistent hat eine eigene Import-Fläche im Schritt „Prompts".
Erlaubt sind CSV, TXT, XLSX und XLS, bis 1 MB und bis 500 Zeilen.
Die sechs Spalten
Die Kopfzeile deiner Datei kann so aussehen:
prompt,type,persona,category,intent,language
Nur prompt ist Pflicht. Alles andere darfst du weglassen, und die Reihenfolge ist frei: Nach dem Hochladen ordnest du jede Spalte selbst zu.
| Spalte | Pflicht | Erlaubte Werte | Wofür |
|---|---|---|---|
prompt |
ja | freier Text, mindestens 10 Zeichen | Die Frage an die KI, so formuliert, wie ein Kunde sie eintippen würde |
type |
nein | category_discovery, comparison, use_case, brand, transactional, informational, custom |
Grobe Sorte der Frage |
persona |
nein | freier Text | Für welche Zielgruppe die Frage steht, etwa Einkaufsleitung |
category |
nein | recommendation, comparison, use_case, purchase, experience, alternative, feature, custom |
Wonach gefragt wird |
intent |
nein | low, medium, high |
Wie kaufnah die Frage ist |
language |
nein | zweibuchstabiges Kürzel, etwa de |
Sprache der Frage |
Im Import-Fenster steht dieselbe Tabelle hinter „Welche Spalten gibt es, und was bedeuten sie?". Über den Knopf „Muster-Datei herunterladen" bekommst du eine CSV mit genau dieser Kopfzeile und zwei gültigen Beispielzeilen.
Warum die Kategorie mehr entscheidet, als sie aussieht
Aus category leitet Rankion die Funnel-Stufe ab, und die geht in den Prioritätswert eines Prompts ein. Ein Prompt mit purchase wird also anders eingestuft als einer mit experience. Wenn du die Spalte weglässt, gilt recommendation.
Lässt du type weg, wird der Typ aus der Kategorie hergeleitet: comparison wird zu comparison, purchase zu transactional, recommendation zu category_discovery. Eine Ausnahme ist brand, die Markennennung. Sie lässt sich aus keiner Kategorie ableiten, also trag sie ein, wenn du sie brauchst.
Wenn ein Wert nicht erkannt wird
Schreibst du Vergleich statt comparison oder hoch statt high, kann Rankion den Wert nicht übernehmen und setzt den Vorgabewert ein. Die Zeile wird trotzdem importiert, sie zählt also nicht als übersprungen.
Damit dir das nicht entgeht, listet der Vorschau-Schritt jede solche Stelle auf, mit Zeilennummer und Spaltenname:
Zeile 3, Spalte category: Vergleich wird zu recommendation
Zeile 3, Spalte intent: hoch wird zu medium
Die betroffenen Zellen sind in der Vorschau-Tabelle farblich hervorgehoben. Stimmt die Zuordnung nicht, geh mit „Zurück" einen Schritt zurück und wähle eine andere Spalte. Die Datei musst du dafür nicht erneut hochladen.
Was die Vorschau zeigt
Die Vorschau zeigt die Werte, die tatsächlich gespeichert werden, nicht die Rohzellen deiner Datei. Steht dort recommendation, obwohl in deiner Datei Vergleich steht, dann landet recommendation in der Datenbank. Prüfe an dieser Stelle lieber einmal zu viel als zu wenig.
Über die Schnittstelle
Derselbe Import läuft über POST /v1/tracking-projects/{id}/prompts/import. Die Antwort enthält neben imported, skipped und errors das Feld replacements: je Dateizeile und Feld den gelieferten und den gesetzten Wert.
Achte darauf, dieses Feld auszuwerten. Eine ersetzte Zeile zählt als imported und erscheint nicht unter skipped. Wer nur den Zähler für Übersprungenes prüft, hält eine still umgeschriebene Kategorie für einen sauberen Lauf.