Ir al contenido

El Estudio del agente

El Estudio es la pantalla de cada agente: ahí lo diseñás, lo probás, conectás sus canales, lo evaluás, lo publicás y mirás su actividad. Se abre al hacer clic en un agente de la lista.

De izquierda a derecha:

  • Volver, el ícono y el nombre del agente.
  • La píldora de estado: «En producción · v2» o «Sin publicar». Si hay cambios en el borrador que no están en producción: «Borrador con cambios sin publicar».
  • El indicador de guardado: «Guardando…», «Cambios sin guardar», «Guardado hace 2 min» o «No se pudo guardar». Si tu rol no edita, dice «Solo lectura».
  • «Más acciones» (⋯, solo Constructor y Administrador): «Duplicar», «Exportar como archivo» y «Archivar».
  • «Probar»: abre Diseño con el panel de prueba.
  • «Publicar» si tu rol publica, o «Evaluar cambios» si tu rol solo puede evaluar (Editor). Ver Publicación.
Vista Para qué sirve
Resumen Descripción, preguntas sugeridas, actividad de los últimos 7 días, conversaciones recientes, la lista para producción, la última evaluación y los canales.
Diseño El lienzo con las piezas del agente y el panel Configurar / Probar.
Canales Conectar y administrar widget, link, WhatsApp, voz y API. Ver Canales.
Evaluación Política de publicación, casos de prueba e historial de evaluaciones. Ver Evaluación. No aparece para el rol Observador.
Versiones Cada versión publicada, con su evaluación y métricas, para comparar y volver atrás. Ver Versiones.
Actividad «Conversaciones con personas reales»: canal, mensajes, costo y última actividad. Las pruebas del panel «Probar» no se cuentan acá.

El lienzo muestra el recorrido real de cada mensaje, de arriba hacia abajo:

Canales → Entrada segura → Agente → Salida segura → Respuesta
│
├─ consulta → Conocimiento
├─ usa ──────→ Herramientas
└─ deriva ───→ Derivación a humano

La forma es fija: las piezas no se arrastran. Tocá una pieza para configurarla en el panel de la derecha (o elegila de la lista cuando no hay ninguna seleccionada). Cada pieza tiene un punto de salud:

  • Verde: configurada.
  • Ámbar: requiere atención (por ejemplo, «Sin bases asignadas» o «Sin modelo configurado»).
  • Gris: desactivada u opcional.
Pieza Qué configurás Más información
Canales Lista de canales con su estado y el botón «Gestionar canales». Canales
Entrada segura Datos personales, prompt injection, temas bloqueados y largo máximo del mensaje. Guardrails
Agente Identidad, instrucciones, pautas de comportamiento y modelo. Instrucciones, Modelo
Conocimiento Bases asignadas y cómo busca en ellas. Conocimiento
Herramientas Herramientas integradas, APIs, servidores MCP y agentes colaboradores. Herramientas, Colaboradores
Derivación a humano Si puede derivar, el mensaje al derivar y un webhook opcional. Derivación
Salida segura Datos sensibles que se controlan en la respuesta y qué hacer si aparecen. Salida segura
Respuesta Tono, extensión, voseo, mensaje de bienvenida y preguntas sugeridas. Tono y estilo

Cuando mandás un mensaje en Probar, el lienzo se ilumina en el orden en que el mensaje pasó por cada pieza: azul si pasó sin novedad, ámbar si una protección actuó (por ejemplo, enmascaró un dato personal) y rojo si una protección frenó la respuesta. El brillo se apaga a los pocos segundos. Ver Probar el agente.

  • Constructor y Administrador editan todas las piezas.
  • Editor y Publicador editan solo el contenido: en las piezas Agente y Respuesta ven un editor acotado con «Descripción», «Tono y estilo», «Reglas de negocio», «Bienvenida y preguntas sugeridas» y «Cuando no encuentra la respuesta». El resto es «Solo lectura con tu rol».
  • Observador ve todo en solo lectura.

En Resumen, la tarjeta «Listo para producción» cuenta cuántos de estos seis puntos están completos («4 de 6») y ofrece «Resolver» en cada punto pendiente, que te lleva a la pieza o vista correspondiente:

Punto Se cumple cuando Qué hacer si falta
Instrucciones Las instrucciones dicen qué hace, para quién y qué no debe hacer (más de 40 caracteres). Escribí las instrucciones.
Conocimiento Tiene al menos una base asignada con documentos indexados. Asigná una base con documentos «Listo».
Modelo de lenguaje Está conectado a un proveedor real (no el modelo demo). Conectá un proveedor, por ejemplo OpenRouter, en Modelos.
Casos de prueba Tiene 3 o más casos habilitados. Agregá casos.
Versión publicada Hay una versión en producción. Publicá una versión que apruebe la evaluación.
Canal en producción Hay al menos un canal activo en ambiente «Producción». Compartí un link o insertá el widget.

Cuando los seis están completos, la tarjeta dice «Cumple todo lo necesario para atender en producción.»

Las otras tarjetas de Resumen:

  • Últimos 7 días: «Conversaciones», «Derivadas a una persona», «Satisfacción» (o «Sin votos») y «Tiempo de respuesta».
  • Conversaciones recientes: las últimas seis, con canal, mensajes y si está «Derivada».
  • Última evaluación: tasa de acierto, «Aprobada» o «No aprobada», y cuántos casos pasaron.
  • Canales: los canales con un punto verde si están activos en producción.