会話型エージェントの利用を開始する

会話型エージェントの構築は、設計、テスト、デプロイ、監視を含む系統だったライフサイクルに従います。主な手順は次のとおりです。

1. エージェントを設計する: Studio Web を使用して、エージェントのシステム プロンプトの定義、利用可能なツールの設定、コンテキスト グラウンディングの追加、エスカレーション ワークフローの設定を行います。
2. テストして評価する: 組み込みのデバッグ チャットを使用して、複数ターンの対話をテストします。実際の会話またはシミュレートした会話を評価セットに追加し、動作とパフォーマンスを検証します。
3. パブリッシュしてデプロイする: エージェントをソリューション パッケージとして Orchestrator にパブリッシュします。ソリューション フォルダーに、実行に使用するサーバーレス ロボットと Unattended ロボットが含まれていることを確認します。
4. アクセスおよび管理する: インスタンスの管理を使用してエージェントと対話します。実行時の動作を監視し、トレース ログを確認して、フィードバックに基づいて反復処理を行います。

会話型エージェントを設計する際は、以下のベスト プラクティスを考慮してください。

1. 明確なペルソナで始める: エージェントのトーンとスコープを定義します (例: 「あなたはフレンドリーな人事アシスタントです...」)。
2. 予測できない結果に対応できるように設計する: ユーザーは不完全な情報や誤った情報を提供する可能性があります。曖昧さに適切に対応できるようにします。
3. ツールの使用方法をガイドする: ツールの説明に、そのツールをいつ、どのように使用するかを明確に記載します。
4. 評価によって反復処理する: 好結果が得られたパスと得られなかったパスの両方のテスト ケースを作成します。それに従ってエージェントのロジックを更新します。

会話型エージェントを構築する

会話型エージェントは、自律型エージェントの場合と同じく Studio Web のローコード デザイナーを使用して作成できますが、重要な違いとして、会話型エージェントはリアルタイムに複数ターンの対話を行えるように調整されています。

エージェントを作成する

開始するには、以下の手順を実行します。

1. studio.uipath.com に移動します。

2. [新規作成] ボタン、[エージェント] の順に選択します。

3. エージェントの種類として [会話型] を選択します。

   必要に応じて、エージェントを Autopilot に説明し、出発点となる設定を生成します。

図 1. 新しい会話型エージェントの作成

注:

会話型エージェントとの会話を開始すると、そのチャット専用の Orchestrator プロセスがトリガーされます。このプロセスは常に「実行中」として生成されるため、メッセージにすぐに応答できます。ただし、プロセスがリソースを消費するのは、実際にメッセージを送信したときだけです。アイドル状態で待機している間は、リソースを一切使用しません。

システム プロンプトを設定する

システム プロンプトでは、エージェントのペルソナ、目標、動作の制約、ツール/エスカレーションのロジックを定義します。システム プロンプトを使用して、以下をどのように行うかをエージェントに指示します。

• ユーザーへの挨拶
• 不明なクエリの処理
• 問題のエスカレーションまたはツールの呼び出し
• 一貫したトーンとスタイルの維持

ヒント:

Autopilot を使用すると、ユース ケースに基づいて効果的な開始プロンプトを生成するのに役立ちます。

Conversational agents do not use user prompts or Data Manager inputs/outputs, however the conversational agent will have knowledge of authenticated user's name and email.

ツールを設定

Conversational agents can use the same tools as autonomous agents, including RPA workflows, API workflows, activities, other agents (excluding conversational agents), MCP servers (preview), IXP models (preview), and ready-to-use tools such as Analyze Attachments.

ヒント:

API 呼び出しのみを実行するワークフローの場合、リアルタイム チャットで最高のパフォーマンスを実現するには API ワークフローを使用することをお勧めします。

ツールレベルのガードレールを使用してランタイム ポリシーを適用します。ガードレールはテスト時と実行時の両方に適用され、トレース ログに表示されます。詳しくは、「ガードレール」をご覧ください。

コンテキストを設定する

コンテキスト グラウンディングのインデックスを追加し、エージェントが特定のナレッジ ソースにアクセスできるようにします。エージェントは、これらのインデックスに対してクエリを実行することで、情報に基づき引用に裏付けられた応答を提供できます。詳しくは、「コンテキスト」をご覧ください。

Use files

You can upload files directly through the chat box for analysis. This enables conversational agents to process various file-based inputs seamlessly during interactions. The pre-built Analyze Attachments tool also supports file uploads and allows agents to interpret and reason over file content using large language models (LLMs).

注:

You cannot include attachments in evaluation runs. While conversations can be added to an evaluation set, attachments cannot be passed in through debug chat, traces, or manual uploads.

エスカレーションとエージェント メモリを設定する

会話型エージェントは、意思決定を向上させるために、エスカレーション ワークフローとエージェント メモリをサポートしています。

• エスカレーションにより、エージェントは、信頼度が低い場合やユーザーの意図が不明確な場合、Action Center を介して会話を人間に引き渡すことができます。会話は同期的に実行されます。つまり、エージェントはエスカレーションが解決されるまで、それ以降のすべての対話を一時停止します。
• エージェント メモリにより、エージェントは以前に解決されたエスカレーションを記憶して再利用できるため、重複が減り、効率が向上します。

詳しくは、「エスカレーションとエージェント メモリ」をご覧ください。

エージェントを評価およびテストする

評価により、会話型エージェントがさまざまな対話パスで確実に動作することを確認できます。このプロセスは自律型エージェントの評価と同様ですが、対話のために調整されています。

Select Debug to run the agent in a chat-like environment, and interact with your agent using natural language.

Expand the full execution trace, which provides real-time tracing of the agent execution. It shows details such as:

• エージェントによる LLM の呼び出しと応答
• ツールの呼び出しと、引数および最終出力

Add test cases directly from the History panel by selecting Add to evaluation set after a test run. An evaluation test is created for the conversation with:

• 会話履歴: 会話における前のターンの記録です。
• 現在のユーザー メッセージ: 会話におけるユーザーの最新のメッセージです。
• 期待されるエージェントの応答。

これにより、エージェントがどの程度適切にコンテキストを維持し、フォローアップの質問を処理しているかをテストできます。これは、優れた会話エクスペリエンスのために不可欠です。

図 2. 評価セットの作成

For each evaluation test, you can use the Conversation builder interface to edit the conversation history and the current user prompt. A similar interface lets you define and refine the expected agent response, ensuring accurate test validation.

図 3. 評価テストを編集する際の [会話ビルダー] ウィンドウ

図 4. [評価セットに追加] を選択してデバッグ チャットから会話をインポート可能

会話型エージェントにアクセスする

After you publish and deploy a conversational agent, you can interact with it through the Agents Instance Management page.

図 5. Agents のインスタンスの管理

Microsoft Teams および Slack でエージェントにアクセスする (プレビュー)

Conversational agents are available in Microsoft Teams and Slack. For details, refer to:

• Autopilot - Autopilot for Teams アプリとの 1 対 1 のチャットを使用する
• Autopilot - UiPath Autopilot™ for Slack

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

IFrame コンポーネントを使用して、会話型エージェントを UiPath アプリに直接埋め込むこともできます。

1. 作成とパブリッシュ: まず、会話型エージェントが作成され、パブリッシュされていることを確認します。

2. IFrame を追加: Studio でアプリを開き、ページに IFrame コンポーネントを追加します。

3. URL を設定: 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>"

   詳しくは、以下の表をご覧ください。

4. アプリをパブリッシュ: アプリをパブリッシュします。これで、エージェントが埋め込まれ、使用する準備が整いました。

表 2. URL パラメーター

パラメーター	Required	説明
agentId	はい	The Release ID of the published agent. To find it, navigate to Agents > Conversational agents, select "Chat now" on your agent, and copy the ID from the URL.
mode	いいえ	IFrame 内で右レールのエクスペリエンスとして最適化するには、embedded に設定します。 IFrame 内で全画面表示エクスペリエンスとして最適化するには、fullscreen に設定します。 既定では fullscreen です。
title	いいえ	チャット コンポーネントのヘッダーに表示されるタイトルです。既定ではエージェントの名前が使用されます。
welcomeTitle	いいえ	初回実行のウェルカム画面のタイトルです。既定値は空の文字列です。
welcomeDescription	いいえ	初回実行のウェルカム画面の説明です。既定値は空の文字列です。
suggestions	いいえ	ユーザー向けの初回実行時に推奨されるプロンプトの配列です。既定では空の配列 [] です。 注: To test on browser directly, wrap in one double quotes. Example: ["Hi, what can you do", "Hello, how are you"] For Apps embedding, wrap in two double quotes– you need to escape the string or else UiPath Apps will throw a validation error. For example: [""Hi, what can you do""].
showHistory	いいえ	チャット履歴パネルの表示/非表示を制御するブール値 (true または false) です。既定値は true です。