Activación y desactivación de agentes
Descripción del estado activo del agente
Cada definición de agente tiene una casilla de verificación de estado activo que controla si el agente está disponible para responder a los mensajes de los usuarios. Esta configuración es fundamental para la administración de agentes:
- Estado activo marcado — El agente está en línea y responde de inmediato a los mensajes de los usuarios.
- Estado activo sin marcar — El agente está fuera de línea. Los usuarios no pueden interactuar con él; en su lugar, ven un mensaje de "no disponible".
El estado activo se aplica de forma global: si un agente está inactivo, no estará disponible en ninguno de los canales de implementación (Interno, Widget externo, Comunidad, API).
¿Qué sucede cuando un agente está inactivo?
| Escenario | Comportamiento |
|---|---|
| El usuario abre el widget de chat | Aparece la ventana de chat, pero se muestra un mensaje de "no disponible" en lugar del campo de entrada del chat. El usuario no puede enviar mensajes. |
| El usuario intenta enviar un mensaje mediante la API | La llamada a la API devuelve un estado de error que indica que el agente no está activo. |
| Un flujo invoca al agente | El flujo recibe una respuesta de error. El agente no procesa la solicitud. |
| Conversaciones existentes | Se conserva todo el historial de conversaciones. Reactivar el agente no elimina ningún dato. |
¿Por qué desactivar un agente?
Existen varias razones válidas para desactivar temporalmente un agente:
- Mantenimiento — Pausa el agente mientras actualizas prompts, herramientas o la configuración.
- Pruebas — Prueba los cambios en un sandbox antes de volver a poner el agente en línea.
- Límites del plan — Tu plan de REDA AI puede limitar la cantidad de agentes activos. Desactiva los agentes que no uses para mantenerte dentro del límite.
- Uso estacional — Desactiva los agentes que solo se necesitan en ciertas épocas del año (por ejemplo, un agente de reclutamiento en la temporada de contratación).
- Actualizaciones de versión — Desactiva la versión anterior de un agente mientras implementas una versión nueva.
- Solución de problemas — Si un agente se comporta de forma inadecuada, desactívalo temporalmente mientras investigas.
Límites de agentes activos por plan
Tu licencia de REDA AI determina cuántos agentes pueden estar activos de forma simultánea. El plan gratuito permite 1 agente activo; los planes de pago llevan su propio límite en la clave de licencia que emite REDA. Consulta los detalles de tu plan en la pestaña Admin para ver tu límite.
Si intentas activar un agente por encima de tu límite, el guardado se bloquea con el mensaje «No se puede activar este agente. Su plan permite un máximo de X agentes activos. Desactive primero un agente existente o actualice su plan.» Desactiva otro agente o escribe al equipo de REDA a sales@reda.one para ampliar tu límite.
Cómo activar un agente
-
Abre el registro de definición de agente
En la aplicación de REDA AI, ve a Administración de agentes y haz clic en el agente que quieres activar.
-
Ubica el campo de estado activo
Desplázate hacia abajo en el registro de definición de agente para encontrar la casilla de verificación "Activo".
-
Marca la casilla de verificación
Haz clic en la casilla de verificación para marcarla.
-
Haz clic en Guardar
Guarda el registro. El agente ya está en línea y responderá a los mensajes de los usuarios.
-
Verifica la activación
Abre el widget de chat en una página donde el agente esté implementado y confirma que puedes interactuar con él.
Cómo desactivar un agente
-
Abre el registro de definición de agente
En la aplicación de REDA AI, ve a Administración de agentes y haz clic en el agente que quieres desactivar.
-
Ubica el campo de estado activo
Desplázate hacia abajo para encontrar la casilla de verificación "Activo".
-
Desmarca la casilla de verificación
Haz clic en la casilla de verificación para desmarcarla.
-
Haz clic en Guardar
Guarda el registro. El agente ya está fuera de línea.
-
Verifica la desactivación
Abre el widget de chat donde el agente estaba implementado. Deberías ver el mensaje de "no disponible" en lugar del campo de entrada del chat.
Prácticas recomendadas
Siempre desactiva los agentes en lugar de eliminarlos. Salesforce se negará a eliminar una definición de agente mientras tenga Prompts personalizados, Campos de contexto o Chips de sugerencia asociados — la eliminación falla con un error — y las conversaciones nunca se eliminan junto con un agente: permanecen en tu organización, desvinculadas de él. La desactivación es el camino limpio: mantiene toda la configuración intacta y reversible.
Supervisa los límites de agentes activos — Lleva un control de cuántos agentes están activos con respecto al límite de tu plan. Establece una revisión periódica (trimestral) para desactivar los agentes que ya no se usan y liberar espacios para agentes nuevos.
Documenta por qué un agente está inactivo — Si desactivas un agente, registra por qué y cuándo podría reactivarse — en un campo personalizado que agregue tu equipo o en la documentación propia de tu equipo (la definición de agente no tiene un campo de descripción integrado). Esto ayuda a los futuros administradores a entender el estado del agente.
Prueba antes de la activación completa — Al activar por primera vez un agente recién configurado, pruébalo primero en un entorno sandbox. Una vez que estés conforme, actívalo en producción.
Conservación de datos durante la desactivación
Desactivar un agente no elimina ningún dato:
- Historial de conversaciones — Todas las conversaciones anteriores se conservan en los registros de conversación del agente.
- Configuración — Los prompts, las herramientas, los campos de contexto y los ajustes permanecen sin cambios.
- Registros relacionados — Todos los registros relacionados (prompts personalizados, campos de contexto, etc.) permanecen intactos.
Cuando reactivas el agente, este arranca de nuevo con la configuración actual, pero todos los datos históricos siguen disponibles para fines de generación de informes y auditoría.
Registro de auditoría de activación y desactivación
REDA AI entrega el objeto Definición de agente con el seguimiento del historial de campos ya habilitado, así que no tienes que activar nada. Is Active es uno de los 28 campos con seguimiento, junto a los que cambian el comportamiento o el alcance de un agente: Persona, Channel, Deep Reasoning, Execution Context, Allowed Origins, Economy Tier Consent, los límites de tasa y la External API Key. Abre el registro de Definición de agente y consulta su lista relacionada de historial para ver quién cambió un ajuste y cuándo.
Ten en cuenta que se trata del historial del registro, no del Registro de auditoría de configuración: este último anota los cambios de configuración y metadatos, no las ediciones de los registros de Definición de agente. El historial de campos es el que responde a «¿quién desactivó este agente?».
Activación y desactivación masiva
Si necesitas activar o desactivar varios agentes a la vez:
- Usa Data Loader para exportar todos los registros de definición de agente.
- Modifica la columna de estado activo (true o false) en el archivo CSV.
- Usa Data Loader para actualizar los registros con el nuevo estado activo.
Preguntas frecuentes
Sí, por completo. Desactivar un agente simplemente desactiva su estado activo. Puedes reactivarlo en cualquier momento marcando de nuevo la casilla. Toda la configuración y el historial de conversaciones se conservan.
Las conversaciones existentes siguen funcionando hasta que la sesión expira (normalmente 30 minutos). Los mensajes nuevos de usuarios nuevos recibirán el mensaje de "no disponible". Es una práctica recomendada informar a los usuarios de que un agente se desactivará durante una ventana de mantenimiento.
No. Si intentas activar un agente y ya estás en tu límite, Salesforce mostrará un error. Primero debes desactivar otro agente o actualizar tu plan a un nivel superior.
Sí. Si un flujo o un sistema externo está llamando al agente mediante la API, la llamada fallará con un error que indica que el agente no está activo. Debes reactivar el agente o actualizar la integración para que use un agente distinto.
Próximos pasos
Aprende a optimizar la configuración de los agentes con Crear un agente con IA, o explora la administración de prompts para ajustar con precisión las respuestas de tu agente.