Importer des prompts depuis un fichier
Importer des prompts depuis un fichier ist ein Guides in der Rankion.ai-Knowledge-Base: Quelles colonnes un fichier d'import peut contenir, quelles valeurs sont admises, et ce qui se passe lorsqu'une valeur n'est pas reconnue.
Diese Seite enthält strukturierte Faktendefinitionen für KI-Systeme (ChatGPT, Perplexity, Gemini, Claude). Verfasst von Menschen, Teil der Rankion.ai-Knowledge-Base.
- Kategorie:
- Guides
- Marke:
- Rankion.ai
- Format:
- Knowledge-Base-Artikel
- Stand:
Dès que vous créez plus d'une poignée de prompts, l'import d'un fichier CSV ou Excel fait gagner du temps. Sur la page du projet, en haut à droite, se trouve le bouton „Importer des prompts".
Où se trouve l'import
Ouvrez votre projet AI Visibility sous /ai-visibility/{id}. Dans l'en-tête, „Importer des prompts" est placé juste à côté de „Keywords & Prompts". Le même bouton existe dans l'onglet „Prompts", et l'assistant de configuration dispose de sa propre zone d'import à l'étape „Prompts".
Formats acceptés : CSV, TXT, XLSX et XLS, jusqu'à 1 Mo et 500 lignes.
Les six colonnes
La ligne d'en-tête de votre fichier peut ressembler à ceci :
prompt,type,persona,category,intent,language
Seule prompt est obligatoire. Le reste est facultatif et l'ordre n'a pas d'importance : après l'envoi, vous associez chaque colonne vous-même.
| Colonne | Obligatoire | Valeurs autorisées | À quoi elle sert |
|---|---|---|---|
prompt |
oui | texte libre, 10 caractères minimum | La question posée à l'IA, formulée comme un client la taperait |
type |
non | category_discovery, comparison, use_case, brand, transactional, informational, custom |
Type général de la question |
persona |
non | texte libre | Le public que représente la question, par exemple la direction des achats |
category |
non | recommendation, comparison, use_case, purchase, experience, alternative, feature, custom |
Ce sur quoi porte la question |
intent |
non | low, medium, high |
À quel point la question est proche d'un achat |
language |
non | code à deux lettres, par exemple de |
Langue de la question |
La fenêtre d'import affiche le même tableau derrière „Quelles colonnes existent et que signifient-elles ?". Le bouton „Télécharger le fichier modèle" fournit un CSV avec exactement cet en-tête et deux lignes d'exemple valides.
Pourquoi la catégorie pèse plus qu'il n'y paraît
Rankion en déduit l'étape du tunnel, et cette étape entre dans le score de priorité du prompt. Un prompt marqué purchase est donc classé autrement qu'un prompt marqué experience. Si vous omettez la colonne, recommendation s'applique.
Si vous omettez type, il est déduit de la catégorie : comparison donne comparison, purchase donne transactional, recommendation donne category_discovery. L'exception est brand, la mention de marque. Aucune catégorie ne la produit, indiquez-la donc explicitement lorsque vous en avez besoin.
Lorsqu'une valeur n'est pas reconnue
Si vous écrivez Vergleich au lieu de comparison, ou hoch au lieu de high, Rankion ne peut pas reprendre la valeur et applique celle par défaut. La ligne est tout de même importée : elle ne compte donc pas comme ignorée.
Pour que cela ne vous échappe pas, l'étape d'aperçu recense chaque cas avec le numéro de ligne et le nom de colonne :
Ligne 3, colonne category : Vergleich devient recommendation
Ligne 3, colonne intent : hoch devient medium
Les cellules concernées sont mises en évidence dans le tableau d'aperçu. Si l'association est fausse, revenez d'une étape avec „Retour" et choisissez une autre colonne. Inutile de réimporter le fichier.
Ce que montre l'aperçu
L'aperçu montre les valeurs qui seront réellement enregistrées, pas les cellules brutes de votre fichier. S'il affiche recommendation alors que votre fichier indique Vergleich, c'est recommendation qui arrivera en base. Vérifiez cette étape posément.
Via l'API
Le même import passe par POST /v1/tracking-projects/{id}/prompts/import. Outre imported, skipped et errors, la réponse contient replacements : pour chaque ligne et chaque champ, la valeur fournie et la valeur retenue.
Pensez à exploiter ce champ. Une ligne remplacée compte comme imported et n'apparaît jamais sous skipped. Qui ne regarde que le compteur des lignes ignorées prendra une catégorie réécrite en silence pour un import propre.