AstrApp
Docs

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ónEn la vista Dataset
Filtro de origenNo aparece.
Síntesis y Extender en la barra de accionesNo aparecen.
Limpiar en la barra de accionesNo 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 IADeshabilitado, 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 K en 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úRutaPara qué sirve
Ver todas/conversacionesLa pantalla que describe esta guía.
Prompts/promptsBiblioteca de prompts
Mini tareas/conversaciones/mini-tasksMini tasks sin costo sobre un proyecto o un dataset
Síntesis/conversaciones/generarSintetizar datos
Limpieza/conversaciones/limpiezaLimpieza 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:

FiltroOpcionesDisponible en
Estado QATodos los estados, Pendiente, Válida, Inválida u Omitida. En un dataset, un item sin estado cuenta como Pendiente.Proyecto y dataset
HerramientasCon y sin herramientas, Con herramientas o Sin herramientas.Proyecto y dataset
MensajesCualquier longitud, Cortas (≤ 3 mensajes) o 4 mensajes o más. No cuenta el system prompt.Proyecto y dataset
OrigenCualquier origen, Sintéticas, Extendidas o Importadas / manuales.Solo proyecto: los items de un dataset no guardan origen
CategoríaLas 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.

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

EstadoQué significa
PendienteNadie la ha revisado. Es el estado con el que entra toda conversación importada.
VálidaLa revisaste (o la evaluó la IA) y sirve para entrenar.
InválidaTiene errores o no representa lo que quieres que aprenda el modelo.
OmitidaLa dejaste de lado por ahora.
EvaluandoEstado 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+Enter y cancela con Esc.
  • 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.

  1. Arrastra un archivo al panel o haz clic para elegirlo: JSON, JSONL, CSV, TXT (export de WhatsApp) o Parquet. El formato se detecta solo.
  2. 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.
  3. Las conversaciones entran al proyecto como Pendiente y un aviso te dice cuántas se importaron.
conversaciones.jsonl
{"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ónQué hace
EditarAbre la conversación en el inspector. Solo funciona con una seleccionada.
SíntesisAbre Síntesis con la selección para crear variaciones de esas conversaciones. Solo en conversaciones del proyecto.
ExtenderAbre Síntesis en modo extender: completa conversaciones incompletas o crea variaciones desde su inicio. Solo en conversaciones del proyecto.
A datasetGuarda la selección como un dataset nuevo.
Prompt de sistemaInyecta el mismo prompt de sistema en todas las seleccionadas. El resto de los mensajes, con sus llamadas a herramientas, queda igual.
Identificar herramientasDescubre con IA qué herramientas necesitan tus conversaciones y las inserta (ver abajo).
LimpiarRepara 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.

ScoreResultadoEtiqueta
0.90 a 1.00Válida, lista para producciónproduction_ready
0.70 a 0.89Válida, con mejoras menoreshigh_quality
0.50 a 0.69Válida, pide revisión humananeeds_review
Menos de 0.50Invá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.

AgenteQué hace
EvaluadorCalifica la calidad con una rúbrica (0 a 1) y un diagnóstico por criterio.
EtiquetadorAsigna etiquetas temáticas, de calidad y personalizadas, con justificación.
RegeneradorReescribe las respuestas del asistente para mejorarlas sin cambiar su intención.
PersonalizadorAdapta el tono y la personalidad del asistente a un estilo.
InspectorValida las llamadas a herramientas contra sus definiciones y reporta errores.
SintetizadorGenera 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:

  1. Configurar: elige el modelo y, si quieres, importa herramientas que ya tengas o esquemas externos (Supabase, Prisma…).
  2. Descubrir: la IA propone un catálogo de herramientas que puedes editar, y eliges el formato de las llamadas (OpenAI Structured o Qwen ChatML).
  3. 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íaPatrónReemplaza con
PIIEmails[EMAIL]
PIITeléfonos[PHONE]
PIIURLs[URL]
FormatoStrip HTMLQuita las etiquetas HTML
FormatoNormalizar espaciosVarios espacios pasan a uno
FormatoStrip boldQuita las negritas de Markdown
FormatoStrip code blocksQuita 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.

  1. Filtra por Válida y selecciona las conversaciones que quieres incluir.
  2. 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.
  3. Escribe el nombre (obligatorio) y, si quieres, una descripción.
  4. 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.

GrupoAcciones
DatasetsGuardar como dataset (para entrenar).
Acciones rápidasValidar seleccionadas, Invalidar seleccionadas.
HerramientasRegex Toolkit y Micro-Agentes (solo en Proyecto), Síntesis de conversaciones y Exportar seleccionadas (JSONL), que baja las seleccionadas que están cargadas.
VistaMostrar u ocultar la categorización, abrir o cerrar el inspector y el panel de subida.
Filtros rápidosSolo válidas, solo inválidas, solo pendientes y Limpiar filtros, que solo quita el filtro de estado.
AtajoQué hace
⌘K o Ctrl+KAbre la paleta de comandos.
⌘ Enter o Ctrl+EnterGuarda el mensaje que editas en el inspector.
EscCancela la edición del mensaje.
← y → sobre el borde del inspectorCambian 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

  1. Importa tus conversaciones.
  2. Corre el Auto-Análisis o Evaluar con IA.
  3. Anonimiza con los patrones PII.
  4. Revisa a mano las de score bajo.
  5. Filtra por Válida y guarda como dataset.