Agentes Sanctioned y Shadow

Cada agente de un host que ejecuta el cliente se lee como Sanctioned o Shadow. El estado te dice si el agente trabaja con una suscripción que tu empresa paga y que ha permitido para su propietario, para que veas de un vistazo qué agentes usan una cuenta que no elegiste.

OpenLatch clasifica los agentes de los hosts que ejecutan el cliente. Los agentes de las máquinas sin el cliente no se descubren ni se clasifican: el descubrimiento de shadow AI en las máquinas sin el cliente no está disponible.

Qué compara el estado

Cada agente informa la suscripción con la que se ejecutan sus llamadas de modelo: una organización, un espacio de trabajo, un equipo, un proyecto o una cuenta en la nube, o una pasarela de modelos. Leer la suscripción, el modelo y el esfuerzo de una sesión enumera cada tipo y dónde lo lee el cliente. Un administrador declara las suscripciones oficiales de la empresa en Settings › General › Agent Subscriptions, cada una con las unidades organizativas en las que está permitida; consulta Declarar las suscripciones de tus agentes.

OpenLatch compara ambas. La comparación usa solo el identificador de suscripción: ninguna dirección de correo ni ninguna señal de identidad participa, así que el estado funciona igual con la recopilación de señales de identidad activada o desactivada.

El agente es Sanctioned cuando la última suscripción que informó está declarada y permitida para la unidad organizativa de su propietario. Si no, es Shadow, con exactamente una razón:

Razón	Cuándo	Alerta
Subscription not official	El agente informa una suscripción que ninguna declaración nombra	Sí
Org unit not allowed	La suscripción está declarada, pero solo para unidades organizativas que no contienen al propietario del agente	Sí
Subscription can’t be determined	El agente no informa ninguna suscripción, por ejemplo cuando usa una clave de API sin más	No
User can’t be placed	La suscripción está declarada solo para algunas unidades organizativas, y el propietario del agente no está en ninguna, por ejemplo porque no se pudo determinar el propietario	No

Una declaración permitida para toda la organización hace Sanctioned a cada agente con esa suscripción, esté donde esté su propietario. Una declaración limitada a unidades organizativas cubre esas unidades y todas las que están por debajo.

De dónde viene la unidad organizativa del agente

La unidad organizativa del agente es la de su propietario, tal como la muestra la pestaña Identity. Para un agente que actúa en nombre de un servicio, es la unidad de la persona responsable del servicio, y si no, la unidad a la que está asignado el servicio. Un cambio de propietario, de la unidad de una persona o del árbol de la organización cambia el estado en la siguiente lectura.

En una máquina compartida por varias personas, el cliente cuenta un agente por usuario del sistema: el agente de cada usuario del sistema es un agente distinto, leído a partir de su propio propietario. Las personas que comparten una misma cuenta del sistema comparten un mismo agente.

Sanctioned no significa verificado

El estado se deriva del identificador de suscripción que informa el cliente. OpenLatch no comprueba ese identificador con el proveedor y no prueba qué cuenta usa un agente. Sanctioned significa que el agente informa una suscripción oficial, nunca que su cuenta está verificada. El estado clasifica un agente: nunca cambia un veredicto, y nunca bloquea ni pausa un agente.

El estado cubre un agente que se comporta mal, no uno malicioso: una máquina que informa un identificador erróneo, por un error de configuración o por otro motivo, se lee como ese identificador.

Qué se lee como «Subscription can’t be determined»

Situación	Por qué
El agente usa una clave de API sin más	Una clave no revela ninguna organización sin llamar al proveedor, algo que OpenLatch nunca hace
OpenCode o Devin	El cliente no lee ninguna suscripción para ellos
Una máquina con un cliente anterior a 0.11.11	Los clientes más antiguos no informan ninguna suscripción
Un agente de Cursor detrás de una pasarela de la empresa	El cliente no lee ningún ajuste de pasarela para Cursor, así que lee su equipo de Cursor, o nada

Una declaración Gateway cubre solo los agentes de Claude Code, Codex CLI y Cline, los agentes para los que el cliente lee una pasarela. Un nombre de host de pasarela compartido por muchas empresas, como un servicio de pasarela público, no identifica a ninguna empresa: declararlo hace Sanctioned a cada agente que usa ese servicio.

Cuándo cambia el estado

El estado se calcula cada vez que lo lees. Una declaración nueva, una eliminada o una lista de unidades organizativas modificada aparece en la siguiente lectura de cada agente afectado, sin esperas. Un agente que cambia a otra suscripción se lee con la nueva: la observación más reciente gana, y la cabecera del agente muestra cuándo se observó. Las sesiones pasadas conservan la suscripción que registraron.

Alertas

OpenLatch envía la notificación Shadow agent detected cuando un agente pasa a Shadow por una razón que alerta: Subscription not official u Org unit not allowed. Aparece en la consola para cada miembro, y llega a cada canal de notificación suscrito a ese tipo; consulta Configurar los canales de notificación.

Regla	Qué significa
Ninguna alerta antes de tu primera declaración	Mientras tu organización no haya declarado nada, no se alerta nada. Tu primera declaración comprueba cada agente y envía una notificación que cuenta los agentes Shadow, como «12 shadow agents discovered»
Solo al entrar en una razón que alerta	Un agente alerta cuando entra en Subscription not official u Org unit not allowed, nunca otra vez mientras siga ahí, y nunca por Subscription can’t be determined, User can’t be placed o un paso a Sanctioned
Como mucho una vez al día por agente	Un agente alerta como mucho una vez cada 24 horas, sea cual sea la razón
Una notificación para varios agentes	Un cambio en Agent Subscriptions, o una comprobación que pasa varios agentes a Shadow a la vez, envía una notificación que los cuenta
Una espera para los agentes nuevos	Un agente recién inscrito que aún no ha informado ninguna suscripción no se juzga hasta que informe una, o durante 24 horas después de su descubrimiento, lo que ocurra primero

La notificación nombra el producto del agente y la razón, nunca la persona, la máquina ni el identificador de suscripción. Una notificación sobre un agente abre ese agente; una que cuenta varios abre la página Agents. La mayoría de los cambios alertan en unos instantes; un cambio que OpenLatch no pudo comprobar de inmediato lo recoge una comprobación cada hora. El estado que lees nunca se retrasa.

Presupuestos

Una declaración puede llevar un presupuesto mensual por defecto para cada agente Sanctioned con esa suscripción. Un agente usa primero su propio presupuesto, luego el presupuesto por defecto de la suscripción oficial con la que está Sanctioned, y luego el presupuesto por defecto de tu organización. Un agente Shadow nunca recibe el presupuesto por defecto de una suscripción. Consulta Seguir el gasto de un agente.