Insertar agentes conversacionales

Puedes incrustar un agente conversacional directamente dentro de una aplicación UiPath o cualquier aplicación de terceros utilizando un IFrame. Esto permite a los usuarios interactuar fácilmente con los agentes sin salir de la aplicación.

Incrustar agentes de conversación en UiPath Apps

1. Crea y publica un agente conversacional.
2. Abre tu proyecto de aplicación en Studio y añade un componente IFrame a tu página.
3. Establece la URL de origen del IFrame utilizando el siguiente formato:

   "https://<cloud_env>.uipath.com/<organization>/<tenant>/autopilotforeveryone_/conversational-agents/?agentId=<agent_id>&mode=embedded&title=<title>&welcomeTitle=<welcome_title>&welcomeDescription=<welcome_description>&suggestions=<suggestions>"
   

   Importante:

   La organización y el tenant pueden ser el ID del agente o el nombredel agente

Parámetros requeridos

• IDDeAgente: ID de versión del agente conversacional publicado.Parámetros opcionales
• modo : puede ser embedded o fullscreen (el valor predeterminado es fullscreen).
• título : el título del componente de chat. El valor predeterminado es el nombre del agente.
• TítuloDeBienvenida : el título de la experiencia de primera ejecución se muestra en el centro de la pantalla. El valor predeterminado es una cadena vacía ''.
• DescripciónDeBienvenida : descripción de la experiencia de primera ejecución. El valor predeterminado es una cadena vacía ''.
• sugerencias : primero ejecuta sugerencias de experiencia. El valor predeterminado es una matriz vacía []. Ejemplo: ["Hi, what can you do", "Hello, how are you"].
  Nota:

  Para probar en el navegador directamente, ajuste en un conjunto de comillas dobles. Para la incrustación de Apps, ajuste en dos conjuntos de comillas dobles.

• showHistory : muestra el panel del historial. El valor predeterminado es true.
• jobStartOverrides : anula los trabajos de agente conversacional que se ejecutan al servir la conversación. Cuando no se pasa o cuando runAsMe no está definido, CAS ejecutará el trabajo con la configuración predeterminada de inicio de trabajo RunAsMe: false. Ejemplo: jobStartOverrides={"runAsMe":true}
  Nota:

  Para probar en el navegador directamente, ajuste en un conjunto de comillas dobles. Para la incrustación de Apps, ajuste en dos conjuntos de comillas dobles.

URL de ejemplo para incrustar agentes conversacionales en Apps "https://<cloud_env>.uipath.com/<organization>/<tenant>/autopilotforeveryone_/conversational-agents/?agentId=<agent_id>&mode=embedded&title=Conversational Agents&welcomeTitle=Welcome to conversational agents&welcomeDescription=Talk with your agent to get started&suggestions=[""Hi, what can you do"", ""Hello, how are you""]" 4. Publica tu aplicación. Tu agente está ahora integrado y listo para usar.

Insertar agentes conversacionales en servicios de terceros

1. Crea y publica un agente conversacional.
2. Añade un elemento <iframe> a tu aplicación donde quieras que aparezca el agente conversacional.
3. Establece el atributo de origen de IFrame utilizando el siguiente formato:

   "https://<cloud_env>.uipath.com/<organization>/<tenant>/autopilotforeveryone_/conversational-agents/?agentId=<agent_id>&mode=embedded&title=<title>&welcomeTitle=<welcome_title>&welcomeDescription=<welcome_description>&suggestions=<suggestions>"
   

Preguntas frecuentes

¿Cómo se recupera el ID de agente?

• Ve a Agentes > Agentes conversacionales, abre tu agente y copia el agentId de la URL.

¿Hay alguna forma de hacer público el agente conversacional?

• Todavía no. El acceso público requiere trabajo adicional relacionado con la autenticación, la seguridad y las licencias.

¿Es posible inyectar algo de contexto al cliente?

• El soporte para inyectar entradas en agentes conversacionales está en desarrollo.