Zona de agentes IA

Agentes configurables para trabajar con documentos, capacidades y contexto privado.

La zona de agentes permite preparar asistentes de inteligencia artificial para una web, una zona privada o un entorno interno. Cada agente puede tener su propia configuracion, sus documentos, sus capacidades y sus reglas de uso.

El objetivo es que el agente no responda como un chat generico, sino como una herramienta conectada a la informacion del cliente, a los permisos definidos y al alcance real de cada proyecto.

Acceder al area de gestion Ver ejemplo de integracion

Que se configura

Identidad, rol, tono y forma de responder del agente.
Documentos, normalizados, manuales y textos de referencia.
Capacidades disponibles y permisos de uso.
Parametros de IA, modelo, tokens, memoria y trazabilidad.

Configuracion del agente

Define nombre, version, rol, tono, nivel tecnico, nivel de detalle, tratamiento al usuario, actitud y forma de responder.

Documentos y conocimiento

Vincula documentos internos, plantillas, textos legales, guias, normalizados, politicas o manuales para que el agente responda con una base controlada.

Capacidades

Activa funciones concretas segun el objetivo: consultar documentacion, orientar al usuario, explicar requisitos, clasificar solicitudes o preparar respuestas.

Uso de IA

Configura modelo, temperatura, maximo de tokens, uso de memoria, uso de documentos y restricciones para adaptar el comportamiento del agente.

Agente documental

Busca en documentos vinculados, resume obligaciones, explica modelos y ayuda al usuario a encontrar la informacion correcta.

Agente comercial

Responde dudas iniciales, explica servicios, recoge contexto de la consulta y deriva hacia contacto o contratacion cuando procede.

Agente de soporte

Atiende preguntas frecuentes, guia pasos dentro de una zona privada y ayuda a completar procesos sin saturar al equipo humano.

Agente sectorial

Ajusta respuestas por actividad, tipo de informacion, cliente, permisos y alcance documental configurado para cada entorno.

Pasos de integracion

Incluir el script lanzador en la pagina donde se quiera mostrar el agente.
Anadir, si se desea, un boton con data-semper-agent-menu para mostrar u ocultar el chat.
Dejar que el lanzador prepare el contenedor donde se insertara el agente.
Configurar el endpoint, el token del despliegue y los textos visibles del chat.
Cuando el usuario escriba, el runtime enviara la consulta al endpoint configurado.

<!-- Boton opcional para abrir/cerrar el agente -->
<button type="button" data-semper-agent-menu>
  Mostrar Agente
</button>

<!-- Script lanzador entregado para el despliegue -->
<script src="/agente-semper-global.js" defer></script>

// Configuracion que lleva el lanzador del despliegue
const mountOptions = {
  root: "#semper-agent-root",
  endpoint: "/AGENTES-IA/agente-runtime-api.php",
  deploymentToken: "TOKEN_DEL_DESPLIEGUE",
  agentName: "Agente Web semperconfidentia",
  placeholder: "Pregunte por informacion sobre la empresa...",
  Pregunta_inicial: "Para adaptar mejor las respuestas, indique su actividad.",
  initialContext: {
    storage: "session",
    key: "semper_agent_visitor_profile",
    payloadField: "perfilVisitante",
    askInChat: false,
    fallbackValue: "Prefiere no indicar su actividad."
  }
};

Que ocurre al preguntar

El desarrollador no tiene que construir manualmente cada peticion del chat. Una vez montado, el runtime recoge el mensaje del usuario, anade la configuracion del despliegue y envia la consulta al endpoint indicado.

El backend responde segun el agente configurado, sus documentos asociados, sus capacidades activas y el contexto disponible para esa sesion.

root: Selector del contenedor donde se insertara el agente.
endpoint: URL que recibira las consultas del agente.
deploymentToken: Token que identifica el despliegue autorizado.
agentName: Nombre del agente publicado que se mostrara y se usara como referencia de configuracion.
placeholder: Texto visible en el campo donde escribe el usuario.
Pregunta_inicial: Mensaje inicial para pedir contexto antes de empezar o guiar la primera interaccion.
initialContext: Configuracion opcional para guardar contexto temporal del visitante y enviarlo junto a sus consultas.
data-semper-agent-menu: Atributo opcional para que un boton abra y cierre el agente sin recargar la pagina.