Microagentes
Procesa tus conversaciones en lote. AstrApp incluye seis agentes de IA, que consumen créditos, y nueve Mini tasks: tareas programáticas sin IA y sin costo que corren por lotes sobre un proyecto o un dataset.
Dos familias
Agentes de IA
Ejecutan un prompt contra el modelo que elijas y transforman o califican cada conversación.
- Requieren elegir un modelo.
- Consumen créditos según los tokens usados.
- Antes de ejecutar ves la estimación de costo y el prompt completo.
- Solo trabajan sobre las conversaciones del proyecto.
Mini tasks
Funciones programáticas que corren sin modelo sobre un proyecto o un dataset.
- No consumen créditos.
- El resultado es determinista: la misma conversación da el mismo resultado.
- Corren por lotes, con progreso real, y se retoman si se cortan.
- Las que reescriben mensajes se simulan primero.
Dónde encontrarlos
| Qué | Cómo llegar |
|---|---|
| Agentes de IA | En Conversaciones, con la vista en Proyecto, selecciona las conversaciones y, en el panel lateral (sección Herramientas), haz clic en Micro-agentes IA. También con ⌘K / Ctrl K › Micro-Agentes. En la vista Dataset el botón aparece deshabilitado con la marca «Solo Proyecto». |
| Mini tasks | En el menú lateral, Conversaciones › Mini tareas. Desde Conversaciones, también en Procesar › Mini Tasks o con el botón Mini Tasks del panel lateral: así la página recibe el proyecto o dataset que estabas viendo, tu selección y tus filtros. |
Cuántas conversaciones procesa cada una
- Un agente de IA procesa las conversaciones que seleccionaste, hasta 50 por ejecución.
- Una Mini task no tiene ese tope: corre sobre las que seleccionaste, sobre todo lo filtrado o sobre todo el proyecto o dataset, por lotes.
Agentes de IA
Cada agente tiene un formato de salida y sus propios parámetros, que ajustas antes de ejecutar.
| Agente | Qué hace | Salida | Parámetros |
|---|---|---|---|
| Evaluador | Califica la conversación con una rúbrica por criterio y un score de 0 a 1. | Score (0-1) | Criterios de evaluación, umbral de aprobación |
| Etiquetador | Asigna tags temáticos, de calidad y personalizados. | Tags | Categorías de tags, máx. tags personalizados |
| Regenerador | Reescribe las respuestas del asistente para mejorar su calidad sin cambiar la intención. | Reescritura | Aspectos a mejorar |
| Personalizador | Adapta el tono del asistente a un estilo: formal, casual, técnico o empático. | Reescritura | Estilo de comunicación, nombre del asistente |
| Inspector | Revisa los tool calls contra las definiciones de herramientas que pegues y reporta errores. | Tags | Definiciones de herramientas (JSON) |
| Sintetizador | Analiza la conversación con métricas y recomendaciones. | Custom JSON | Enfoque del análisis, formato del reporte |
Antes de ejecutar
- Regenerador y Personalizador sobrescriben los mensajes de la conversación. Pruébalos primero con pocas conversaciones y revisa el resultado.
- El reporte del Sintetizador (hallazgos y recomendaciones) no se guarda: de una salida Custom JSON solo se escriben score, tags, mensajes y estado.
Mini tasks
Nueve tareas que corren sin modelo: validan el formato, detectan duplicados, etiquetan o reparan llamadas a herramientas, buscan y reemplazan texto o exportan. Cada una dice qué escribe y de qué tipo es.
| Tipo | Qué hace | Botón |
|---|---|---|
| Anota | Escribe tags, estado QA, score o su resultado. Se ejecuta directo. | Ejecutar |
| Reescribe | Cambia el texto de los mensajes. Primero se simula y aplicas después de revisar. | Simular |
| Exporta | No modifica nada: al terminar descargas un archivo. | Convertir |
Buscar y reemplazar
Anota o reescribeEncuentra un texto o patrón en tus conversaciones. En modo «Solo buscar» cuenta las coincidencias y puede etiquetar las conversaciones que coinciden; en modo «Buscar y reemplazar» cambia el texto en bloque.
Escribe: Solo buscar: la etiqueta que elijas (se agrega a las que coinciden y se quita de las que ya no coinciden). Buscar y reemplazar: los mensajes.
- Qué hacer: Solo buscar o Buscar y reemplazar.
- Patrón de búsqueda (máximo 300 caracteres) y tipo: Texto exacto o Expresión regular.
- Distinguir mayúsculas (apagado por defecto).
- Reemplazar con: vacío borra lo que coincide; en expresión regular puedes usar $1, $2… para reusar los grupos.
- Buscar en: todos los mensajes, o solo usuario, asistente, system prompt o respuestas de herramientas.
- Etiquetar coincidencias (opcional, solo al buscar).
Solo toca el texto de los mensajes: las llamadas estructuradas (tool_calls) no se modifican, pero un bloque <tool_call> escrito dentro del texto sí. Un patrón con repetición anidada, como (a+)+ o (.*)*, se rechaza antes de correr porque puede colgarse con textos largos.
Validar para entrenamiento
AnotaRevisa que cada conversación sirva para entrenar en formato de chat: roles válidos (system, user, assistant o tool), system prompt solo al inicio, turnos que alternan, que haya usuario y asistente, que cada respuesta de herramienta tenga su llamada, que no haya mensajes vacíos y que termine en el asistente. Válida significa cero errores.
Escribe: Estado QA según la opción que elijas (por defecto solo marca las inválidas, con sus primeros 5 motivos) y el resultado de la revisión.
- Modo estricto: convierte en error lo que normalmente es advertencia (turnos repetidos, mensajes vacíos o terminar sin respuesta del asistente).
- Estado QA: Marcar solo las inválidas (predeterminado), Marcar válidas e inválidas o No tocar el estado QA.
Un mensaje de usuario que empieza con <tool_response> (así entrega los resultados la plantilla de Qwen) cuenta como respuesta de herramienta, igual que en el Auditor y el Score de calidad.
Auditor
AnotaMide cada conversación (mensajes por rol, longitud promedio de usuario y asistente, llamadas a herramientas, sus respuestas y el JSON que no se puede leer) y lista los problemas que encuentra, del más grave al menos grave.
Escribe: Solo el resultado: métricas y hasta 15 hallazgos. No toca estado QA ni tags.
- No tiene parámetros.
Detectar duplicados
AnotaEncuentra conversaciones repetidas comparando todo su contenido (aunque cambien espacios o mayúsculas) y marca las copias. La primera que aparece se queda como original: con «Todo lo filtrado» o todo el alcance, es la más antigua.
Escribe: La etiqueta «duplicada», la referencia a la original y, si lo eliges, el estado QA Omitida. A las que dejaron de ser duplicadas les quita la etiqueta.
- Comparar también el system prompt (apagado por defecto: el mismo diálogo con distinto system prompt cuenta como duplicado).
- Con las duplicadas: Solo etiquetarlas (predeterminado) o Etiquetarlas y marcarlas como Omitidas.
Si una conversación deja de ser duplicada, su estado Omitida no se revierte solo: no se sabe cuál tenía antes.
Etiquetar herramientas
AnotaDetecta qué herramientas usa cada conversación, en cualquier formato (tool_calls, bloques <tool_call>, function_call o Action:) y por sus respuestas (mensajes de rol tool o function), y lo guarda como tags para filtrarlas después. Ignora los ejemplos de llamadas que trae el system prompt.
Escribe: Tags «con_herramientas» y «herramienta:<nombre>» (hasta 20), o «sin_herramientas». En cada corrida reemplaza solo sus propios tags; los demás se conservan.
- No tiene parámetros.
Score de calidad
AnotaCalcula un score de 0 a 1, sin IA, con cinco dimensiones: formato (25 %), alternancia (20 %), balance de longitud entre usuario y asistente (15 %), herramientas (20 %) y completitud (20 %).
Escribe: Score QA según la opción que elijas y el desglose por dimensión.
- Score QA: Guardar solo si no tiene score (predeterminado), Guardar siempre (sobrescribe) o No guardar como score QA.
Reparar herramientas
ReescribeArregla el JSON roto de las llamadas a herramientas (True/False/None de Python, comas finales, llaves sin comillas y comillas simples) y corrige las mayúsculas de sus nombres contra tus herramientas. Cada arreglo se aplica fuera de las cadenas de texto, así el contenido de un argumento no se altera.
Escribe: Los mensajes con llamadas a herramientas.
- Herramientas conocidas (opcional), separadas por coma. Vacío = las herramientas activas del proyecto o, si el proyecto no tiene, las de tu organización.
Una llamada cuyo JSON no se puede reparar se deja como está y se cuenta en el resultado.
Validar herramientas
AnotaComprueba cada llamada contra las definiciones de tus herramientas: que la herramienta exista, que los argumentos sean un objeto, que no falten requeridos ni sobren desconocidos, que los tipos y los valores de enum sean correctos y que cada llamada tenga su respuesta.
Escribe: Estado QA según la opción que elijas y el reporte de errores (hasta 10).
- Definiciones: las herramientas del proyecto (las activas; si el proyecto no tiene, las de tu organización) o pegarlas en JSON.
- Nombre del asistente (opcional): revisa que el asistente no se presente con otro nombre.
- Modo estricto (encendido por defecto): además revisa que los campos booleanos sean booleanos.
- Estado QA: las mismas opciones que Validar para entrenamiento.
Sin definiciones, la conversación se omite con el aviso «agrégalas en Herramientas o pega el JSON»: nunca se da por válida. Una conversación sin llamadas queda como analizada y su estado QA no se toca.
Convertir y descargar
ExportaExporta las conversaciones a JSONL (messages, para entrenar), ShareGPT (conversations), CSV (una fila por mensaje) o JSON (arreglo) y descargas el archivo al terminar. Conserva las llamadas a herramientas.
Escribe: Nada: no modifica tus conversaciones.
- Formato: JSONL, ShareGPT, CSV o JSON.
- Incluir system prompt (encendido por defecto).
El CSV respeta comillas y saltos de línea dentro del campo, así lo puedes volver a importar tal cual. El archivo tiene un tope de 150 MB.
Además de lo que indica «Escribe», cada conversación que la tarea procesa guarda su resultado (métricas, hallazgos, coincidencias o reparaciones) junto con ella. Convertir y descargar es la excepción: no guarda nada.
Cómo se corre una Mini task
La página de Mini tasks se arma en tres pasos, en la columna de configuración:
- Dónde: elige Proyecto o Dataset y cuál. Debajo ves en una línea dónde se guardarán los cambios.
- Qué conversaciones: las que seleccionaste en Conversaciones, todo lo filtrado (los filtros que tenías activos: búsqueda, estado, herramientas, mensajes y, en Proyecto, origen) o todo el proyecto o dataset. Cada opción muestra cuántas conversaciones son.
- Qué hacer: elige la tarea, revisa qué escribe y ajusta sus parámetros. Se validan antes de ejecutar y el error aparece junto al campo. Luego pulsa Ejecutar, Simular o Convertir, según el tipo.
Por lotes, con progreso real
- Se procesa por lotes (100 conversaciones; 40 al convertir) y cada lote queda guardado al terminar.
- La barra de progreso cuenta las conversaciones procesadas contra el total.
- Cancelar detiene la corrida al terminar el lote en curso. Lo procesado ya quedó guardado.
- Si recargas o cierras la página, al volver (en el mismo navegador) la corrida aparece como interrumpida: Retomar sigue desde donde iba sin repetir lo ya procesado, y Descartar la olvida. Una corrida cancelada o en pausa también se puede retomar. La excepción es Convertir y descargar: el archivo no se guarda al recargar, así que el botón dice «Convertir de nuevo» y empieza desde el principio (no modifica nada en tus datos).
- Sigue aunque navegues a otra página de la app: la ves en la cola de tareas.
- Si se cae la conexión o falla el servidor, reintenta tres veces y después queda en pausa para que la retomes.
Simular y aplicar
Las tareas que reescriben mensajes (Buscar y reemplazar en modo «Buscar y reemplazar» y Reparar herramientas) se simulan primero. La simulación no guarda nada: recorre las mismas conversaciones y te muestra el antes y el después de cada una. Si te convence, pulsa Aplicar cambios y confirma.
Antes de aplicar
- Al aplicar, la tarea se vuelve a calcular sobre los datos actuales. Si alguien editó una conversación mientras tanto, queda en conflicto y no se sobrescribe su cambio.
- No hay deshacer automático. La red de seguridad es la simulación: revísala con el filtro «Modificadas» de la tabla antes de aplicar.
Estado QA sin pisar evaluaciones
Por defecto, una Mini task no da por buena una conversación solo porque su formato es correcto ni pisa el score que dejó otra evaluación. Puedes cambiarlo en cada corrida, en los parámetros de la tarea.
| Tarea | Predeterminado | Otras opciones |
|---|---|---|
| Validar para entrenamiento y Validar herramientas | Marcar solo las inválidas: una conversación con buen formato no se da por válida. | Marcar válidas e inválidas · No tocar el estado QA |
| Score de calidad | Guardar solo si no tiene score: no pisa el que dejó una evaluación con IA. | Guardar siempre (sobrescribe) · No guardar como score QA |
| Detectar duplicados | Solo etiquetarlas: el estado QA no cambia. | Etiquetarlas y marcarlas como Omitidas |
Proyecto o Dataset
Se modifica lo que estás viendo.
Proyecto
Cambian las conversaciones del proyecto. Los datasets que las usan por referencia ven el cambio; los que tienen su propia copia, no.
Dataset
Cambian los items de ese dataset y el proyecto no cambia. Un item que es referencia a una conversación del proyecto recibe su propia copia al modificarse; la tabla de resultados lo marca con «Recibió su propia copia».
Resultados de una Mini task
Mientras corre y al terminar, el panel de la corrida muestra el progreso, cuatro contadores y una tabla con una fila por conversación.
| Contador | Qué cuenta |
|---|---|
| Modificadas | Conversaciones que cambiaron. En una simulación se llaman «Se modificarían». |
| Analizadas | Conversaciones que la tarea revisó. Su resultado se guarda, salvo en Convertir y descargar. |
| Sin cambios / omitidas | Nada que cambiar, o se saltaron con su motivo: sin mensajes legibles, más de 1 MB o ya procesadas en esta corrida. |
| Con error o conflicto | Falló la tarea en esa conversación, o alguien la editó mientras se procesaba y no se sobrescribió. |
| Columna | Qué muestra |
|---|---|
| Conversación | Sus 3 primeras líneas sin contar el system prompt, para reconocerla, y su id (se copia con un clic). |
| Antes | En tareas que reescriben, los turnos que cambian, recortados alrededor del cambio. En tareas que anotan, el valor anterior de los campos que cambian (estado QA, score, tags). |
| Después | Lo mismo ya cambiado, recortado en el mismo lugar. En tareas que anotan, también las líneas del resultado (por ejemplo, el score o los primeros errores). |
| Resultado | Modificada (o «Se modificaría» en una simulación), Analizada, Sin cambios, Omitida, Con error o Conflicto, con un resumen y el motivo si falló. |
- Filtra la tabla por resultado (Todas, Modificadas, Analizadas, Sin cambios, Omitidas, Con error). Muestra 25 filas por página; en el celular cada fila es una tarjeta.
- Reporte CSV descarga la tabla: id, resultado, resumen, vista previa, antes, después, si recibió copia propia y el error.
- En Convertir y descargar, Descargar archivo baja las conversaciones convertidas en el formato que elegiste.
- Al terminar una corrida que escribe, Ver en Conversaciones te lleva a la lista para revisar el resultado con los filtros.
Modelos para los agentes de IA
Las Mini tasks no usan modelo. Para los agentes de IA eliges uno de estos:
| Modelo | Proveedor | Costo relativo |
|---|---|---|
| Gemini 2.5 Flash | El más bajo | |
| Claude Haiku 4.5 | Anthropic | Medio |
| ChatGPT-4o | OpenAI | El más alto |
Si conectaste tu propia API key del proveedor del modelo, la ejecución no te cobra créditos: pagas los tokens directamente a tu proveedor.
Qué guarda cada formato de salida
Solo agentes de IA. Lo que guarda cada Mini task está en su tarjeta.
| Salida | Qué cambia en la conversación |
|---|---|
| Score (0-1) | Actualiza el score de calidad y, si el agente lo indica, marca la conversación como válida o inválida. |
| Tags | Agrega los tags nuevos a los que ya tenía la conversación. |
| Reescritura | Reemplaza los mensajes de la conversación por la versión reescrita. |
| Custom JSON | Actualiza los campos que devuelva el modelo: score, tags, mensajes o estado. |
Resultado de un agente de IA
Al terminar, el diálogo del agente te muestra:
- Cuántas conversaciones se procesaron y cuántas fallaron.
- El primer error, con una sugerencia para corregirlo.
- El costo de la ejecución.
Consejos
- Prueba los agentes de IA con 10 a 20 conversaciones antes de procesar lotes grandes.
- Empieza por las Mini tasks: valida el formato con Validar para entrenamiento y encuentra copias con Detectar duplicados antes de gastar créditos.
- Filtra antes de procesar: en Conversaciones aplica tus filtros, marca todas las de la página, elige «Seleccionar las N conversaciones» y abre Mini Tasks. La opción «Todo lo filtrado» recorre exactamente ese conjunto.
- Usa el Evaluador para encontrar conversaciones de baja calidad y el Regenerador para mejorarlas.