- 基本情報
- Studio Web での UiPath Agents
- UiPath のコード化されたエージェント

Agents ガイド
制限事項とよくある質問
このページでは、会話型エージェントの現在の制限事項について説明し、よくある質問への回答を示します。
現在の制限事項
UiPath では、新しい機能を追加して積極的に製品を拡張しています。以下の表は、今後のリリースで対処される予定の、現在の制限事項の概要を示しています。
| 制限事項 | 説明 |
|---|---|
| ローカルのデスクトップ オートメーション | エージェントは、Assistant を介してユーザーのローカル デスクトップでオートメーションを実行することはできません。 |
| 個人用コネクション | 利用可能なのは、共有の Integration Service コネクションのみです。個人用コネクションはサポートされていません。 |
| ツールの確認 | エージェントは、ツールを実行する前にユーザーの確認を求めません。 |
| PII のマスク | PII の検出とマスクは利用できません。 |
| プロンプト インジェクション ガードレール | プロンプト インジェクション用のエージェント レベルのガードレールは利用できません。 |
| ファイル サイズ | アップロードできるファイル サイズは 5 MB に制限されています。 |
| 音声でのやり取り | やり取りはテキストのみです。プッシュツートークと双方向の音声は利用できません。 |
| IVR 連携 | 音声応答の対話型連携は利用できません。 |
チャネル機能の利用可否
すべてのデプロイ チャネルですべての機能を利用できるわけではありません。すべての機能の比較については、「会話型エージェントをデプロイする」をご覧ください。
主な違い:
| 機能 | 使用可 | 使用不可 |
|---|---|---|
| 開始プロンプト | インスタンスの管理、iFrame | Autopilot for Everyone、Teams、Slack |
| HTML プレビュー | インスタンスの管理、iFrame | Autopilot for Everyone、Teams、Slack |
| ファイルのアップロード | インスタンスの管理、Autopilot for Everyone、iFrame | Teams、Slack |
| 引用 | インスタンスの管理、Autopilot for Everyone、Teams、Slack | IFrame |
| デバッグ ダンプ | インスタンスの管理、Autopilot for Everyone | Teams、Slack、iFrame |
その他のチャネル制限:
- Teams および Slack: ダイレクト メッセージのみがサポートされています。チャンネル ディスカッションと @メンションは利用できません。
- 引用プレビュー: PDF ドキュメントでのみ利用できます。
よくある質問
会話型エージェントの概要
会話型エージェントは自律型エージェントとどう違うのですか?
会話型エージェントは、ユーザーとの複数ターンの相互の対話用に設計されています。自律型エージェントは、単一のプロンプトからのタスクを実行します。シナリオで継続的な明確化、パーソナライズされたガイダンス、またはリアルタイムのインタラクションが必要な場合は、会話型エージェントを使用します。
詳細な比較については、「会話型エージェント」をご覧ください。
会話型エージェントは Autopilot for Everyone とどのように関連していますか?
これらは並行して機能します。
- Autopilot for Everyone: 生産性を高めるタスクのための UiPath の汎用アシスタントです。
- 会話型エージェント: 特定のユース ケース向けに構築する特殊なエージェントです。
Autopilot for Everyone から会話型エージェントにアクセスできるため、Autopilot for Everyone は会話に関するあらゆるニーズに対応する一元的なハブとなります。
ライセンスと消費
無料アクションはどのようにカウントされますか?
無料アクションはユーザーごとにカウントされ、ユーザー間でプールされることはありません。ユーザーごとに、ライセンスの種類に基づいた個別の無料割り当てがあります。
- Express: 1 年あたり 50 件の無料アクション
- Basic: 1 か月あたり 50 件の無料アクション
- Plus/Pro: 無制限 (公正利用の範囲内)
ユーザー A が 20 件のメッセージを送信し、ユーザー B が 80 件のメッセージを送信した場合、ユーザー A には 30 件の無料メッセージが残り、ユーザー B は無料利用枠を超えていることになります。
ツールの呼び出しには追加料金がかかりますか?
一部のツールでは、基本アクション コスト以外に追加で費用がかかります。
- 追加費用なし: コンテキスト グラウンディング (セマンティック検索)、Integration Service のコネクタ、MCP ツール
詳しくは、「会話型エージェントのライセンス」をご覧ください。
何がアクションとしてカウントされますか?
1 つのアクションは、会話型エージェントに送信される 1 つのユーザー メッセージに相当します。そのメッセージから生成されたエージェントの応答の数は関係ありません。ツールを実行しない 8 文字以下のメッセージはカウントされません。
モデルと設定
独自の LLM を使用できますか?
はい。会話型エージェントは LLM の設定をサポートしているため、ユーザーは独自の LLM サブスクリプションを使用できます。この機能はプレビュー版です。プレビュー期間中は、メッセージごとに課金されることはありませんが、特定のツールの使用に対しては、追加で消費されます。
ユーザーがアップロードできるファイルの種類は何ですか?
ファイルのアップロードを有効化するには、ファイル分析ツール (ファイルを分析、IXP、またはカスタム ワークフロー) を追加する必要があります。サポートされている種類は以下のとおりです。
- 画像: GIF、JPE、JPEG、PNG、WEBP
- ドキュメント: PDF (5 MB 未満)
デプロイとアクセス
会話型エージェントがインスタンスの管理で開始に失敗するのはなぜですか?
以下を確認します。
- Unattended ロボット アカウントがソリューション フォルダーに割り当てられていることを確認します。
- エージェント ソリューションが存在する正しいテナントを使用していることを確認します。
- クロスプラットフォーム RPA ツールを使用している場合は、サーバーレス ロボットが割り当てられていることを確認します。
ツールの実行時に接続エラーが発生するのはなぜですか?
エージェントは、設計時に使用されたものと同じコネクションにアクセスする必要があります。
- Integration Service のコネクションを Orchestrator の共有フォルダー内に作成します。
- 設計およびデバッグ時には、共有されたコネクションを使用します。
- ソリューションを同じ共有フォルダー内のサブフォルダーとしてパブリッシュします。
これにより、ソリューションが親フォルダーのコネクションを自動的に継承するようになります。
特定の会話型エージェントにアクセスできるユーザーを制限するにはどうすればよいですか?
ユーザーのアクセスは、Orchestrator のフォルダーの権限によって制御されます。ユーザーには、エージェント ソリューションを含むフォルダーに対する適切な権限が必要です。管理ポータルでフォルダーへのアクセス権を設定してください。
埋め込みと連携
会話型エージェントをアプリケーションに埋め込むにはどうすればよいですか?
iFrame を使用して埋め込みます。URL の構築とパラメーターについては、「IFrame と Apps の埋め込み」をご覧ください。
UiPath のアカウントを持たないユーザー向けのエージェントを埋め込むことはできますか?
はい。外部ユーザー用のエージェントを埋め込むには、匿名アクセスを使用します。これには、外部アプリケーションとトークン エンドポイントの設定が必要です。匿名ユーザーは、無料利用枠なしでテナントのユニット プールから消費します。
チャネル固有の問題
API 経由で会話型エージェントにアクセスできますか?
現在、公開されている UiPath TypeScript SDK へのオンボーディングに取り組んでおり、利用可能になり次第、アクセスを提供する予定です。
Teams、Slack、Autopilot for Everyone に開始プロンプトが表示されないのはなぜですか?
開始プロンプトは、インスタンスの管理と iFrame の埋め込みでのみサポートされています。プラットフォームの制限により、他のチャネルではこれらのプロンプトは伝搬されません。
エージェントは Slack チャンネルまたは Teams チャネルで応答できますか?
いいえ。会話型エージェントは、UiPath Autopilot プラグインを介したダイレクト メッセージのみをサポートします。チャンネル ディスカッションと @メンションはサポートされていません。
Teams や Slack で HTML プレビューが表示されないのはなぜですか?
HTML プレビューは、インスタンスの管理と iFrame の埋め込みでのみ利用できます。他のチャネルでは、HTML コンテンツは生のテキストまたはマークダウンとして表示されます。
Teams で会話を作成できないのはなぜですか?
会話の開始に失敗する場合は、以下を確認します。
- エージェントがパブリッシュされ、Orchestrator にデプロイされていることを確認します。
- Teams アプリが UiPath アカウントに接続されていることを確認します。
- [ログアウト] コマンドを使用し、再接続してセッションを更新します。
- [Switch Agent] コマンドを使用して、エージェントが使用可能であることを確認します。
コンテキスト グラウンディング
エージェントがコンテキスト グラウンディングのインデックスを見つけられないのはなぜですか?
「インデックスが見つかりません。」というエラーが表示される場合は、以下を確認します。
- インデックスが存在し、「準備完了」ステートであることを確認します。
- エージェントがインデックスを含むフォルダーにアクセスできることを確認します。
- 設定した後にインデックスが移動または削除されていないことを確認します。
- インデックスを変更したら、エージェントを再パブリッシュします。
引用が間違っている、または欠落しているのはなぜですか?
引用の質は以下に依存します。
- インデックスの品質: ソース ドキュメントが適切に構成されていることを確認します
- チャンク サイズ: チャンクが非常に大きい、または小さい場合は、引用の精度に影響します
- クエリの関連度: あいまいなクエリでは、関連度の低いコンテンツが取得される可能性があります
注: 引用プレビューは PDF ドキュメントでのみ利用可能です。
パフォーマンス
応答時間に影響する要因は何ですか?
遅延にはいくつかの要因が影響します。
- モデルの選択: モデルが異なれば、遅延特性も異なります
- コンテキスト ウィンドウのサイズ: 会話履歴が大きいほど処理時間が長くなります
- ツールの実行: RPA ワークフローと API 呼び出しによって実行時間が長くなります
- コンテキスト グラウンディング: RAG 検索では、インデックスのサイズに基づいて遅延が追加されます
最適化するには、以下を実行します。
- API のみの操作には、RPA の代わりに API ワークフローを使用します。
- 会話のコンテキストのフォーカスを維持します。
- 遅延要件に適したモデルを選択します。
コンプライアンスとガバナンス
LLM の呼び出しとエージェントの動作を監査するにはどうすればよいですか?
AI Trust Layer は、完全な監査証跡を提供します。管理ポータルから監査ログにアクセスすることで、以下が可能です。
- 完全なモデルの対話履歴の確認。
- トークン使用状況の追跡。
- ポリシー コンプライアンスの検証。
詳しくは、「会話型エージェントのオブザーバビリティ」をご覧ください。
データ ストレージ
チャット履歴はどこに保存されますか?
チャット履歴は、テナントを対象範囲とした Azure データベースに保存されます。ユーザーは、使用する権限を持つエージェントのチャット履歴にのみアクセスできます。
アップロードされたファイルはどこに保存されますか?
アップロードされたファイルは、Orchestrator のシステム ストレージ バケットを介して Azure BLOB ストレージに保存されます。ストレージの範囲はテナントとリージョンになります。
アップロードされたファイルはどれだけの期間保持されますか?
ファイルは Orchestrator の保持ポリシーに従い、既定では、ジョブが非アクティブと見なされてから 30 日間に設定されます。この保持期間は、Orchestrator の設定で設定できます。
カスタマイズ
ウェルカム メッセージをカスタマイズすることはできますか?
iFrame を使用して埋め込む場合は、welcomeTitle、welcomeDescription、および suggestions の URL パラメーターを使用します。詳しくは、「IFrame と Apps の埋め込み」をご覧ください。
インスタンスの管理の場合は、エージェントで構成された設定がウェルカム エクスペリエンスで使用されます。
ヘルプ
ここに記載されていない問題が発生した場合は、以下をご確認ください。
- エージェントのトレースでデバッグ情報を確認します。
- デバッグ ダンプ機能 (インスタンスの管理で Ctrl+Alt+D) を使用して、診断情報を取得します。
- デバッグ ダンプと関連するトレース情報を用意して UiPath サポートにお問い合わせください。