Declarar las suscripciones de tus agentes
Requiere @openlatch/client 0.11.11 o una versión posterior
Usa Settings › General › Agent Subscriptions para declarar las suscripciones que paga tu empresa, de modo que los agentes que trabajan con ellas se lean como Sanctioned y los demás como Shadow. Necesitas el rol admin o superior; la página no se muestra a los editores ni a los lectores. Para saber qué significan los dos estados, lee Agentes Sanctioned y Shadow.
Mientras no declares ninguna suscripción, cada agente se lee como Shadow y no se envía ninguna alerta Shadow.
Declarar una suscripción
Sección titulada «Declarar una suscripción»- Elige Add subscription.
- Elige el Kind, como Anthropic org, ChatGPT workspace o Cursor team.
- Elige el Subscription ID entre los ID que informan tus agentes para ese tipo, con el número de agentes en cada uno y cuándo se vio por última vez, o escribe uno. Un ID escrito se comprueba con el formato del tipo antes de guardarse.
- Dale un Label de hasta 80 caracteres, como «Acme engineering Claude org». La etiqueta es lo que muestran la cabecera del agente y el presupuesto.
- En Allowed org units, elige Whole organization, o Selected org units y elige al menos una unidad. Una unidad cubre todas las unidades que están por debajo.
- Si quieres, define un Default monthly budget per agent y elige Save.
El Subscription ID es un identificador de organización, de equipo o de cuenta, nunca una clave de API ni un token: todos los roles lo ven en la página del agente, y el registro de auditoría lo conserva. Un ID que ningún agente informa todavía se guarda y se marca como Not observed yet.
Cada tipo y Subscription ID se puede declarar una sola vez. Puedes declarar varias suscripciones del mismo tipo, y el mismo ID con dos tipos son dos declaraciones. Una organización tiene como máximo 500 declaraciones, y cada declaración como máximo 200 unidades organizativas.
Formatos de los Subscription ID
Sección titulada «Formatos de los Subscription ID»| Tipo | Formato |
|---|---|
| Anthropic org · ChatGPT workspace | Un UUID |
| Azure OpenAI resource | Solo un nombre de host, sin esquema, puerto ni ruta |
| Gateway | Solo un nombre de host. Se rechaza el host de API propio de un proveedor de modelos |
| GitHub enterprise | El slug de la empresa, o su nombre de host terminado en .ghe.com |
| GitHub org | El slug de la organización: letras, dígitos y guiones simples, hasta 39 caracteres |
| GCP project | El ID del proyecto: de 6 a 30 caracteres, empezando por una letra minúscula |
| AWS account | El ID de cuenta de 12 dígitos |
| Cursor team | El ID del equipo, tal como lo muestra la consola de administración de Cursor |
| Cline org | El ID de la organización: letras, dígitos, guiones y guiones bajos, hasta 128 caracteres |
Las mayúsculas y minúsculas no importan, salvo en los ID de Cursor team y Cline org, que deben coincidir exactamente. GitHub enterprise y GitHub org están reservados para GitHub Copilot, que aún no es compatible, así que ningún agente los informa todavía.
Editar o eliminar una declaración
Sección titulada «Editar o eliminar una declaración»Abre las acciones de una declaración para editarla o eliminarla. Puedes cambiar su etiqueta, sus unidades organizativas permitidas y su presupuesto por defecto; su tipo y su Subscription ID no pueden cambiar, así que para cambiarlos elimina la declaración y vuelve a añadirla. Para eliminar varias, selecciónalas en la tabla y elige Delete.
| Cambio | Efecto en los agentes |
|---|---|
| Añadir una declaración, o permitir más unidades organizativas | Los agentes que la usan se leen como Sanctioned al instante, sin alerta. Tu primera declaración también comprueba cada agente y envía una notificación que cuenta los agentes Shadow |
| Eliminar una declaración, o permitir menos unidades organizativas | Los agentes que ya no cubre se leen como Shadow al instante, y una notificación cuenta los que no recibieron alerta en las últimas 24 horas |
| Cambiar solo la etiqueta o el presupuesto por defecto | Ningún agente cambia de estado |
Cada declaración que añades, editas o eliminas queda registrada en el registro de auditoría, y aparece en su exportación.
Cuando se elimina una unidad organizativa de una declaración, la tabla la marca como Deleted org unit y la declaración la conserva: la unidad no coincide con ningún agente, y un perímetro nunca se amplía a toda la organización por una eliminación. Cuando se eliminan todas las unidades de una declaración, la página avisa de que no coincide con ningún agente hasta que edites sus unidades organizativas permitidas. Puedes quitar una unidad eliminada de la declaración al editarla.
Definir los presupuestos por defecto
Sección titulada «Definir los presupuestos por defecto»El presupuesto mensual por defecto de la organización se define en la sección Agent Budgets de esta página. 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 la organización:
| Agente | Presupuesto que usa |
|---|---|
| Tiene su propio presupuesto | Su propio presupuesto |
| Sin presupuesto propio, Sanctioned con una suscripción con presupuesto por defecto | El presupuesto por defecto de esa suscripción, mostrado como «Default of» seguido de la etiqueta de la suscripción |
| Sin presupuesto propio, Shadow, o Sanctioned con una suscripción sin presupuesto por defecto | El presupuesto por defecto de la organización, si está definido |
Cada valor por defecto se aplica a cada agente por separado: un valor por defecto de 500 $ da a cada agente 500 $ al mes, no 500 $ compartidos. Borrar un valor por defecto nunca sobrescribe un presupuesto definido en un agente. El presupuesto propio de un agente se define desde su pestaña Economics; consulta Seguir el gasto de un agente.
Leer el estado de un agente
Sección titulada «Leer el estado de un agente»Abre un agente: su cabecera muestra Sanctioned o Shadow con su razón, como Shadow · Subscription not official. Pasa el puntero o el foco por el estado para ver sus detalles, como la última suscripción que informó el agente y cuándo se observó. Para una suscripción no declarada, un administrador también lee dónde declararla. Todos los roles pueden leer el estado.
| Qué lees | Qué hacer |
|---|---|
| Shadow · Subscription not official | Si la suscripción es una de las que paga tu empresa, declárala. Si no, pide al propietario del agente que pase a una suscripción oficial |
| Shadow · Org unit not allowed | Permite la suscripción para la unidad organizativa del propietario, o revisa el propietario del agente en su pestaña Identity |
| Shadow · User can’t be placed | Coloca al propietario en una unidad organizativa, o permite la suscripción para toda la organización |
| Shadow · Subscription can’t be determined | El agente no informa ninguna suscripción, por ejemplo con una clave de API sin más. Ninguna declaración lo cambia |
Límites
Sección titulada «Límites»- Una clave de API sin más no revela ninguna organización, así que un agente que la usa se lee como Subscription can’t be determined.
- Un nombre de host de pasarela compartido no identifica a ninguna empresa, y una declaración Gateway cubre solo los agentes de Claude Code, Codex CLI y Cline.
- La recopilación de señales de identidad no es necesaria: la comparación usa el identificador de suscripción, nunca una dirección de correo.
- Sanctioned significa que el agente informa una suscripción oficial, no que su cuenta esté verificada.
- Solo se clasifican los agentes de los hosts que ejecutan el cliente.
Para elegir qué canales reciben la notificación Shadow agent detected, consulta Configurar los canales de notificación.