Insertar agentes conversacionales

Incrusta un agente conversacional publicado en una aplicación de UiPath o de terceros utilizando un control IFrame en Studio Web.

You can embed a conversational agent directly inside a UiPath App or any third-party application using an IFrame. This allows users to interact with agents without leaving the application.

Incrustar agentes de conversación en UiPath Apps

1. Crea y publica un agente conversacional.

2. Open your app project in Studio.

3. Add an IFrame component to your page.

4. 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

   • agentId: Release ID of the published conversational agent.

   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.

5. Publish your app. Your agent is now embedded and ready to use.

URL de ejemplo

"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""]"

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.