Conceptos

Esta página define cada término una sola vez. El resto de la documentación enlaza acá.

Una instalación de Sherlock, con su consola, sus workspaces y su configuración. Puede ser dedicada a un cliente (corre en su infraestructura o en una dedicada) o la instancia de PosseLab, con un workspace por cliente. La vista Flota permite ver la salud de varias instancias desde una consola central.

El espacio de trabajo de un cliente o un área. Agrupa sus agentes, bases de conocimiento, herramientas, canales, conversaciones, presupuesto y reportes. Las personas tienen un rol por workspace: alguien puede ser Publicador en un cliente y Observador en otro. Ver Workspaces.

Un asistente que conversa con personas sobre la documentación del cliente. Se arma en el Estudio sin escribir código: identidad, instrucciones, reglas, tono, modelo, conocimiento, herramientas, guardrails y canales. Toda esa configuración se puede versionar, comparar con otras versiones y exportar.

Cada agente tiene dos ambientes:

• Borrador: la configuración que estás editando. Se guarda sola mientras trabajás. Lo podés probar en el Estudio y compartir con un canal de ambiente «Borrador» para que el cliente lo valide, pero nunca llega a los canales de producción por sí mismo.
• Producción: la versión publicada. Es la que atienden los canales de ambiente «Producción».

Para llevar el borrador a producción hay que publicarlo, y eso crea una versión nueva que tiene que aprobar la evaluación. Si un agente ya está en producción y editás el borrador, el encabezado del Estudio avisa «Borrador con cambios sin publicar».

Estados que vas a ver en la consola:

Término	Dónde aparece	Qué significa
«En producción · v2»	Agente, versión, canal	Tiene una versión publicada y atiende en producción.
«Sin publicar»	Agente	Nunca se publicó una versión.
«Borrador»	Canal, API key	Responde con el borrador, para pruebas.
«Evaluando»	Versión	Corriendo sus casos de prueba.
«Aprobada» / «No aprobada»	Versión	Superó o no el umbral de la evaluación.
«Retirada»	Versión	Estuvo en producción y fue reemplazada.
«Derivada»	Conversación	La atiende una persona del equipo.
«Pausado»	Canal	Desactivado: no responde.

Una foto inmutable de la configuración del agente en el momento de publicar, con un número (v1, v2…), un identificador corto de su contenido (hash), la descripción de «Qué cambió», su evaluación y sus métricas (mensajes, latencia, costo por mensaje). Las versiones se pueden comparar con el borrador, restaurar al borrador o volver a publicar en un clic. Ver Versiones.

El control de calidad antes de publicar. Cada agente tiene casos de prueba (un mensaje y lo que tiene que cumplir la respuesta). Al publicar, Sherlock corre los casos contra la versión nueva con el mismo motor que usan los canales y calcula la tasa de acierto. Si llega al umbral (80 % por defecto), la versión pasa a producción; si no, queda «No aprobada» y producción no cambia. Ver Evaluación.

Un conjunto de documentos para un mismo público (por ejemplo, «Clientes» o «Equipo comercial»). Los documentos se dividen en fragmentos, y el agente encuentra los relevantes tanto por el sentido de la pregunta como por palabras exactas. Un agente consulta solo las bases que tiene asignadas, y cita la fuente. En lugar de replicar los permisos de cada archivo, Sherlock propone una base por audiencia. Ver Conocimiento.

Una API (importada desde OpenAPI o definida a mano) o un servidor MCP que el agente puede invocar para consultar sistemas o hacer acciones: buscar una póliza, crear un ticket. Las credenciales se guardan cifradas y cada llamada queda en la traza. Ver Herramientas.

Por dónde llegan las personas al agente: widget web, link de chat, WhatsApp, voz (ElevenLabs) o API. Teams y Webex figuran como «Próximamente». Todos entran por el mismo motor, con las mismas protecciones, trazas y control de costos. Ver Canales.

Las protecciones que actúan en cada mensaje: entrada segura (enmascarado de datos personales, detección de prompt injection, temas bloqueados, largo máximo) y salida segura (control de datos sensibles en la respuesta). Cada vez que una protección actúa queda un incidente. Ver Guardrails.

Una conversación es el intercambio completo con una persona por un canal. Cada respuesta del agente tiene su traza: qué protecciones actuaron, qué fragmentos encontró, qué modelo respondió, qué herramientas usó, cuánto tardó y cuánto costó. Las pruebas del Estudio y de la evaluación quedan aparte de las conversaciones reales. Ver La traza y Conversaciones.

Cuando la persona pide hablar con alguien, o el agente no puede resolver, la conversación pasa a una persona del equipo: aparece en la Bandeja y el agente deja de responder hasta que se la devuelvan. Ver Derivación a humano.

Cada persona tiene un rol en cada workspace. La interfaz se adapta al rol: cada uno ve solo lo que puede usar y, donde corresponde, la consola muestra «Solo lectura».

Rol	Para quién	En una frase
Observador	Cliente o equipo	Ve tableros, conversaciones, gobierno y reportes. Puede atender derivaciones.
Editor	Cliente o equipo	Edita contenido acotado (documentos, respuestas, tono y reglas). Sus cambios pasan por evaluación.
Publicador	Cliente o equipo	Edita contenido y publica versiones que aprobaron la evaluación.
Constructor	Solo equipo de PosseLab	Construye y opera agentes: diseño, conocimiento, herramientas, canales y publicación.
Administrador	Solo equipo de PosseLab	Todo, en todos los workspaces, más la administración de la instancia.

Qué puede hacer cada uno:

Capacidad	Observador	Editor	Publicador	Constructor	Administrador
Ver tableros, conversaciones, gobierno y reportes	✓	✓	✓	✓	✓
Atender conversaciones derivadas a una persona	✓	✓	✓	✓	✓
Editar tono, reglas, bienvenida y respuestas frecuentes	—	✓	✓	✓	✓
Subir y editar documentos de conocimiento	—	✓	✓	✓	✓
Correr evaluaciones	—	✓	✓	✓	✓
Aprobar documentos nuevos	—	—	✓	✓	✓
Publicar versiones que aprobaron la evaluación	—	—	✓	✓	✓
Configurar agentes: modelo, herramientas, guardrails y canales; crear y archivar agentes	—	—	—	✓	✓
Crear bases de conocimiento y conectar fuentes	—	—	—	✓	✓
Gestionar herramientas	—	—	—	✓	✓
Crear y revocar API keys del workspace	—	—	—	✓	✓
Gestionar miembros y presupuesto del workspace	—	—	—	—	✓
Administrar la instancia: modelos, personas, flota	—	—	—	—	✓

Reglas que conviene tener presentes:

• Las personas del cliente pueden ser Observador, Editor o Publicador. Constructor y Administrador son roles del equipo de PosseLab; si una persona del cliente tenía «Constructor», pasa a «Publicador».
• Un Administrador accede a todos los workspaces con acceso total y no figura en las listas de miembros.
• Nada llega a producción sin evaluación. Los cambios de un Editor quedan en el borrador; el botón «Publicar» se reemplaza por «Evaluar cambios», y una versión que aprueba la evaluación la publica alguien con permiso.

Para invitar personas y asignar roles, ver Personas y roles.