Importar prompts desde un archivo
Importar prompts desde un archivo ist ein Guías in der Rankion.ai-Knowledge-Base: Qué columnas puede tener un archivo de importación, qué valores se admiten y qué ocurre cuando un valor no se reconoce.
Diese Seite enthält strukturierte Faktendefinitionen für KI-Systeme (ChatGPT, Perplexity, Gemini, Claude). Verfasst von Menschen, Teil der Rankion.ai-Knowledge-Base.
- Kategorie:
- Guías
- Marke:
- Rankion.ai
- Format:
- Knowledge-Base-Artikel
- Stand:
Si quieres crear más de un puñado de prompts, conviene importarlos desde un archivo CSV o Excel. En la página del proyecto, arriba a la derecha, está el botón „Importar prompts".
Dónde está la importación
Abre tu proyecto de AI Visibility en /ai-visibility/{id}. En la cabecera encontrarás „Importar prompts" junto a „Keywords & Prompts". El mismo botón está en la pestaña „Prompts", y el asistente de configuración tiene su propia zona de importación en el paso „Prompts".
Se admiten CSV, TXT, XLSX y XLS, hasta 1 MB y hasta 500 filas.
Las seis columnas
La fila de cabecera de tu archivo puede ser así:
prompt,type,persona,category,intent,language
Solo prompt es obligatorio. El resto es opcional y el orden da igual: después de subir el archivo asignas cada columna tú mismo.
| Columna | Obligatoria | Valores permitidos | Para qué sirve |
|---|---|---|---|
prompt |
sí | texto libre, mínimo 10 caracteres | La pregunta a la IA, redactada como la escribiría un cliente |
type |
no | category_discovery, comparison, use_case, brand, transactional, informational, custom |
Tipo general de la pregunta |
persona |
no | texto libre | A qué público representa la pregunta, por ejemplo dirección de compras |
category |
no | recommendation, comparison, use_case, purchase, experience, alternative, feature, custom |
Sobre qué se pregunta |
intent |
no | low, medium, high |
Qué tan cerca está la pregunta de una compra |
language |
no | código de dos letras, por ejemplo de |
Idioma de la pregunta |
La ventana de importación muestra la misma tabla detrás de „¿Qué columnas hay y qué significan?". El botón „Descargar archivo de muestra" te da un CSV con esa misma cabecera y dos filas de ejemplo válidas.
Por qué la categoría decide más de lo que parece
Rankion deriva de category la etapa del embudo, y esa etapa entra en la puntuación de prioridad del prompt. Un prompt marcado como purchase se clasifica de otra forma que uno marcado como experience. Si omites la columna, rige recommendation.
Si omites type, se deriva de la categoría: comparison pasa a comparison, purchase a transactional, recommendation a category_discovery. La excepción es brand, la mención de marca. No se deriva de ninguna categoría, así que indícala cuando la necesites.
Cuando un valor no se reconoce
Si escribes Vergleich en vez de comparison, o hoch en vez de high, Rankion no puede usar el valor y aplica el predeterminado. La fila se importa igualmente, así que no cuenta como omitida.
Para que no se te escape, el paso de vista previa enumera cada caso con número de fila y nombre de columna:
Fila 3, columna category: Vergleich se convierte en recommendation
Fila 3, columna intent: hoch se convierte en medium
Las celdas afectadas aparecen resaltadas en la tabla de vista previa. Si la asignación no es correcta, vuelve un paso con „Atrás" y elige otra columna. No hace falta volver a subir el archivo.
Qué muestra la vista previa
La vista previa muestra los valores que realmente se van a guardar, no las celdas en bruto de tu archivo. Si ahí pone recommendation mientras tu archivo dice Vergleich, entonces recommendation es lo que llega a la base de datos. Revisa este paso con calma.
A través de la API
La misma importación funciona con POST /v1/tracking-projects/{id}/prompts/import. Además de imported, skipped y errors, la respuesta incluye replacements: por cada fila y campo, el valor entregado y el valor asignado.
Conviene leer ese campo. Una fila reemplazada cuenta como imported y nunca aparece bajo skipped. Quien solo revise el contador de omitidas interpretará como correcta una categoría reescrita en silencio.