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

IFrame を使用して、UiPath アプリまたはサードパーティ アプリケーション内に会話エージェントを直接埋め込むことができます。これにより、ユーザーはアプリケーションを離れることなくエージェントを簡単に操作できます。

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

1. 会話エージェントを作成してパブリッシュします。
2. Studio でアプリ プロジェクトを開き、IFrame コンポーネントをページに追加します。
3. 次の形式で 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: 公開された会話エージェントの公開されたリリース ID。省略可能なパラメーター
• 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 セットで囲みます。

Apps に会話エージェントを埋め込むための 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""]" 4.アプリをパブリッシュします。これで、エージェントが埋め込まれ、すぐに使用できます。

会話型エージェントをサードパーティのサービスに埋め込む

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 をコピーします。

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

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

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

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