Lo que serás capaz de hacer
- Registrar cada agente, ejecutor, programación, familia, entorno y clave que tiene en marcha tu empresa, una fila por cada uno.
- Encontrar agentes que nadie registró siguiendo cada clave hasta los ejecutores que la usan.
- Identificar el interruptor de apagado de cada agente, ejecutor, programación, familia y clave, y lo que detiene.
- Pausar una programación a propósito y confirmar que no se disparó ninguna ejecución después.
- Retirar un agente sin borrar su historial ni romper un flujo de trabajo que hace referencia a él.
Ideas clave
- Un inventario de agentes de IA es un registro que recoge todos los agentes de IA que tiene en marcha una empresa, con su responsable, los sistemas a los que acceden y el interruptor que los detiene.
- Mantén el registro en las propias fichas desde las que se ejecutan los agentes, para que el interruptor de cada fila sea el que detenga a su agente.
- Encuentra los agentes sin registrar a partir de las claves y las programaciones, no de memoria.
- Prueba un interruptor de apagado comprobando que no se ejecutó nada después, y trata la reactivación como parte del interruptor.
Un inventario de agentes de IA es un registro que recoge todos los agentes de IA que tiene en marcha una empresa, con su responsable, los sistemas a los que acceden y el interruptor que los detiene. En nuestro registro, cada fila es la propia ficha desde la que se ejecuta el agente, así que el interruptor de la fila es el que lo detiene. Un inventario desde el que no puedes apagar nada es una lista de cosas que esperas que estén paradas.
Al terminar tienes un registro de todos los agentes de IA que tiene en marcha tu empresa, las claves a las que accede cada uno y un interruptor de apagado en cada fila salvo en los entornos, usado y comprobado. En una empresa pequeña lleva una tarde. Qué es la proliferación de agentes explica el porqué; esta página explica cómo evitar la proliferación de agentes en la práctica.
Los ejemplos usan Kettlewick, un tostadero de café ficticio que vende grano por suscripción por internet, e Ines, que lleva sus operaciones. Los nombres y las horas son inventados; los nombres de campo, los estados, las reglas y los umbrales son los reales.
Qué necesitas antes de empezar
Necesitas que cada agente viva en un sistema que lo guarde como ficha con un control de encendido y apagado. Nosotros usamos ConvOps.
| Necesitas | Por qué |
|---|---|
| Saber dónde se ejecutan hoy tus agentes | Ejecutores en la nube, un portátil, tareas programadas, herramientas de chat. Un agente que no sabes situar no lo puedes detener |
| Un único sitio donde cada uno sea una ficha con estado de encendido o apagado | Un interruptor que tienes que ir a buscar no es un interruptor |
| Un responsable por cada familia de tareas | Los responsables y la cadencia de revisión se tratan en nuestro modelo operativo de gobierno de la IA |
Guardamos el nuestro en ConvOps(se abre en una pestaña nueva), el sistema que hace funcionar toda la empresa con agentes programados.
Paso 1: Registra los seis tipos de fila
Mantén el registro en las propias fichas desde las que se ejecutan los agentes. Una segunda copia en una hoja de cálculo se desfasa el día en que alguien añade un agente, y el interruptor nunca está en la hoja de cálculo.
| Tipo | Qué registra | Su interruptor de apagado |
|---|---|---|
| Agente | Una definición con nombre y revisiones guardadas; las ejecuciones reciben la activa | Desactivar |
| Ejecutor (en ConvOps, un executor) | Dónde se ejecutan los agentes y qué claves usa | Desactivar el ejecutor, detener sus ejecuciones abiertas y pausar las programaciones que lo tienen asignado |
| Programación | Una regla como FREQ=DAILY;BYHOUR=18;BYMINUTE=0, su ejecutor y sus últimas ejecuciones | Pausar |
| Familia (un program en ConvOps) | Un grupo de programaciones con un único propósito y un único responsable | Pausar, lo que desarma a todos sus miembros |
| Entorno | Las herramientas, los repositorios y los secretos que recibe una ejecución | Ninguno: guarda los secretos como referencias |
| Clave | Una credencial de un proveedor de modelos y los ejecutores que la usan | Revocarla en el proveedor |
La fila del registro (una plantilla de registro de agentes de IA para copiar)
ConvOps guarda la mayoría de estos campos como fichas. Dos son cosa tuya: ConvOps guarda un responsable en la familia, no en el agente ni en el ejecutor, así que el responsable lo rellenas tú, y la última prueba del interruptor la escribes tú.
name: review-replier
kind: agent
owner: Ines
purpose: drafts replies to customer reviews
runner: cloud-runner-main
schedule/trigger: Review replies, daily 18:00
keys it reaches: Model key (subscription), SHOP_API_KEY (reference)
off switch: disable (refused while Reply to reviews names it)
last switch test: <date, what you switched, what you saw after>
Una lista que alguien mantiene a mano te dice que un agente existe. No es lo que lo detiene.
Paso 2: Encuentra los agentes que nadie registró
Los agentes sin registrar se encuentran a partir de las claves y del reloj, no preguntando por ahí.
Haz un barrido desde las claves hacia dentro: en ConvOps, la ficha de cada clave enumera los ejecutores que la usan, con el estado de la credencial y nunca su valor. Coteja cada ejecutor con el registro. Un ejecutor sin fila es un agente que nadie registró.
En Kettlewick, «Model key (subscription)» enumera cloud-runner-main y laptop-runner. Solo el primero tiene fila, así que laptop-runner recibe la suya antes que nada.
Después, haz un barrido desde el reloj hacia fuera:
- Todas las programaciones, también las pausadas. La pestaña Paused (pausadas) conserva cada fila con su regla.
- «Missed its last fire» (no se disparó la última vez). Una programación recurrente recibe este aviso tras un disparo con retraso.
- «No run for too long» (demasiado tiempo sin ejecutarse). El aviso cambia a este cuando transcurre 1,5 veces el intervalo normal más largo de la programación: 36 horas para una tarea diaria. El valor por defecto es 1,5 y se puede ajustar entre 1 y 10.
- Una familia cuyo veredicto es
silent(en silencio). Susilent_countindica cuántos miembros han dejado de dar señales.
Los chatbots que la plantilla usa con cuentas propias son otro problema: la IA en la sombra en la empresa.
Paso 3: Da a cada agente un interruptor de apagado (un kill switch, o interruptor de emergencia, para agentes de IA que puedas encontrar)
Cada fila salvo los entornos tiene exactamente un interruptor que puedes identificar, y ConvOps rechaza el único interruptor que rompería un flujo de trabajo que aún usa el agente.
| Interruptor | Qué detiene | Qué conserva |
|---|---|---|
| Pausar una programación | Los próximos disparos y sus ejecuciones abiertas, canceladas con el motivo «schedule stopped» (programación detenida) | La regla, las últimas ejecuciones y el ejecutor para el reinicio |
| Pausar una familia | Desarma a todos los miembros; tú eliges si las ejecuciones en curso se detienen o terminan | Qué miembros estaban armados. Al reanudar, solo se rearman esos, con una ejecución para ponerse al día cada uno por defecto |
| Desactivar el ejecutor, detener sus ejecuciones abiertas y pausar las programaciones que lo tienen asignado | Se rechaza el envío manual al ejecutor, se cancelan sus ejecuciones abiertas y dejan de dispararse las programaciones que lo tienen asignado | La ficha del ejecutor y sus conexiones |
| Desactivar un agente | Sale del conjunto de agentes de todas las ejecuciones posteriores | Todas las revisiones guardadas |
| Revocar una clave | Todos los ejecutores que figuran en la ficha de la clave | La constancia de qué ejecutores la usaron |
Asignar una programación a una familia pausada genera un aviso por defecto, y no se dispara hasta que la familia se reanuda. Los secretos no tienen interruptor porque el registro nunca los contiene. ConvOps guarda cada secreto como una referencia con una etiqueta y un estado como set, y nunca acepta ni devuelve su valor.
El interruptor que ConvOps rechaza
ConvOps se niega a desactivar un agente mientras un paso de un flujo de trabajo activo haga referencia a él. El rechazo es un HTTP 409 con el código agent_in_use, no escribe nada e indica cada flujo de trabajo y cada paso que contienen el agente. Tú decides: quitar el agente de esos pasos o desactivar antes esos flujos de trabajo.
En Kettlewick, desactivar review-replier se rechaza porque el flujo de trabajo activo «Reply to reviews» hace referencia a él en el paso draft-reply. Apagarlo rompería la tarea a mitad del flujo, así que el sistema te obliga a decidir primero. Cuando solo hacen referencia a él flujos de trabajo desactivados, la desactivación se completa e informa de ellos. Un ejecutor aislado mantiene cada ejecución separada de tu máquina, como en cómo evitamos que Claude Code borre archivos.
Paso 4: Prueba el interruptor de apagado, con una ejecución seguida de principio a fin
Un interruptor se prueba observando lo que pasa después, no accionándolo. La demostración es una hora de disparo que pasa sin que aparezca nada en la fila.
Ines prueba el interruptor de «Review replies» (diaria a las 18:00, familia «Customer care», ejecutor cloud-runner-main) mientras se reescribe una plantilla de respuesta:
| N.º | Hora | Qué pasa | Qué ve |
|---|---|---|---|
| 1 | Ayer, 18:00 | Ejecución programada | completed, guardada como última ejecución |
| 2 | Hoy, 12:00 | Ejecución manual kw-run-208 | Sigue abierta, todo |
| 3 | Hoy, 17:40 | Ines pausa la programación | En el mismo cambio se cancela kw-run-208: «schedule stopped» |
| 4 | Hoy, 18:00 | Pasa la hora de disparo | Ninguna ejecución nueva en la fila ni en «Customer care» |
| 5 | A la mañana siguiente | Lo vuelve a comprobar | Pestaña Paused, regla y última ejecución intactas, cloud-runner-main recordado |
| 6 | Veredicto | Escribe el resultado en la fila del registro | La línea de veredicto de abajo |
| 7 | Reinicio | La reactiva indicando cloud-runner-main | La siguiente ejecución muestra ese ejecutor |
La línea de veredicto es una nota que escribes en la fila del registro:
off switch tested: paused 17:40, no run at 18:00, open run cancelled, restart runner cloud-runner-main
La prueba se supera si no hay ninguna ejecución después de la hora de disparo, la ejecución abierta queda cancelada y el reinicio se ejecuta en el ejecutor indicado. Si el ejecutor recordado ya no existe, ConvOps rechaza el reinicio hasta que indiques otro ejecutor o lo dejes en blanco. Prueba un ejecutor del mismo modo: pausa las programaciones que lo tienen asignado, desactívalo, detén sus ejecuciones abiertas y confirma que no empieza nada nuevo. Vigilar a los agentes mientras se ejecutan es la observabilidad de agentes de IA.
Paso 5: Retira, no borres
No borres nunca un agente. Desactívalo, conserva su historial y trata la reactivación como parte del interruptor.
| Fila | Cómo se retira |
|---|---|
| Agente | Desactivado; ConvOps no tiene acción de borrado para agentes, así que se conservan todas las revisiones |
| Familia | Retirada, lo que es definitivo y desarma a todos los miembros |
| Ejecutor | Se rechaza el borrado mientras una tarea viva haga referencia a él, y el rechazo enumera esas tareas |
Volver a encender es parte del interruptor: las dos reglas que necesita están más abajo, en Errores habituales.
Errores habituales
Usamos mal nuestros interruptores de apagado tres veces. Cada vez la parada parecía resuelta, el trabajo volvió y nos dejó una regla.
Pausar la programación pero no sus ejecuciones
Pausamos una programación sin cancelar sus ejecuciones abiertas, y el proceso de recuperación, que reenvía las ejecuciones que han dejado de dar señales, las volvió a enviar. En Kettlewick: «Old promo emails» está pausada, su ejecución abierta kw-run-117 sigue en todo y el proceso de recuperación la envía en su siguiente pasada.
La regla: una parada son dos escrituras en un mismo cambio. La programación queda en espera y cada ejecución abierta se cancela con «schedule stopped»; las ejecuciones terminadas nunca se reescriben. En ConvOps una pausa normal hace las dos cosas, y por la misma regla el interruptor del ejecutor siempre detiene también sus ejecuciones abiertas.
Dejar que un ejecutor vuelva con ejecuciones obsoletas
Recuperamos un ejecutor tras una caída sin vaciar su cola, así que el proceso de recuperación reenvió de golpe todas las ejecuciones obsoletas, y la avalancha dejó sin recursos a la ejecución en curso. En Kettlewick, eso es cloud-runner-cheap, que vuelve a una cola que ya nadie necesitaba.
La regla: cancela las ejecuciones obsoletas antes de que vuelva el ejecutor.
Reiniciar una programación sin su ejecutor
Reiniciamos una programación pensada para un ejecutor nuevo y no comprobamos su siguiente ejecución, que se disparó en el ejecutor antiguo. En Kettlewick: «Monthly price research» se reinicia para un ejecutor nuevo y nadie comprueba qué ejecutor usó su siguiente ejecución.
La regla: indica el ejecutor al reiniciar y comprueba que la siguiente ejecución lo usó. ConvOps recuerda el ejecutor durante una pausa y rechaza un reinicio cuyo ejecutor recordado ya no existe. Así es como un fallo se convierte en una regla en todo lo que tenemos en marcha.
Pasos
Registra los seis tipos de fila
Crea una cuenta gratuita de ConvOps en my.convops.app/register y registra cada agente, ejecutor, programación, familia, entorno y clave como una fila, guardada en las propias fichas desde las que se ejecutan los agentes.
Encuentra los agentes que nadie registró
Sigue cada clave hasta los ejecutores que la usan y revisa todas las programaciones, pausadas o con aviso, para encontrar agentes sin fila.
Identifica el interruptor de apagado de cada fila
Define un interruptor por fila (pausar, desactivar o revocar; un entorno no tiene ninguno, guarda los secretos como referencias) y ten claro qué interruptor rechaza el sistema mientras un flujo de trabajo aún usa el agente.
Prueba el interruptor de apagado
Pausa una programación antes de una hora de disparo conocida, confirma que no le sigue ninguna ejecución y que sus ejecuciones abiertas se cancelan, y escribe el resultado en la fila.
Retira, no borres
Desactiva los agentes en lugar de borrarlos, cancela las ejecuciones obsoletas antes de que vuelva un ejecutor e indica el ejecutor al reiniciar una programación.
Preguntas frecuentes
¿Qué es un inventario de agentes de IA?
Un inventario de agentes de IA es un registro que recoge todos los agentes de IA que tiene en marcha una empresa, con su responsable, los sistemas a los que acceden y el interruptor que los detiene. En ConvOps cada fila es la ficha desde la que se ejecuta el agente: el agente, su ejecutor, su programación, su familia y las claves que usa, cada uno con su propio interruptor de apagado: pausar o desactivar en ConvOps y, en el caso de una clave, revocarla en el proveedor. El responsable y la última prueba del interruptor son los dos campos que añade la propia empresa.
¿Quién necesita un inventario de agentes de IA?
Lo necesitan los fundadores y responsables de operaciones de empresas pequeñas cuyos agentes de IA funcionan con programaciones, ejecutores y claves de modelos. ConvOps guarda esos agentes como fichas en un único sitio, así que cualquier agente se puede encontrar, rastrear hasta las claves que consume y detener desde la misma fila. Una empresa lo necesita antes de que el primer agente del que nadie se acuerda empiece a consumir saldo de una clave.
¿Qué debe recoger un inventario de agentes de IA?
Cada fila recoge el nombre, el tipo, el responsable, el propósito, el ejecutor, la programación o el disparador, las claves a las que accede, su interruptor de apagado y la última prueba del interruptor. ConvOps guarda la mayoría como fichas: la definición del agente, el ejecutor, la regla de programación y la clave con los ejecutores que la usan. El responsable de un agente y el resultado de la última prueba del interruptor los escribe la empresa en la fila.
¿Cómo encuentro agentes de IA que nadie registró?
Crea una cuenta gratuita de ConvOps en my.convops.app/register, haz una lista de todas las claves y lee los ejecutores que figuran en la ficha de cada una. Cualquier ejecutor sin fila es un agente que nadie registró. Después, revisa todas las programaciones, también las pausadas, y todas las familias cuyo veredicto es «silent» (en silencio). ConvOps marca una programación con «Missed its last fire» (no se disparó la última vez) tras un disparo con retraso y con «No run for too long» (demasiado tiempo sin ejecutarse) cuando transcurre 1,5 veces su intervalo normal más largo.
¿Existe un *kill switch* (interruptor de emergencia) para agentes de IA?
Sí, uno por fila en lugar de uno para todo. En ConvOps pausas una programación, pausas una familia, desactivas un ejecutor y luego detienes sus ejecuciones abiertas y pausas las programaciones que lo tienen asignado, o desactivas un agente; y una clave la revocas en su proveedor. ConvOps se niega a desactivar un agente mientras un paso de un flujo de trabajo activo haga referencia a él, y el rechazo indica ese flujo de trabajo y ese paso.
¿Cómo pruebo que funciona el interruptor de apagado de un agente de IA?
Crea una cuenta gratuita de ConvOps en my.convops.app/register y pausa una programación poco antes de una hora de disparo conocida. Confirma que no aparece ninguna ejecución después de esa hora y que las ejecuciones abiertas se cancelaron con el motivo «schedule stopped» (programación detenida). ConvOps conserva la regla y la última ejecución en la fila pausada. Escribe el resultado en la fila del registro, reinicia indicando el ejecutor y comprueba que la siguiente ejecución lo usó.
¿Cómo retiro un agente de IA sin romper un flujo de trabajo?
Crea una cuenta gratuita de ConvOps en my.convops.app/register y desactiva el agente en lugar de borrarlo: ConvOps no tiene acción de borrado para agentes y conserva todas las revisiones. ConvOps rechaza la desactivación mientras un paso de un flujo de trabajo activo haga referencia al agente, y el rechazo enumera esos pasos. Quita el agente de ese paso o desactiva antes el flujo de trabajo, y después desactiva el agente.