Ir al contenido

Publicación y versiones

Publicar crea una versión inmutable del borrador y, si aprueba la evaluación, la lleva a producción. Los canales de producción pasan a usarla en el siguiente mensaje. Para publicar hace falta el rol Publicador, Constructor o Administrador.

  1. En el Estudio, hacé clic en «Publicar» (arriba a la derecha). Sherlock guarda lo pendiente del borrador.
  2. En «Publicar una nueva versión»:
    • Qué cambió: queda en el historial de versiones y en el reporte mensual. Por ejemplo: «Se agregaron las condiciones de la póliza de hogar y se ajustó el tono.»
    • Cambios respecto de producción: la diferencia entre el borrador y la versión en producción, campo por campo («Instrucciones», «Bases de conocimiento», «Modelo»…). En la primera publicación dice «Es la primera publicación de este agente.»
    • Evaluación obligatoria: cuántos casos se van a correr y el umbral.
  3. Hacé clic en «Evaluar y publicar».

Qué pasa después:

Resultado Qué ves Producción
La tasa de acierto llega al umbral La versión pasa de «Evaluando» a «En producción». En la auditoría: «… publicada tras aprobar la evaluación». Usa la versión nueva.
No llega al umbral La versión queda «No aprobada». La Bandeja avisa «v3 no aprobó la evaluación (70 % de acierto)». No cambia.

Si el agente no tiene casos habilitados, la publicación se rechaza: «La publicación exige evaluación y el agente no tiene casos de prueba. Agregá casos en la pestaña Evaluación.»

Un Administrador puede marcar «Publicar sin evaluación (excepción)» en el diálogo e indicar el motivo. La versión pasa directo a producción, queda marcada «Publicada con excepción» con su motivo y el evento queda en la auditoría. Usalo solo para urgencias (por ejemplo, retirar una respuesta equivocada) y corré la evaluación enseguida.

Si en la vista Evaluación desactivaste «Evaluación obligatoria antes de publicar», la versión pasa directo a producción, y el diálogo lo advierte.

La vista Versiones del Estudio lista todas las versiones, de la más nueva a la más vieja. Cada una muestra:

  • El número (v1, v2…), su estado y el identificador de su contenido (hash).
  • «Qué cambió», quién la creó y cuándo, y quién la publicó.
  • Evaluación: la tasa de acierto (clic para ver el resultado completo).
  • Mensajes, Latencia y Costo/msj mientras estuvo en producción.
Estado Qué significa
«Evaluando» Corriendo sus casos de prueba.
«Aprobada» Superó el umbral y espera que alguien la lleve a producción con «Publicar esta versión».
«No aprobada» No superó el umbral.
«En producción» Es la que usan los canales de producción ahora.
«Retirada» Estuvo en producción y fue reemplazada.
«Pendiente» Creada, esperando su evaluación.

Acciones de cada versión:

  • «Comparar con el borrador»: muestra campo por campo qué cambió entre esa versión (rojo) y el borrador actual (verde).
  • «Restaurar al borrador»: copia esa versión al borrador para seguir editando desde ahí. No toca producción.
  • «Publicar esta versión»: lleva a producción una versión aprobada que no está en producción.
  • «Volver a esta versión»: en versiones anteriores a la de producción, vuelve atrás en un clic.

Si una versión nueva da problemas, en Versiones buscá la anterior y hacé clic en «Volver a esta versión» → «Volver atrás». Los canales de producción pasan a usarla de inmediato. No se vuelve a evaluar, porque esa versión ya aprobó su evaluación.

Publicar una versión que no aprobó la evaluación es una excepción: solo un Administrador puede hacerlo, indicando el motivo.

Todo lo que configurás en el Estudio: identidad, instrucciones, pautas, estilo, modelo y sus parámetros, qué bases consulta y cómo, herramientas y operaciones habilitadas, colaboradores, derivación, guardrails, memoria y política de evaluación. No incluye los documentos de las bases, los canales (apuntan al ambiente, no a una versión) ni los casos de prueba.