Chat web

El chat web es el chat en el navegador del espacio de trabajo. Las personas inician sesión, eligen un agente y un modelo, y chatean. Cada espacio de trabajo tiene una dirección de chat web:

https://<your-virtuai-host>/chat/w/<workspace-slug>

Quién puede usarlo

El chat web no es anónimo. Para chatear, una persona inicia sesión con una cuenta de VirtuAI que sea miembro del espacio de trabajo. Sirve cualquier rol. Consulta Usuarios y roles.

Si tu organización accede a VirtuAI a través de Google Cloud IAP, un administrador de la plataforma puede permitir el acceso a personas de dominios de correo electrónico aprobados sin un inicio de sesión aparte. Esto se configura en Workspaces, en IAP / Web Chat Access.

Activa el chat web para un agente

1. Abre Agents y edita el agente.

2. En Channels, activa Web Chatbot. Cuando está activado, la tarjeta muestra Visible in workspace selector.

3. En AI Model Configuration, elige el proveedor y el modelo predeterminado. Luego, selecciona los modelos a los que las personas pueden cambiar en el chat web.

4. Guarda el agente.

Los agentes que tienen Web Chatbot desactivado no aparecen en el selector de agentes.

Comparte un vínculo

En la sección Integration URLs del agente, copia Web Chat UI. Abre el chat del espacio de trabajo.

Para abrir un agente específico, agrega su ID de agente:

https://<your-virtuai-host>/chat/w/<workspace-slug>?agent=<agent-id>

Insértalo en otro sitio

Puedes mostrar el chat web dentro de otra página con un iframe:

<iframe
  src="https://<your-virtuai-host>/chat/w/<workspace-slug>?agent=<agent-id>"
  title="Assistant"
  style="width: 100%; height: 640px; border: 0;"
  allow="microphone"
></iframe>

• Las personas inician sesión dentro del marco, igual que en la página completa.
• allow="microphone" solo es necesario si las personas grabarán notas de voz.

Orígenes de marco permitidos

Los navegadores solo muestran el chat dentro de los sitios que permite tu implementación de VirtuAI. Esta lista se configura para toda la implementación, no por espacio de trabajo. Para insertarlo en un sitio nuevo, envía su origen (por ejemplo, https://portal.example.com) a tu administrador de VirtuAI o a Soporte.

Qué pueden hacer las personas en el chat

• Elegir un agente y, si permitiste más de uno, un modelo.
• Adjuntar hasta 3 archivos por mensaje, de 10 MB cada uno: imágenes (JPEG, PNG, GIF, WebP), PDF, texto sin formato, CSV, Markdown, Word, Excel y PowerPoint.
• Grabar un mensaje de voz. Se transcribe y se envía al agente como texto, y la grabación se puede seguir reproduciendo en el chat.
• Detener una respuesta, editar un mensaje enviado, copiar una respuesta y seleccionar Continue cuando una respuesta se cortó por el límite de salida.
• Volver a abrir conversaciones anteriores desde History o iniciar una New conversation.
• Responder a las solicitudes de aprobación de comandos: Allow once, Allow for this chat, Allow 60 min, Always allow o Deny.

La transcripción de mensajes de voz usa Google Cloud Speech-to-Text. Puedes configurar el modelo y los idiomas con TRANSCRIPTION_MODEL y TRANSCRIPTION_LANGUAGE_CODES en Settings.

Personaliza la apariencia

En Settings, en Webchat Appearance, configura los colores del espacio de trabajo:

Configuración	Qué cambia
Button Color	Los botones principales
User Bubble Color	Las burbujas de los mensajes de la persona
Avatar Background Color	El círculo detrás del avatar del agente
Accent Color	La etiqueta con el nombre del agente y el anillo de foco del campo de entrada

Cada agente también puede tener su propia imagen de avatar. Configúrala con la URL de una imagen cuando edites el agente.

Comentarios

Las personas pueden calificar cualquier respuesta con Good response o Bad response. Revisa las calificaciones en Monitor > Feedback y fíltralas por positivas o negativas. Las transcripciones completas están en Conversations.

Solución de problemas

“No agents available” : Ningún agente del espacio de trabajo tiene Web Chatbot activado.

“No models available for this agent” : El agente no tiene modelos seleccionados para el chat web. Edita el agente y selecciona al menos uno en AI Model Configuration.

El chat insertado aparece en blanco o no se carga : El origen del sitio no está en la lista de orígenes de marco permitidos de la implementación. Consulta Insértalo en otro sitio.

“You are not a member of this workspace” : La persona inició sesión con una cuenta que no pertenece a este espacio de trabajo. Invítala en Users.