チャット エージェントをデプロイする

設計とテストが完了した後に、チャット エージェントをパブリッシュして Orchestrator にデプロイし、ユーザーが利用できるようにします。

Agent Builder で会話型エージェントを構築した場合でも、会話型の Maestro Flowを構築した場合でも、同じ手順とチャネルが適用されます。

• インスタンスの管理の [ 会話 ] タブには、パブリッシュ済みの各チャット エクスペリエンスに
  • 会話型エージェント — Agent Builder から構築した場合
  • 会話型フロー — Maestro Flow に組み込まれている場合
• 他のすべてのチャネルでは、ユーザーは両方の種類を会話型エージェントとして認識します。エンド ユーザーは、どのランタイムがチャットを提供するかを公開されないため、よりシームレスにビルド パスを切り替えることができます (たとえば、単一のプロンプトの会話型エージェントを会話型フローに段階させるなど)。

パブリッシュとデプロイは、以下の 2 つの別個の手順です。

• パブリッシュ: プロジェクトをソリューションとしてパッケージ化し、Orchestrator にアップロードします。
• デプロイ: パブリッシュしたソリューションを、必要なランタイム リソースでの実行に利用できるようにします。

Orchestrator フォルダーの要件

パブリッシュする前に、対象の Orchestrator フォルダーに必要なリソースが設定されていることを確認します。

リソース	目的	Required
サーバーレス ロボットのマシン テンプレート	会話型エージェントと特定のツールの呼び出しを実行します (クロスプラットフォーム RPA オートメーション)	常時
Unattended ロボット アカウント	エージェントが匿名で使用されている場合に実行 ID を提供します	匿名アクセスを使用してチャネル経由でエージェントにアクセスする場合
仮想マシン	Windows ベースの RPA オートメーションを実行します。	Windows オートメーションを使用する場合は必須
共有されたコネクション	ユーザーが設定した個人用コネクションが利用できない場合に、Integration Service のコネクタにアクセスできるようにします	ツールがコネクタを使用する場合は必須

重要:

インスタンスの管理でエージェントを開始できない場合は、以下の要件を確認してください。

• エージェント ソリューションが存在する正しいテナントを使用している
• サーバーレス ロボットのマシン テンプレートがソリューション フォルダーに割り当てられている
• 匿名アクセス チャネルを使用している場合、Unattended ロボット アカウントはソリューション フォルダーに割り当てられます。

実行 ID

• ユーザーの UiPath アカウントで認証する デプロイ チャネル を介して会話型エージェントにアクセスする場合、会話型エージェントはユーザーの ID で実行されます。ユーザーが自分の個人用コネクションを使用してツールを実行することを許可できます。詳しくは、「 コネクションの管理 」をご覧ください。
• 匿名アクセス権を持つデプロイ チャネルを使用する場合、会話型エージェントは、代わりにフォルダー内の Unattended ロボット アカウントの ID で実行されます。

パブリッシュ

パブリッシュすることにより、プロジェクトがソリューションとしてパッケージ化され、Orchestrator にアップロードされます。

パブリッシュの手順

1. Studio Web で、Agent Builder または Maestro Flow プロジェクトを開きます。
2. 上部のツールバーで [パブリッシュ] を選択します。
3. 対象の Orchestrator フィードを選択します (Orchestrator テナント フィードをお勧めします)。
4. (任意) 変更内容を説明する変更ログのメモを入力します。
5. [パブリッシュ] を選択します。

詳細なパブリッシュ オプションについて、「プロジェクトをパブリッシュする」をご覧ください。

デプロイ

パブリッシュ後、ソリューションをデプロイして実行に利用できるようにする必要があります。デプロイすることにより、パブリッシュしたソリューションが Orchestrator フォルダー内のランタイム リソースに関連付けられます。

デプロイの手順

1. Orchestrator に移動します。
2. パブリッシュ済みの Agent Builder または Maestro Flow ソリューションを見つけます。
3. ソリューションをデプロイ (またはアップグレード) し、必要なロボット アカウントとコネクションにアクセスできることを確認します。

デプロイが完了すると、インスタンスの管理に表示され、設定されているチャネルを介して利用できるようになります。

詳細なデプロイ オプションについては、「プロジェクトをパブリッシュする」をご覧ください。

コネクションの管理

エージェントは、設計時に使用されたものと同じコネクションにアクセスする必要があります。会話型エージェントは、管理者が構成する 共有コネクション と、個々のユーザーが構成する 個人用コネクション の 2 種類のコネクションをサポートしています。

共有されたコネクション

共有コネクションは管理者によって Orchestrator フォルダー内で構成され、エージェントのすべてのユーザーが使用できます。共有コネクションを設定するには、以下の手順を実行します。

1. Integration Service のコネクションを Orchestrator の共有フォルダー内に作成します。
2. 設計およびデバッグ時には、これらの共有されたコネクションを使用します。
3. ソリューションを同じ共有フォルダー内のサブフォルダーとしてパブリッシュします。

この設定により、ソリューションが親フォルダーのコネクションを自動的に継承するようになります。

個人用コネクション

注:

個人用コネクションはパブリック プレビューの段階です。

個人用コネクションでは、個々のユーザーが、エージェントがユーザーに代わって使用する Integration Service のコネクションを選択できます。これは、ユーザーが自分の資格情報を使用してエージェントを操作する必要がある場合に便利です。たとえば、自分のアカウントからメールを送信したり、個人の予定表にアクセスしたりする場合などです。

個人用コネクションを有効化する

個人用コネクションを機能させるには、Orchestrator の各ツール プロセスで 2 つの設定を行う必要があります。実行設定の一般的な情報については、「 実行設定をリンクする」をご覧ください。

1. Orchestrator で、エージェント ソリューションがデプロイされているフォルダーに移動し、[ プロセス ] タブを開きます。
2. コネクタを使用するツール プロセス (メールを送信する API ワークフローなど) で [ 編集 ] を選択します。
3. プロセスの設定で、[親ジョブ ID を継承するアカウント] を設定します。これにより、ツールがユーザーの個人用コネクションにアクセスするために必要なユーザーの ID でツールを実行できます。
4. コネクタのコネクションを [ ユーザーが設定可能] に設定します。これにより、ユーザーは実行時にコネクタに対して独自のコネクションを選択できます。

重要:

両方の設定が必要です。どちらの設定も行わないと、個人用コネクションはユーザーに表示されず、実行時にツールがエラーを返す可能性があります。

ユーザー エクスペリエンス

エージェントに対して個人用コネクションが有効化されている場合、以下のようになります。

• エージェントの [設定 ] パネルを開き、[ 利用可能なコネクション ] タブを選択すると、コネクションを表示および管理できます。
• 必要なコネクタ (Slack、Outlook、Salesforce など) ごとに、利用可能なコネクションを 1 つ選択するか、新しいコネクションを作成できます。
• 既定では、エージェントは、エージェントとフォルダー内の他のツールが使用するコネクタに対して、一致するコネクションをユーザーの個人用ワークスペースから自動で選択します。

エージェントは、ユーザーの個人用ワークスペースからコネクションの自動設定を試みます。ユーザーの個人用ワークスペース内のコネクタに一致するコネクションがある場合、エージェントはそのコネクションを自動的に使用します。このため、設定がシームレスになり、通常は 1 回限りのエクスペリエンスで完了します。自動設定されたコネクションが失敗した場合、または一致するコネクションが見つからない場合は、新しいコネクションを選択するか作成するよう求められます。

ユーザーがコネクタの個人用コネクションを設定していない場合、エージェントはエージェントの既定のコネクションにフォールバックします。選択した個人用コネクションは共有コネクションよりも優先され、存在する場合は常に使用されます。外部アプリケーションを使用する場合、ユーザーの個人用ワークスペースからのコネクションのみが利用可能です。共有フォルダーのコネクションは表示されません。

注:

ユーザーは、ユーザー プロファイル設定をサポートするチャネルでのみ、個人用コネクションを選択および管理できます ( 「チャネルごとに利用可能な機能」を参照)。設定が完了すると、エージェントはすべてのチャネルで個人用コネクションを使用します。

個人用コネクション用にエージェントを設計する方法については、『設計ガイド』の「 コネクションに関する考慮事項 」をご覧ください。

デプロイ チャネル

パブリッシュすると、ユーザーは複数のチャネルを通じて会話型エージェントにアクセスできるようになります。各チャネルは異なる機能を提供し、異なるユース ケースに適しています。

チャネルの概要

Channel	最適な用途	ユーザー認証
インスタンスの管理	管理者によるテスト、内部ユーザー。[会話] タブで会話型エージェント (Agent Builder) と会話型フロー (Maestro フロー) を区別するのは、このチャネルのみです。	UiPath アカウント
Assistant	内部の生産性ハブ	UiPath アカウント
Microsoft Teams	チームのコラボレーション	Microsoft アカウントと UiPath アカウント
Slack	チームのコラボレーション	Slack アカウントと UiPath アカウント
iFrame の埋め込み	サードパーティ アプリと UiPath Apps	UiPath アカウントまたは匿名
UiPath TypeScript SDK	カスタムビルド アプリケーション	アプリケーションに依存

チャネルごとに利用可能な機能

すべてのチャネルですべてのチャット機能を利用できるわけではありません。インスタンスの管理では、完全な機能セットが提供されます。他のチャネルには制限がある場合があります。

機能	インスタンスの管理	Assistant	Microsoft Teams	Slack	IFrame	TypeScript SDK*
新しいチャットを開始	✅	✅	✅	✅	✅	✅
チャット履歴	✅	✅	✅	✅	✅	✅
チャット セッションの削除	✅	✅	✅	❌	✅	✅
ユーザー プロファイルの設定	✅	✅	✅	❌	✅	✅
個人用コネクション	✅	✅	✅	❌	✅	✅
開始プロンプト	✅	✅	✅	❌	✅	✅
ファイルのアップロード	✅	✅	✅	✅	✅	✅
会話の入力**	✅	✅	✅	❌	✅	✅
ツール呼び出しの確認	✅	✅	✅	❌	✅	✅
引用	✅	✅	✅	✅	✅	✅
HTML プレビュー	✅	✅	✅	❌	✅	✅
応答のコピー	✅	✅	✅	❌	✅	✅
フィードバック (いいね/不満)	✅	✅	✅	✅	✅	✅

* すべての SDK 機能は、開発者がカスタム実装で構成できます。

** 会話入力は、 Agent Builder で構築された会話型エージェントでのみサポートされています。

チャネルを選択する

デプロイ チャネルを選択するときは、以下の要素を考慮してください。

UiPath へのアクセス権を持つ内部ユーザー

• 管理者によるテストとパワー ユーザーには、インスタンスの管理を使用します。
• Assistant は、すべてのエージェントの一元的なハブとして使用します。

チームのコラボレーション

• Teams または Slack を使用すると、チームがすでに作業している環境にエージェントを導入できます。

カスタム アプリケーション

• サードパーティ アプリまたは UiPath Apps には iFrame の埋め込みを使用します。

外部ユーザーまたは匿名ユーザー

• iFrame の埋め込みを匿名認証サーバーとともに使用します。

カスタム アプリケーション

• UiPath TypeScript SDK を使用して、独自の Web アプリケーションやポータルに会話型エージェントを統合します。

UiPath ツールを外部プラットフォームで使用する

MCP (モデル コンテキスト プロトコル) ツールを使用して、UiPath の機能 (オートメーション、ワークフロー、ドキュメント処理) を外部のチャット プラットフォーム (ChatGPT や Microsoft Copilot Studio など) に公開できます。このアプローチでは、会話型エージェントではなく直接のツール呼び出しを使用します。

MCP との連携について詳しくは、「MCP サーバー」をご覧ください。

次のステップ

設定と構成について学ぶためのチャネルを選択する

• インスタンスの管理
• Assistant
• Microsoft Teams
• Slack
• IFrame と Apps の埋め込み
• UiPath TypeScript SDK