Conversaciones
Revisa, limpia, valida y etiqueta tus conversaciones de entrenamiento en un solo lugar, las de un proyecto o los ejemplos de un dataset, y guarda las buenas como dataset.
Cómo está organizada la pantalla
Entra a Conversaciones › Ver todas en el menú lateral. Arriba está la barra de herramientas y, debajo, las estadísticas. La lista ocupa el centro; a la izquierda se abre el panel de Auto-Análisis y a la derecha el inspector de la conversación que abras.
Qué conversaciones conviene reunir y en qué formato lo explica Importar conversaciones. Esta guía cubre cómo trabajarlas una vez que están en AstrApp.
Proyecto o dataset
El selector Proyecto / Dataset decide qué ves. Con Proyecto eliges un proyecto y trabajas con todas sus conversaciones. Con Dataset eliges un dataset y editas sus ejemplos; es donde terminas cuando abres un dataset desde Datasets.
Al editar o procesar, se modifica lo que estás viendo (lo explica el botón ? junto al selector). En Proyecto cambian las conversaciones del proyecto, y los datasets que las usan por referencia ven el cambio. En Dataset cambian solo los items de ese dataset: un item que es referencia a una conversación del proyecto recibe su propia copia y el proyecto no se toca.
Casi todo funciona igual en las dos vistas: la búsqueda, los filtros, el orden, las estadísticas, editar, validar, eliminar, inyectar el prompt de sistema, enviar a un dataset, identificar herramientas, guardar el análisis de categorías y las Mini tasks. Las acciones que leen y escriben las conversaciones del proyecto se quedan en Proyecto:
| Acción | En la vista Dataset |
|---|---|
| Filtro de origen | No aparece. |
| Síntesis y Extender en la barra de acciones | No aparecen. |
| Limpiar en la barra de acciones | No aparece. |
| Regex Toolkit (⌘K) | Un aviso te sugiere Mini tasks › Buscar y reemplazar. |
| Evaluar con IA (Procesar) | Deshabilitado, con la marca «Solo Proyecto». |
| Micro-agentes IA | Deshabilitado, con la marca «Solo Proyecto». |
Para limpiar o reemplazar texto dentro de un dataset, usa las Mini tasks: trabajan sobre el dataset y el proyecto no cambia.
Barra de herramientas
- Importar abre el panel de subida rápida.
- Procesar agrupa los flujos de la sección. Con IA: Evaluar con IA, Identificar herramientas y Síntesis. Sin costo: Limpieza y Mini Tasks.
- El botón de recargar vuelve a pedir la lista.
- El botón
⌘K(Ctrl Ken Windows y Linux) abre la paleta de comandos.
Estadísticas
Debajo de la barra ves el total de conversaciones, cuántas son válidas e inválidas (con su porcentaje), cuántas siguen pendientes y el score promedio. Son conteos de todo el proyecto o dataset que estás viendo: no cambian con los filtros. El número de registros bajo el título Conversaciones sí los refleja.
El resto del grupo Conversaciones
| Entrada del menú | Ruta | Para qué sirve |
|---|---|---|
| Ver todas | /conversaciones | La pantalla que describe esta guía. |
| Prompts | /prompts | Biblioteca de prompts |
| Mini tareas | /conversaciones/mini-tasks | Mini tasks sin costo sobre un proyecto o un dataset |
| Síntesis | /conversaciones/generar | Sintetizar datos |
| Limpieza | /conversaciones/limpieza | Limpieza rápida y regex sobre todo el proyecto (ver abajo). |
Buscar, filtrar y ordenar
La búsqueda revisa el texto de todos los mensajes (usuario, asistente y system) y corre en el servidor, así que encuentra coincidencias aunque no estén cargadas en pantalla. Funciona igual en Proyecto y en Dataset, incluidos los items que son referencia a una conversación del proyecto. Puedes combinarla con estos filtros:
| Filtro | Opciones | Disponible en |
|---|---|---|
| Estado QA | Todos los estados, Pendiente, Válida, Inválida u Omitida. En un dataset, un item sin estado cuenta como Pendiente. | Proyecto y dataset |
| Herramientas | Con y sin herramientas, Con herramientas o Sin herramientas. | Proyecto y dataset |
| Mensajes | Cualquier longitud, Cortas (≤ 3 mensajes) o 4 mensajes o más. No cuenta el system prompt. | Proyecto y dataset |
| Origen | Cualquier origen, Sintéticas, Extendidas o Importadas / manuales. | Solo proyecto: los items de un dataset no guardan origen |
| Categoría | Las categorías que detecta el Auto-Análisis (ver abajo). Filtra solo lo que ya está cargado en la lista. | Proyecto y dataset |
Con herramientas significa que hay alguna llamada o respuesta de herramienta: tool_calls, function_call, un mensaje de rol tool o function, o un bloque <tool_call> o Action: … Action Input: en un mensaje que no es del usuario ni el system prompt. Los ejemplos de llamadas que trae el system prompt no cuentan.
Con un dataset muy grande, filtrar por herramientas o por mensajes puede tardar demasiado: la lista te avisa que agregues un filtro más específico, como una búsqueda o un estado.
Para ordenar, en pantallas anchas haz clic en Score, Estado o Fecha en el encabezado de la lista; cada clic alterna entre ascendente y descendente. En pantallas angostas usa el selector: Más recientes, Más antiguas, Score de mayor a menor, Score de menor a mayor o Por estado. El orden funciona igual en Proyecto y en Dataset.
La lista carga 50 conversaciones a la vez. El pie indica cuántas ves del total y el botón Cargar más trae las siguientes.
La lista de conversaciones
Cada fila resume una conversación completa.
La fila muestra el inicio del prompt de sistema (si hay), el primer mensaje del usuario y la primera respuesta del asistente. Debajo van el número de mensajes, el score (verde desde 0.70, ámbar de 0.40 a 0.69 y rojo por debajo), los marcadores de sintética, herramientas y semilla, y tus etiquetas. A la derecha, el estado y la fecha.
Menú de cada fila
El botón ⋮ de la fila ofrece Ver / editar, Marcar válida, Marcar inválida, Extender conversación (solo en el proyecto) y Guardar como dataset, sin tener que seleccionarla primero.
Estados de validación
| Estado | Qué significa |
|---|---|
| Pendiente | Nadie la ha revisado. Es el estado con el que entra toda conversación importada. |
| Válida | La revisaste (o la evaluó la IA) y sirve para entrenar. |
| Inválida | Tiene errores o no representa lo que quieres que aprenda el modelo. |
| Omitida | La dejaste de lado por ahora. |
| Evaluando | Estado temporal mientras corre Evaluar con IA. |
El estado no filtra el entrenamiento por sí solo
Marcar una conversación como inválida no la saca de un dataset. Para entrenar solo con las buenas, filtra por Válida y guarda esa selección como dataset.
Inspector de conversación
Haz clic en una fila para abrir el inspector con la conversación completa. Vuelve a hacer clic en la misma fila, o en la X, para cerrarlo.
Desde 1024 px de ancho el inspector se abre junto a la lista: arrastra su borde para hacerlo más ancho o más angosto. En pantallas más chicas se abre encima de la lista. Los botones de anterior y siguiente de su cabecera te llevan a la conversación vecina.
Estado y calificación
La cabecera tiene un botón por estado: Válida, Inválida, Omitida y Pendiente. Las estrellas califican de 1 a 5 y se guardan como score de 0 a 1 (estrellas ÷ 5: tres estrellas son 0.60).
Editar mensajes
- Haz doble clic en un mensaje (o usa su lápiz) para editarlo ahí mismo. Guarda con Guardar o
Ctrl+Entery cancela conEsc. - Las flechas de cada mensaje lo suben o lo bajan; el prompt de sistema se queda primero.
- Editar abre el editor completo: cambia el rol de un mensaje (System, User, Assistant o Tool), agrega mensajes, edita llamadas a herramientas y termina con Guardar cambios.
- Inyectar System Prompt toma un prompt de tu biblioteca y lo pone como primer mensaje (reemplaza el que haya).
- Si la conversación repite mensajes idénticos, aparece Quitar N duplicados.
Etiquetas y resultado de la evaluación
Escribe etiquetas separadas por coma o Enter. El campo sugiere las predefinidas: production_ready, high_quality, needs_review, uses_tools, multi_turn, complex_query, good_escalation y good_context. Si evaluaste la conversación con IA, el inspector también muestra el score, las etiquetas y los motivos del evaluador.
Acciones del inspector
El desplegable Acciones tiene Copiar JSON, el menú Opciones (Guardar en dataset… y Generar similares, que abre Síntesis con esta conversación) y el botón rojo para eliminarla, que pide confirmación.
Importar conversaciones
El botón Importar de la barra abre un panel de subida rápida al proyecto que tienes seleccionado.
- Arrastra un archivo al panel o haz clic para elegirlo: JSON, JSONL, CSV, TXT (export de WhatsApp) o Parquet. El formato se detecta solo.
- Si es un
.txt, elige cómo leerlo (Export de WhatsApp, Prefijos de rol o Líneas alternadas) y haz clic en Subir. Los demás formatos se suben al soltarlos. - Las conversaciones entran al proyecto como Pendiente y un aviso te dice cuántas se importaron.
{"messages": [{"role": "system", "content": "Eres un asistente de ventas."}, {"role": "user", "content": "¿Cuál es el precio?"}, {"role": "assistant", "content": "Desde $9.99 al mes."}]}
{"messages": [{"role": "system", "content": "Eres un asistente de ventas."}, {"role": "user", "content": "¿Tienen soporte?"}, {"role": "assistant", "content": "Sí, 24/7 por chat y correo."}]}Para deduplicar o crear un dataset al importar
El panel rápido no quita duplicados ni crea un dataset. Para eso usa Datasets › Importar datos, que también identifica herramientas. Los pasos, los formatos y el tope de 4 MB por archivo están en Crear datasets.
Acciones en lote
Al marcar una o más conversaciones aparece una barra sobre la lista con las acciones para la selección.
| Botón | Qué hace |
|---|---|
| Editar | Abre la conversación en el inspector. Solo funciona con una seleccionada. |
| Síntesis | Abre Síntesis con la selección para crear variaciones de esas conversaciones. Solo en conversaciones del proyecto. |
| Extender | Abre Síntesis en modo extender: completa conversaciones incompletas o crea variaciones desde su inicio. Solo en conversaciones del proyecto. |
| A dataset | Guarda la selección como un dataset nuevo. |
| Prompt de sistema | Inyecta el mismo prompt de sistema en todas las seleccionadas. El resto de los mensajes, con sus llamadas a herramientas, queda igual. |
| Identificar herramientas | Descubre con IA qué herramientas necesitan tus conversaciones y las inserta (ver abajo). |
| Limpiar | Repara sin costo mensajes repetidos, formato incorrecto y herramientas mal formadas. Solo en conversaciones del proyecto. |
| Eliminar (bote) | Borra las seleccionadas después de pedirte confirmación. No se puede deshacer. |
| Deseleccionar (×) | Limpia la selección y oculta la barra. |
Panel izquierdo
En pantallas medianas y grandes, el panel de Auto-Análisis se abre solo al seleccionar conversaciones. Debajo del análisis tiene Validar e Invalidar para toda la selección, y accesos a Mini Tasks, Micro-agentes IA, Síntesis y Enviar a dataset.
Seleccionar todas
La casilla del encabezado selecciona las conversaciones cargadas. Si hay más, un aviso te ofrece Seleccionar las N conversaciones: toma todo lo que cumple la búsqueda y los filtros activos, menos el de categoría.
- Validar e Invalidar (del panel o de la paleta), Limpiar, Prompt de sistema y Mini Tasks procesan ese total. Mini Tasks lo recibe como «Todo lo filtrado».
- El resto de las acciones, incluidas Eliminar y A dataset, usan solo las conversaciones cargadas en pantalla. Al eliminar, el diálogo de confirmación te lo avisa.
Procesar con IA
Evaluar con IA, los micro-agentes e Identificar herramientas consumen créditos y te muestran el costo estimado antes de correr. Si conectas tu propia llave del proveedor en Configuración › Integraciones, pagas los tokens directo a él y no se descuentan créditos.
Evaluar con IA
Selecciona conversaciones del proyecto y elige Procesar › Evaluar con IA(en la vista Dataset aparece deshabilitada con la marca «Solo Proyecto»). Escoge el modelo juez (Gemini 2.5 Flash, Claude Haiku 4.5 o ChatGPT-4o), revisa el costo estimado y tu saldo, y lanza la evaluación. Cada conversación queda como válida o inválida, con un score de 0 a 1, etiquetas y motivos.
El evaluador juzga solo las respuestas del asistente: relevancia, que no invente datos, que responda completo, que respete el prompt de sistema y que sea coherente entre turnos. Si hay herramientas, revisa también que use la correcta con los parámetros correctos. Una sola alucinación invalida la conversación.
| Score | Resultado | Etiqueta |
|---|---|---|
| 0.90 a 1.00 | Válida, lista para producción | production_ready |
| 0.70 a 0.89 | Válida, con mejoras menores | high_quality |
| 0.50 a 0.69 | Válida, pide revisión humana | needs_review |
| Menos de 0.50 | Inválida | — |
Micro-agentes IA
Con conversaciones del proyecto seleccionadas, abre Micro-agentes IA en el panel izquierdo o desde la paleta (⌘K › Micro-Agentes). Elige el agente y el modelo (Gemini 2.5 Flash, Claude Haiku 4.5 o ChatGPT-4o), ajusta sus parámetros y revisa el prompt antes de ejecutar. Cada ejecución procesa hasta 50 conversaciones.
| Agente | Qué hace |
|---|---|
| Evaluador | Califica la calidad con una rúbrica (0 a 1) y un diagnóstico por criterio. |
| Etiquetador | Asigna etiquetas temáticas, de calidad y personalizadas, con justificación. |
| Regenerador | Reescribe las respuestas del asistente para mejorarlas sin cambiar su intención. |
| Personalizador | Adapta el tono y la personalidad del asistente a un estilo. |
| Inspector | Valida las llamadas a herramientas contra sus definiciones y reporta errores. |
| Sintetizador | Genera un reporte con métricas y recomendaciones sobre la selección. |
Los agentes y sus parámetros están en Microagentes.
Identificar herramientas
Requiere Starter+. Selecciona conversaciones y haz clic en Identificar herramientas en la barra de acciones. El asistente tiene tres pasos:
- Configurar: elige el modelo y, si quieres, importa herramientas que ya tengas o esquemas externos (Supabase, Prisma…).
- Descubrir: la IA propone un catálogo de herramientas que puedes editar, y eliges el formato de las llamadas (OpenAI Structured o Qwen ChatML).
- Vista previa y aplicar: revisa cómo quedan las conversaciones y aplica el cambio, que sigue corriendo en segundo plano.
Procesar › Identificar herramientas abre una página aparte que parte de un archivo: lo importas, configuras el análisis y revisas los resultados en pestañas. Cómo usar las herramientas después está en Herramientas (tools).
Síntesis y extensión
Síntesis genera conversaciones nuevas a partir de semillas de tu proyecto o del contenido de una URL. Extender completa conversaciones incompletas o crea variaciones a partir de su inicio. Ambas abren la página de síntesis con tu selección; los detalles están en Sintetizar datos.
Limpiar sin costo
Estas herramientas corren sin modelo de IA y no consumen créditos.
Auto-Análisis
El panel izquierdo revisa las conversaciones cargadas con validación programática: errores de estructura, problemas en el flujo de herramientas y qué tan variado es tu conjunto. Haz clic en Analizar y usa las categorías para filtrar la lista: ≤ 3 mensajes, Sin herramientas, Errores, Flujo de tools, Estructura repetitiva y Alucinación (datos que el asistente da sin consultar una herramienta). Guardar en DB marca cada conversación como válida o inválida según el análisis.
Regex Toolkit
Ábrelo desde la paleta (⌘K › Regex Toolkit) con conversaciones del proyecto seleccionadas; en la vista Dataset no se abre y un aviso te sugiere Mini tasks. Tiene tres pestañas: Patrones Regex (los predefinidos de abajo), Limpieza (recortar espacios, eliminar mensajes vacíos, normalizar espacios, quitar HTML o Markdown) y Personalizado (tu propia expresión, su reemplazo y sus flags). Antes de aplicar ves el primer mensaje antes y después del cambio.
| Categoría | Patrón | Reemplaza con |
|---|---|---|
| PII | Emails | [EMAIL] |
| PII | Teléfonos | [PHONE] |
| PII | URLs | [URL] |
| Formato | Strip HTML | Quita las etiquetas HTML |
| Formato | Normalizar espacios | Varios espacios pasan a uno |
| Formato | Strip bold | Quita las negritas de Markdown |
| Formato | Strip code blocks | Quita los bloques de código |
Los cambios son permanentes
Regex y limpieza reescriben el contenido de los mensajes y no tienen deshacer. Exporta una copia en JSONL antes de procesar lotes grandes, o usa Mini tasks › Buscar y reemplazar, que simula antes de aplicar.
Página de limpieza
Conversaciones › Limpieza aplica lo mismo sin seleccionar a mano. En la pestaña Limpieza rápida eliges las operaciones y el alcance (todas, solo pendientes o solo inválidas); en Regex avanzado tienes más patrones, como direcciones IP, puntos suspensivos o exclamaciones repetidas.
Mini tareas
Conversaciones › Mini tareas corre nueve tareas sin IA y sin costo sobre un proyecto o un dataset: Buscar y reemplazar, Validar para entrenamiento, Auditor, Detectar duplicados, Etiquetar herramientas, Score de calidad, Reparar herramientas, Validar herramientas y Convertir y descargar. Si la abres con Procesar › Mini Tasks o con el botón Mini Tasks del panel izquierdo, se lleva la vista, tu selección y tus filtros, y puedes correr la tarea sobre lo seleccionado, todo lo filtrado o todo.
Corren por lotes, las que reescriben mensajes se simulan primero y al terminar ves el antes y el después de cada conversación. Están descritas en Microagentes.
Guardar como dataset
Cuando tus conversaciones están limpias y validadas, conviértelas en un dataset para entrenar.
- Filtra por Válida y selecciona las conversaciones que quieres incluir.
- Haz clic en A dataset en la barra de acciones. También lo encuentras como Enviar a dataset en el panel izquierdo, Guardar como dataset en el menú de la fila y Guardar en dataset… en el inspector.
- Escribe el nombre (obligatorio) y, si quieres, una descripción.
- Haz clic en Crear Dataset. Al terminar, Abrir en Editor te muestra el dataset en esta misma pantalla, con la fuente Dataset.
El dataset aparece en Datasets y ya puedes elegirlo al entrenar. Qué más puedes hacer con él está en Crear datasets.
Paleta de comandos y atajos
La paleta (⌘K en Mac, Ctrl+K en Windows y Linux) reúne las acciones de la pantalla. Las que dependen de la selección se desactivan si no tienes conversaciones seleccionadas.
| Grupo | Acciones |
|---|---|
| Datasets | Guardar como dataset (para entrenar). |
| Acciones rápidas | Validar seleccionadas, Invalidar seleccionadas. |
| Herramientas | Regex Toolkit y Micro-Agentes (solo en Proyecto), Síntesis de conversaciones y Exportar seleccionadas (JSONL), que baja las seleccionadas que están cargadas. |
| Vista | Mostrar u ocultar la categorización, abrir o cerrar el inspector y el panel de subida. |
| Filtros rápidos | Solo válidas, solo inválidas, solo pendientes y Limpiar filtros, que solo quita el filtro de estado. |
| Atajo | Qué hace |
|---|---|
| ⌘K o Ctrl+K | Abre la paleta de comandos. |
| ⌘ Enter o Ctrl+Enter | Guarda el mensaje que editas en el inspector. |
| Esc | Cancela la edición del mensaje. |
| ← y → sobre el borde del inspector | Cambian su ancho. |
Buenas prácticas
- Revisa una muestra a mano antes de entrenar. Los errores del dataset pasan directo al comportamiento del modelo.
- Deja que la máquina encuentre lo peor primero. Corre la Mini task Score de calidad (sin costo), el Auto-Análisis o Evaluar con IA y ordena por score de menor a mayor para revisar primero las más débiles.
- Anonimiza datos personales. Si tus conversaciones traen correos, teléfonos o enlaces de clientes, pásalas por los patrones PII del Regex Toolkit antes de entrenar o exportar.
- Usa un prompt de sistema consistente. Si varía entre conversaciones del mismo dataset, confunde al modelo; unifícalo con Prompt de sistema en lote.
- Respalda antes de borrar o reescribir. Antes de aplicar regex o eliminar en lote, exporta en JSONL:
⌘K› Exportar seleccionadas para las cargadas, o Mini tasks › Convertir y descargar para todo lo filtrado. - Prueba los agentes con pocas conversaciones. Corre un micro-agente sobre 10 o 20 antes de lanzarlo sobre cientos.
Flujo recomendado
- Importa tus conversaciones.
- Corre el Auto-Análisis o Evaluar con IA.
- Anonimiza con los patrones PII.
- Revisa a mano las de score bajo.
- Filtra por Válida y guarda como dataset.