嵌入对话智能体

使用 Studio Web 中的 IFrame 控件将已发布的对话智能体嵌入到 UiPath 应用或第三方应用程序中。

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.

将对话智能体嵌入 UiPath 应用程序

1. 创建并发布对话智能体。

2. Open your app project in Studio.

3. Add an IFrame component to your page.

4. 使用以下格式设置 IFrame 源 URL：

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

   重要提示：

   组织和租户可以是智能体的ID或智能体名称

   必需参数

   • agentId: Release ID of the published conversational agent.

   可选参数

   • “模式” - 可以是embedded或fullscreen （默认值为fullscreen ”）。
   • 标题- 聊天组件的标题。默认为智能体的名称。
   • “欢迎标题” - 屏幕中央显示的首次运行体验标题。默认为空字符串'' 。
   • 欢迎描述- 首次运行体验描述。默认为空字符串'' 。
   • 建议- 首次运行体验建议。默认为空数组[] 。示例： ["Hi, what can you do", "Hello, how are you"] 。
     备注：

     要直接在浏览器中测试，请使用一组双引号 将其括起。对于嵌入 Apps，请使用两组双引号 将其括起。

   • 显示历史记录- 显示历史记录面板。默认为true 。
   • “作业开始覆盖” - 覆盖在提供对话时运行的对话代理作业。如果未传递或未定义runAsMe ，Kubernetes 将使用默认的作业开始设置RunAsMe: false运行作业。示例： jobStartOverrides={"runAsMe":true}
     备注：

     要直接在浏览器中测试，请使用一组双引号 将其括起。对于嵌入 Apps，请使用两组双引号 将其括起。

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

示例 URL

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

在第三方服务中嵌入对话智能体

1. 创建并发布对话智能体。
2. 向您希望显示对话智能体的应用程序添加一个<iframe>元素。
3. 使用以下格式设置“IFrame 来源” 属性：

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

常见问题

如何检索智能体 ID？

• 导航到“智能体” > “对话智能体” ，打开智能体，然后复制 URL 中的agentId 。

是否有方法可将对话智能体设为公开?

• 还没有。需要在公共访问权限方面开展与身份验证、安全和许可相关的额外工作。

是否可以向客户端注入一些上下文？

• 我们正在开发对将输入注入对话智能体的支持。