Workspaces

Un workspace agrupa los agentes, el conocimiento, los canales, el presupuesto y los reportes de un cliente o un área. Cada persona tiene un rol en cada workspace al que accede.

Los administradores ven «Todos los workspaces» (desde el selector de workspace → «Ver todos los workspaces»): el gasto, la actividad y los pendientes de cada cliente en el mes en curso.

Columna	Qué muestra
Workspace	Nombre, cliente y tu rol.
Agentes	En producción sobre el total.
Conversaciones del mes	Solo canales publicados.
Gasto del mes	Con su límite y porcentaje, o «sin límite».
Pendientes	Avisos de la Bandeja, o «Al día».

Solo los administradores. Hacé clic en «Nuevo workspace» (o en el selector → «Nuevo workspace»):

Campo	Notas
Nombre	Mínimo 2 caracteres. Por ejemplo «Atención a asegurados».
Cliente	Aparece en el panel y en el reporte mensual: «Seguros del Litoral».
Descripción (opcional)	Para qué se usa.
Presupuesto mensual	Límite en USD (vacío = sin límite) y qué hacer al superarlo: «Bloquear respuestas nuevas» o «Solo avisar».

Hacé clic en «Crear workspace». Después, sumá personas desde Personas y roles o desde la pestaña «Miembros y roles» del workspace.

En la barra lateral, Configuración (Constructor y Administrador). Tiene cuatro pestañas: General, Miembros y roles, Presupuesto y API keys.

• Datos del workspace: Nombre, Cliente y Descripción. Los modifican los Constructores del workspace y los administradores. Crear y archivar workspaces es solo de los administradores.
• Tu acceso: tu rol en este workspace y qué te permite.
• Identificadores: el slug y el ID del workspace, para integraciones, la API y pedidos de soporte.

Quién accede a este workspace y con qué rol. Los Constructores del workspace y los administradores pueden:

• «Agregar persona»: sumar a alguien que ya tiene cuenta.
• «Invitar por email»: dar de alta a una persona del cliente directo en este workspace, como Observador, Editor o Publicador. Si la instancia tiene correo, le llega la invitación; si no, aparece el link para compartirlo. Si el email ya tiene cuenta, se la suma con ese rol.
• Cambiar el rol de cada miembro y quitarlo («Quitar de este workspace»: deja de ver sus agentes, conversaciones y reportes; su cuenta y sus otros accesos no cambian).

Un Constructor no cambia su propio rol ni se quita a sí mismo, no puede hacer Constructor a una persona del cliente y no invita gente nueva del equipo de PosseLab: eso lo hace un administrador. Los administradores de la instancia acceden a todos los workspaces y no figuran en esta lista. Cada alta, cambio y baja queda en la auditoría. Ver Personas y roles.

El presupuesto controla cuánto pueden gastar en modelos todos los agentes del workspace en un mes, y qué pasa al llegar al tope. Se configura en Configuración → Presupuesto. Lo modifican los Constructores del workspace y los administradores.

Gasto del mes: la suma del costo en modelos de todas las ejecuciones del workspace. Se reinicia el día 1. Muestra el gasto sobre el límite, el porcentaje usado, la proyección a fin de mes según el ritmo actual y lo disponible.

Límite de gasto:

Opción	Valores
Presupuesto mensual	«Con límite» (monto en US$) o «Sin límite».
Al llegar al límite	«Pausar los agentes»: responden «El servicio alcanzó su límite de uso mensual. Contactá al administrador.» hasta el mes siguiente o hasta que amplíes el presupuesto. «Solo avisar»: siguen respondiendo y cada ejecución por encima del límite queda como incidente «Presupuesto excedido» en Gobierno.

Avisos:

• Desde el 80 %, la Bandeja muestra «Presupuesto del mes al N %» a Constructores y Administradores, con «Ajustar presupuesto».
• Inicio y Gobierno muestran la barra de presupuesto en ámbar desde el 80 % y en rojo al 100 %.

Las API keys del workspace permiten que un sistema del cliente (CRM, app, backend) converse con los agentes por la API compatible con OpenAI. Se crean en Configuración → API keys (Constructor y Administrador).

Hacé clic en «Crear API key»:

Campo	Notas
Nombre	Para reconocerla después: «CRM producción», «App móvil».
Agente	«Todos los agentes del workspace» (el sistema elige el agente en cada llamada con el campo model) o uno solo (la key solo conversa con ese agente y model se ignora).
Ambiente	Producción: usa la versión publicada de cada agente. Borrador: usa el borrador actual, para pruebas e integración.
Límite de pedidos por minuto	60 por defecto, entre 1 y 10.000. Al superarlo, la API responde 429.

Hacé clic en «Crear API key». La key (sk-sherlock-…) se muestra completa una sola vez: copiala y guardala en un gestor de secretos o en las variables de entorno del sistema que la va a usar. El diálogo trae ejemplos listos para probarla.

La lista muestra cada key con su prefijo, agente, ambiente, límite, fecha de creación y último uso («Nunca» si no se usó). «Mostrar revocadas» incluye las revocadas.

Para integrar un solo agente también podés crear un canal API, que genera su propia key.