Departamentos y grupos

Las empresas se organizan en departamentos: ventas, finanzas, RR. HH., soporte. En AgenticOS un departamento es un grupo, y un grupo decide quién puede usar qué. Finanzas puede tener sus propios agents, skills, archivos de contexto, bases de conocimiento y servidores MCP que ventas nunca ve, mientras lo que necesita todo el mundo sigue abierto a toda la organización.

Añadir tus departamentos

Groups en la navegación principal lista los grupos de la organización. Un miembro con members:manage los añade de uno en uno con New group, o varios a la vez con Add departments, que ofrece Sales, Finance, HR, Support, Engineering, Marketing, Legal y Operations, cada uno con un icono y una breve descripción. Después se pueden renombrar, cambiar de icono o borrar como cualquier otro grupo.

Las personas se añaden a un grupo desde su página, a mano, o mediante un mapeo de grupo de directorio si tu empresa ya lleva sus equipos en un directorio.

El responsable de un grupo

Un administrador puede hacer a un miembro responsable del grupo - la corona a su lado en la lista de miembros. Un responsable añade personas a su grupo y las quita sin administrar la organización, así que quien dirige un departamento puede incorporar a alguien nuevo sin pedírselo a TI. Solo quien tiene members:manage nombra o retira a un responsable, porque reparte acceso a todo lo compartido con el grupo.

Quién puede usar algo nuevo

Crear un agent, un skill, una base de conocimiento, un archivo de contexto o un servidor MCP compartido hace una pregunta: quién puede usarlo (Who can use it en la consola).

Opción	A quién llega	Se guarda como
Everyone - por defecto	A todos los miembros de la organización	Visibilidad org
Only me	A ti y a quien se lo compartas después	Visibilidad private (una base de conocimiento pasa a ser personal)
Some people	A los miembros de los grupos que elijas y a las personas que nombres	Visibilidad private, compartida con cada uno a nivel use

Los grupos aparecen en cuanto eliges la tercera opción; a las personas se las encuentra escribiendo un nombre o una dirección de correo. Cada elección queda como un chip hasta que la quitas.

Los miembros de un grupo encuentran lo que se le ha compartido, lo usan y lo vinculan a sus propios agents. Quien está fuera del grupo no lo ve en las listas, en la búsqueda, en los selectores del Builder, a través de la API ni a través del Architect, que actúa con los permisos de quien pregunta. Los miembros cuyo rol alcanza todos los recursos - por defecto owner, admin y builder - siguen viéndolo todo; consulta Permisos.

Las aplicaciones las publican los agents y empiezan siendo privadas para la persona para la que se hizo el run; se comparten con un grupo desde su panel Share. El panel Sharing de cada recurso también añade o quita grupos después de crearlo.

Los servidores MCP de un departamento

Un servidor MCP de la organización - una cuenta compartida, conectada una vez - se limita del mismo modo, para que el servidor contable de Finanzas sea de Finanzas. Quienes gestionan servidores MCP ven los de toda la organización, los que conectaron ellos mismos y los compartidos con sus grupos o con ellos; owners y admins los ven todos. Un builder fuera de Finanzas no encuentra su servidor en la lista, no lo abre por su id y no publica un agent que lo use. Consulta MCP.

Un agent que ya lo usa sigue funcionando para todos los que pueden ejecutarlo. La elección decide quién puede escoger el servidor, no quién recibe respuestas a través de él - consulta de dónde viene el conocimiento de un agent.

La página de un grupo

Abrir un grupo muestra sus personas y todo lo que se le ha compartido, agrupado por tipo - agents, bases de conocimiento, skills, contexto, aplicaciones y servidores MCP - con el nivel al que se compartió cada uno. Quien lee solo ve lo que podría abrir de todos modos, así que un miembro de Ventas que lee la página de Finanzas no se entera de lo que guarda Finanzas.

Add to this group comparte varias cosas a la vez: lista todo lo que quien lee puede editar y el grupo aún no tiene, con un buscador, una casilla por elemento y el nivel al que compartir. Cada una es la misma concesión que escribe el panel Share, así que necesita el mismo derecho a editar.

Los miembros reciben un aviso cuando algo se comparte con su grupo - en la bandeja y, si lo quieren, por correo; Shared with your group en los ajustes de notificaciones lo desactiva. Las tarjetas de toda la consola dicen para quién es cada cosa: Everyone, sus departamentos por nombre - ambos cuando es para todos y pertenece a un departamento - o Private.

Agrupar una lista por departamento

Las páginas Apps, Skills, Context y Knowledge bases tienen cada una un filtro de grupo. Elegir Finance reduce la lista a lo que está compartido con Finance, y la elección queda en la dirección, así que la vista es un enlace que se puede enviar. Un grupo es la única forma de agrupar - no hay carpetas - porque un grupo ya decide a quién llega un recurso, y una segunda jerarquía sería una segunda respuesta a la misma pregunta.

El filtro nunca amplía una lista: lo que quien lee no puede abrir no aparece. Los selectores del Builder muestran junto a cada recurso sus departamentos, y los cuatro endpoints de lista aceptan group_id para la misma restricción por la API.

El presupuesto de un departamento

Un administrador puede dar a un departamento un presupuesto mensual al crearlo o editarlo. Mide lo que ejecutan los miembros del departamento - cualquier agent, en el mes natural en curso - y detiene el run de un miembro en cuanto el departamento lo alcanza, con un rechazo que nombra al departamento. Una persona en dos departamentos está bajo ambos topes. Consulta los niveles de budget.

Cuando un departamento supera el 80% de su mes, su responsable y los administradores reciben un único aviso - en la bandeja y por correo, salvo que desactiven Department budget at 80%. Cuando el tope detiene un run, se enteran las mismas personas.

La página del grupo muestra el mes frente al tope y lo exporta como CSV, una fila por miembro y agent. La tarjeta Spend by department del dashboard muestra el mes de cada departamento. Ambas requieren runs:view; el responsable de un departamento también puede descargar su CSV desde GET /orgs/{org_id}/groups/{group_id}/spend.csv.

Qué tan bien se responde a su gente

Junto al presupuesto, la página del grupo muestra cómo valoró la gente del departamento las respuestas en los últimos 30 días: la proporción de útiles, los agents que más usaron y las últimas respuestas que valoraron como no útiles, cada una con su comentario y un enlace a su run. Una valoración cuenta para el departamento de quien la dio, y para cada departamento en el que esté esa persona. La tarjeta Answer quality by department del dashboard ordena los departamentos, los menos útiles primero, en el periodo del dashboard.

La tarjeta de la página es para cualquiera con runs:view y para quien lidera el departamento; un miembro corriente, o uno de otro departamento, no ve nada de ella. La tarjeta del dashboard necesita runs:view. API: GET /orgs/{org_id}/groups/quality y GET /orgs/{org_id}/groups/{group_id}/quality, ambos con from y to.

De dónde viene el conocimiento de un agent

Un agent puede vincularse a una base de conocimiento, un skill, un archivo de contexto o un servidor MCP compartidos con menos gente que el propio agent, y nada lo impide. Todo aquel al que llega el agent recibe entonces respuestas de esa fuente, incluidas personas que no podrían abrirla por sí mismas.

GET /agents/{agent_id}/knowledge-reach responde de dónde viene el conocimiento del agent: a quién llega y, para cada fuente, si es de toda la organización o de qué grupos, con las fuentes compartidas con menos gente que el agent marcadas. Si no es lo que querías, limita el agent a los mismos grupos o amplía la fuente.

Los grupos de la persona en las instrucciones

Las instrucciones pueden nombrar los grupos de la persona con la que habla el agent con {{groups}} - por ejemplo, "Estás ayudando a alguien de {{groups}}." Se convierte en los nombres de sus grupos separados por comas, o en nada para un visitante. Consulta Variables.

Lo que aún no cubre

Un run que no inició nadie de la organización - una programación, un visitante en un canal - no cuenta para el presupuesto de ningún departamento, porque el mes de un departamento es lo que ejecutaron sus miembros.