Incrustación de IFrame y Apps

Información general

Integra tu agente conversacional en aplicaciones web utilizando iFrame. Utiliza este enfoque para añadir agentes conversacionales a aplicaciones de terceros o a UiPath Apps utilizando el componente iFrame.

Usuarios previstos: desarrolladores y administradores que desean integrar agentes conversacionales en aplicaciones web personalizadas o UiPath Apps.

Disponibilidad de característica

Función	Disponible
Iniciar nuevo chat	✅
Historial de chat	✅
Eliminar sesión de chat	✅
Configuración	✅
Iniciar solicitudes	✅
Cargas de archivos	✅
Citas	❌
Vista previa de HTML	✅
Copiar respuesta	✅
Comentarios (miniaturas)	✅
Volcado de depuración	❌

Requisitos previos

Para insertar un agente conversacional, completa los siguientes pasos de configuración:

Configuración de administrador o desarrollador

1. Publica el agente conversacional en la carpeta de Orchestrator deseada.
2. Recupera el ID de versión del agente de Gestión de instancias.
3. Para UiPath Apps, crea un proyecto de Apps en UiPath Studio.
4. Para las aplicaciones de terceros, asegúrate de que la aplicación web admita la incrustación de iFrame.

Búsqueda del ID de agente

1. En Gestión de instancias, ve a Agentes > Agentes implementados.
2. Selecciona Chat para el agente deseado.
3. Copia el ID de agente de la URL. Por ejemplo, en la URL https://cloud.uipath.com/conversationalagents/agents_/deployed/chat/342061, el ID de agente es 342061.

Requisitos del usuario:

• Los usuarios autenticados deben tener una cuenta de UiPath con permiso para acceder al agente.
• Losusuarios anónimos deben tener acceso a la aplicación o superficie donde está integrado el agente.

Insertar el agente

Construcción de URL

Establece el origen de iFrame en una URL con el siguiente formato:

https://cloud.uipath.com/<organization>/<tenant>/autopilotforeveryone_/conversational-agents/?agentId=<agent_id>&mode=<mode>

Nota:

La organización y el nombre del tenant distinguen entre mayúsculas y minúsculas.

Parámetros de URL

Parámetro	Obligatorio	Descripción
agentId	Sí	El ID de versión del agente publicado
mode	No	embedded para la experiencia del carril derecho, fullscreen para pantalla completa (predeterminado: fullscreen)
title	No	Título que se muestra en el encabezado del chat (predeterminado: nombre del agente)
welcomeTitle	No	Título de la pantalla de bienvenida de primera ejecución
welcomeDescription	No	Descripción de la pantalla de bienvenida de primera ejecución
suggestions	No	Matriz de solicitudes sugeridas para la primera ejecución
showHistory	No	Mostrar/ocultar panel del historial de chat (predeterminado: true)

URL de ejemplo

Modo integrado básico:

https://cloud.uipath.com/myorg/mytenant/autopilotforeveryone_/conversational-agents/?agentId=12345&mode=embedded

Con mensaje de bienvenida y sugerencias:

https://cloud.uipath.com/myorg/mytenant/autopilotforeveryone_/conversational-agents/?agentId=12345&mode=embedded&title=HR Assistant&welcomeTitle=Welcome!&welcomeDescription=I can help you with HR questions&suggestions=["What is the PTO policy?","How do I submit expenses?"]

Integración en UiPath Apps

Para integrar un agente conversacional en UiPath Apps, utiliza el componente iFrame.

1. Abre tu aplicación en UiPath Apps Studio.

2. Añade un componente iFrame a tu página.

3. Establece la propiedad Origen de iFrame en la URL construida.

4. Publique la aplicación.

   

Al integrar un agente conversacional en UiPath Apps, evita la matriz de sugerencias utilizando comillas dobles, como se muestra en el siguiente ejemplo:

suggestions=[""What is the PTO policy?"",""How do I submit expenses?""]

Esto es necesario porque UiPath Apps valida el valor como una cadena.

Integración en aplicaciones de terceros

Puedes incrustar un agente conversacional en cualquier aplicación web que admita la incrustación de iFrame.

Ejemplo de HTML:

<iframe
  src="https://cloud.uipath.com/myorg/mytenant/autopilotforeveryone_/conversational-agents/?agentId=12345&mode=embedded"
  width="400"
  height="600"
  frameborder="0"
  allow="clipboard-write"
></iframe>

Consideraciones

• Políticas de origen cruzado: asegúrate de que la Política de seguridad de contenido de tu aplicación permite incrustar desde uipath.com.
• Diseño adaptable: configura los valores de anchura y altura adecuados para garantizar una representación adecuada en todos los tamaños de pantalla.
• Acceso al portapapeles: incluye allow="clipboard-write" para habilitar la función de copia de respuesta.

Características de chat

La experiencia de chat integrada utiliza la IU de chat de gestión de instancias , que proporciona la misma funcionalidad de chat, con las siguientes excepciones y limitaciones.

Limitaciones

Las siguientes características no están disponibles en modo integrado:

Función	Notas
Citas	La vista previa de la cita no está disponible
Volcado de depuración	No disponible. Utiliza la gestión de instancias para la depuración.

Opciones de autenticación

Usuarios autenticados

Para usuarios internos con cuentas de UiPath:

• Los usuarios se autentican utilizando la autenticación estándar de UiPath.
• El agente tiene acceso a la información de identidad del usuario, como el nombre y la dirección de correo electrónico.
• El consumo se rastrea contra la licencia del usuario.

Usuarios anónimos

Para escenarios externos o no autenticados:

• Se debe configurar una aplicación externa confidencial en el portal de administración.
• Se requiere un punto final de token alojado por su organización.
• No se requiere ninguna licencia de usuario individual.
• El consumo se deduce del grupo de unidades del tenant.

Para obtener instrucciones de configuración, consulta Configuración de acceso anónimo.

Para obtener más información sobre las licencias, consulta Licencias.

ADVERTENCIA:

El acceso anónimo permite a los usuarios sin cuentas de UiPath interactuar con tu agente. Recomendamos encarecidamente que los agentes anónimos estén detrás de su propio portal o inicie sesión para mitigar el abuso.

Solución de problemas

iFrame no se carga

• Verifique que la URL se haya construido correctamente.
• Comprueba que el ID de agente es válido.
• Asegúrate de que el agente esté publicado y en ejecución.
• Compruebe la consola del navegador para ver si hay errores en la política de seguridad de contenido.

La copia no funciona

• Asegúrese de que el iFrame incluya el atributo allow="clipboard-write" .
• Compruebe los permisos del navegador para acceder al portapapeles.

Próximos pasos

• Configuración de acceso anónimo: habilitar el acceso para usuarios sin cuentas de UiPath
• Gestión de instancias: referencia de características completas y depuración