Agentes IA

Agentes IA es la consola de control para configurar perfiles de agente, vincularlos con API keys, mantener bloques de conocimiento, probar su comportamiento y revisar la memoria y la actividad generadas.

Valores de ejemplo

Las cifras, nombres y textos que aparecen en las capturas pertenecen a una instalación de demostración. Los perfiles, memorias, claves y permisos disponibles dependen de cada tenant.

ResumenCopy Anchor Link

La pestaña Resumen presenta la shell operativa de Agentes IA y organiza el trabajo en cinco zonas: Resumen, Perfiles, Conocimiento, Preview y Actividad.

El panel superior muestra cuatro indicadores:

• Perfiles activos: perfiles habilitados.
• Links key/perfil: vínculos entre perfiles y API keys.
• Bloques editables: bloques de conocimiento configurables.
• Memorias vigentes: memorias disponibles en ese momento.

La vista general resume el orden recomendado de configuración:

1. Identidad: definir perfiles y enlazar API keys.
2. Contexto: mantener los bloques de conocimiento.
3. Verificación: comprobar exactamente qué verá el agente en el preview.

La regla operativa de la pantalla separa la configuración de la auditoría: primero se configura el perfil, después se vincula la credencial y finalmente se valida el resultado en Preview. La memoria y la actividad se revisan en sus pestañas correspondientes.

PerfilesCopy Anchor Link

La pestaña Perfiles permite gestionar agentes existentes y abrir el alta de uno nuevo cuando sea necesario.

Cada perfil reúne los datos que definen su identidad y sus límites de contexto:

• Nombre y Slug.
• Descripción.
• Instrucción base, que indica cómo debe comportarse antes de ejecutar acciones.
• Resumen memoria, Detalle memoria y TTL días.
• Scopes por defecto.
• Política de confirmación JSON.
• Casilla Perfil activo.

El perfil de ejemplo se llama System Default Agent, tiene el slug system-default y está marcado como activo. Los números de memoria y la política mostrados son configuraciones del ejemplo, no valores universales.

Guardar un perfilCopy Anchor Link

El botón Guardar perfil conserva los cambios del perfil. Antes de activarlo, revisa especialmente la instrucción base, los límites de memoria, la política de confirmación y los scopes por defecto.

Vincular una API keyCopy Anchor Link

En la misma zona se encuentra el bloque Enlazar API key. El vínculo asocia una credencial existente con un perfil:

• Selecciona la API key.
• Indica el Agent name.
• Revisa la casilla Link activo.
• Pulsa Guardar enlace.

La ventana Editar API Key permite modificar el nombre descriptivo y los scopes, además de configurar, cuando proceda, una expiración y un rate limit propio. En la captura aparecen seleccionados los permisos de runtime profile, conocimiento y lectura de memoria, y de escritura de memoria remota.

También se muestran scopes separados para CoreChat, Clientes y Prospectos. No concedas permisos de lectura, escritura o administración que el agente no necesite.

Principio de mínimo privilegio

Una API key da acceso a las capacidades que tenga marcadas. Usa claves separadas para agentes o integraciones con responsabilidades distintas y revisa periódicamente sus scopes, expiración y enlaces activos.

La gestión general de credenciales e integraciones se relaciona con Autenticación y scopes y Webhooks. No copies una clave completa en la documentación ni en conversaciones de soporte.

ConocimientoCopy Anchor Link

La pestaña Conocimiento contiene los bloques editables que el agente debe leer como contexto operativo.

Cada bloque incluye:

• Clave, usada para identificarlo.
• Título visible para los operadores.
• Markdown operativo, donde se escriben reglas, límites, tono o excepciones reales del CRM.
• JSON estructurado opcional, para información que necesite una estructura explícita.
• Orden, que permite ordenar los bloques.
• Casilla Activa.
• Botón Guardar sección.

La captura muestra dos ejemplos:

• tenant_working_rules: reglas operativas del tenant.
• memory_write_rules: reglas para escribir memoria, como resumir, evitar credenciales y dejar claro el siguiente paso.

Recomendaciones para los bloquesCopy Anchor Link

• Escribe reglas concretas y aplicables al tenant.
• Separa las reglas de negocio de las instrucciones de memoria.
• No incluyas secretos, API keys ni datos que no deban exponerse al agente.
• Mantén desactivado un bloque mientras lo estés revisando.
• Guarda cada sección y comprueba su efecto en Preview.

PreviewCopy Anchor Link

Preview sirve para validar el contexto que recibe el agente antes de utilizarlo en una operación real. La secuencia recomendada es revisar el perfil, el vínculo de API key y los bloques activos, y después comprobar qué respuesta produciría el agente.

La captura de resumen identifica esta validación como el tercer paso del flujo: comprobar exactamente qué verá el agente. La pantalla puede cambiar según el perfil y el conocimiento configurados.

Actividad y memoriaCopy Anchor Link

La pestaña Actividad separa la memoria remota reciente de la actividad agéntica reciente.

En la columna de memoria aparecen resultados como acciones de reserva, correo, conocimiento, formularios o campañas. En la columna de actividad aparecen operaciones como Guardó memoria del agente o Consultó la memoria del agente.

Cada entrada identifica el resultado y ofrece Ver detalle técnico. Esta vista permite comprobar qué se guardó o consultó y mantener separada la actividad operativa de la configuración del perfil.

Ejemplo: un agente consultando el CRMCopy Anchor Link

La siguiente captura muestra una interfaz de agente preguntando por datos del CRM. La persona formula una pregunta en lenguaje natural y el agente ejecuta una consulta de tickets antes de responder.

En el ejemplo se observa este ciclo:

1. El usuario pregunta cuántos tickets hay hasta la fecha.
2. El agente ejecuta una operación de listado de tickets.
3. Devuelve un total y un desglose por estado.
4. Ante una segunda pregunta, consulta las tareas y aclara que el total mostrado es bruto y puede incluir duplicados o tareas automáticas.

La respuesta debe distinguir siempre entre un total agregado, los estados de los registros y las posibles limitaciones del dato. Para interpretar la información resultante, consulta las guías de Tickets y Tareas.

Flujo de puesta en marchaCopy Anchor Link

1. Crea o revisa el perfil del agente.
2. Define una instrucción base clara y una política de confirmación adecuada.
3. Concede únicamente los scopes necesarios en la API key.
4. Vincula la API key al perfil y verifica que el enlace está activo.
5. Crea los bloques de conocimiento del tenant.
6. Comprueba el contenido y el orden de los bloques.
7. Valida el comportamiento en Preview.
8. Revisa Actividad y memoria después de una prueba controlada.
9. Ajusta el perfil o el conocimiento si el resultado no es el esperado.

Revisión antes de producción

No actives un agente solo porque la respuesta sea correcta en una pregunta. Comprueba también sus permisos, la política de confirmación, la escritura de memoria y el rastro que deja en Actividad.