会話型エージェントを埋め込む

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 Apps に会話型エージェントを埋め込む

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.

   任意パラメーター

   • mode - embedded または fullscreen を指定できます (既定値は fullscreenです)。
   • title - チャット コンポーネントのタイトルです。既定ではエージェントの名前が使用されます。
   • welcomeTitle - 画面の中央に表示される初回実行エクスペリエンスのタイトルです。既定値は空の文字列 ''です。
   • welcomeDescription - 初回の操作エクスペリエンスの説明です。既定値は空の文字列 ''です。
   • 提案 - 初回実行エクスペリエンスの提案です。既定では空の配列 []です。例: ["Hi, what can you do", "Hello, how are you"]
     注:

     ブラウザーで直接テストするには、1 セットの二重引用符で囲みます。アプリの埋め込みの場合は、二重引用符を 2 セットで囲みます。

   • showHistory - 履歴パネルを表示します。既定値は [ trueです。
   • jobStartOverrides - 会話の提供時に実行される会話エージェント ジョブのオーバーライド。渡されない場合、または runAsMe が未定義の場合、CASはデフォルトのジョブ開始設定 RunAsMe: falseでジョブを実行します。例: jobStartOverrides={"runAsMe":true}
     注:

     ブラウザーで直接テストするには、1 セットの二重引用符で囲みます。アプリの埋め込みの場合は、二重引用符を 2 セットで囲みます。

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

よくある質問

agentId の取得方法

• [ エージェント ] > [会話型エージェント] に移動してエージェントを開き、URL から agentId をコピーします。

会話型エージェントを公開する方法はありますか?

• まだです。パブリック アクセスには、認証、セキュリティ、およびライセンスに関連する追加の作業が必要です。

クライアントにコンテキストを注入することは可能ですか?

• 会話エージェントへの入力の挿入は、現在サポート中です。