SetFN
SetFNDocs27 de octubre de 2026

Desplegar un ejemplo de chat de asistencia con AI

Active la función AI responses de Webspace y pruebe el flujo de asistencia en el archivo chat.html que se genera durante el despliegue. Esta configuración utiliza el modelo y la canalización de ejecución de Agent que ya haya configurado el administrador, en lugar de crear un modelo o un Agent para cada Webspace.

Antes de empezar

  • Necesita permiso para desplegar esquemas y API.
  • Un administrador del servidor debe conectar un proveedor de AI y registrar y activar un modelo de chat.
  • Decida qué miembros, niveles, equipos o administradores recibirán el permiso Use de AI responses.
  • Los miembros que usen chat.html deben poder iniciar sesión en el mismo sitio de SetFN.
  • Revise la visibilidad de los datos de asistencia y las instrucciones del sistema.

Preparar los modelos de AI del administrador

Conecte un proveedor de AI en la configuración de administración y registre y active el modelo de chat que se usará para la asistencia. Si deja vacíos Primary model y Fallback model en Webspace, el servidor priorizará automáticamente los modelos de chat activos que estén disponibles. Las solicitudes que incluyan una imagen también seguirán las prioridades de modelos OCR/VL configuradas por el administrador.

Defina Primary model y Fallback model en Advanced settings solo cuando necesite fijar los modelos de un Webspace concreto. No incluya claves de proveedores ni secretos de modelos en las páginas de Webspace o en chat.html. La página de asistencia llama a la conexión de la función de AI desplegada, mientras que la selección del modelo y la ejecución de Agent siguen la canalización existente del servidor.

Configurar las opciones avanzadas de las respuestas con AI

Active AI responses en API Build del esquema y abra Advanced settings.

  1. Configure AI responses como Enabled.
  2. Deje vacíos Primary model y Fallback model, salvo que necesite sustituir los modelos de forma explícita.
  3. Active Use tools solo si el flujo de asistencia necesita herramientas. Está desactivado de forma predeterminada.
  4. Introduzca el ámbito de la asistencia y las reglas de respuesta en las instrucciones del sistema.
  5. Configure el permiso Use.
  6. Active Generate a support chat sample.

El archivo de esquema guarda la opción con la siguiente estructura:

{
  "apiBuild": {
    "features": {
      "ai-chat": {
        "enabled": true,
        "sampleChat": true
      }
    }
  }
}

sampleChat solo controla si se genera el ejemplo. No copia ni sobrescribe la configuración existente de los modelos y Agents del administrador.

Generar chat.html durante el despliegue

Webspace genera chat.html cuando tanto enabled como sampleChat tienen el valor true para AI responses y el despliegue incluye los ejemplos de frontend. Seleccione una ruta de despliegue del cliente y despliegue el esquema. chat.html se guarda en la carpeta de salida actual de los ejemplos de frontend, junto con index.html y test.html; no se crea una carpeta aparte para la asistencia con AI.

상담서비스/
├── index.html
├── test.html
├── chat.html
├── style.css
└── README.md

Inicie sesión como miembro en el mismo sitio de SetFN y abra chat.html. El ejemplo inicializa los datos del miembro desde la sesión actual, por lo que no debe suponer que funciona como un chat público anónimo.

  1. Compruebe que los miembros sin el permiso Use de AI responses no puedan enviar solicitudes.
  2. Envíe un mensaje desde una cuenta que tenga permiso.
  3. Compruebe que la respuesta llegue a través del modelo o la canalización de Agent existentes del administrador.
  4. Si ha activado Use tools, compruebe que solo puedan ejecutarse las herramientas permitidas.
  5. Interrumpa la conexión y compruebe que la página muestre un estado de error sin duplicar el mensaje.

Adaptar la página de asistencia

El archivo chat.html generado sirve como punto de partida para comprobar la conexión y los permisos. Puede adaptar las indicaciones, las preguntas sugeridas y el estilo visual al propósito del servicio. No sustituya la conexión, la autenticación ni la selección de modelos gestionada por el servidor por opciones controladas desde el cliente.

Defina en las instrucciones del sistema el ámbito de la asistencia y cómo deben tratarse las preguntas que no puedan verificarse. Antes de la puesta en marcha, pruebe preguntas, llamadas a herramientas y respuestas de error con cuentas que representen cada nivel de permisos.

Información útil

  • chat.html es un cliente de ejemplo y no crea un modelo de AI ni un Agent aparte.
  • Cuando Primary model y Fallback model están vacíos, el servidor selecciona automáticamente un modelo según la configuración del administrador y la disponibilidad de los modelos.
  • Generar el ejemplo y conectar el protocolo de Agent no garantizan una respuesta real del proveedor de AI. Antes de la puesta en marcha, envíe un mensaje real mediante el proveedor, el modelo o el Agent configurados en el servidor.
  • El ejemplo usa el protocolo de AI Agent existente y muestra el estado de las herramientas y los avisos de aprobación pendiente y entrada pendiente. Sin embargo, no incluye controles para completar una aprobación ni proporcionar la entrada solicitada.
  • Use tools está desactivado de forma predeterminada. Antes de activarlo, compruebe que exista una interfaz aparte capaz de gestionar las aprobaciones o entradas adicionales que necesite el Agent.
  • El ejemplo requiere el inicio de sesión de un miembro y la inicialización de su sesión; no se garantiza el uso público anónimo.
  • Revise los permisos de las herramientas por separado del permiso Use de AI responses.
  • Incluya indicaciones para impedir que se introduzcan datos personales o secretos en los mensajes de asistencia.
  • Antes de volver a desplegar un ejemplo modificado, compruebe qué archivos podrían sobrescribirse.

Documentos relacionados