コード化されたエージェントについて

UiPath® のコード化されたエージェントは、開発者が選択した統合開発環境 (IDE) で直接コードを開発することによって構築されています。これにより、開発者はエージェントのロジック、動作、外部システムとの連携を全面的に制御できます。

UiPath SDK を使用して、このコードをパッケージ化し、標準の .nupkg パッケージとして、任意のパッケージ フィードで Orchestrator にデプロイできます。そのパッケージを使用して、1 つ以上のフォルダーにプロセスを作成できます。

コード化されたエージェントは、Orchestrator のフォルダーに UiPath プロセスとしてデプロイされます。そのプロセスをプラットフォームと連携すると、標準プロセスと同じガバナンス原則に準拠するようになります。これにより、フォルダーの中で整理したデプロイメントが実現し、エージェントの実行をスケジュール、トリガー、監視しながら、より広範なオートメーション ワークフローと連携できます。

次の図は、コード化されたエージェントを UiPath Platform で作成、デプロイ、実行するプロセスの概要を示しています。

この手順は次を含みます:

1. IDE でエージェント ロジックを定義する手順、2) セキュリティで保護して UiPath との接続を確立する手順、3) Orchestrator にエージェントをデプロイする手順、4) UiPath のエコシステムでエージェントを実行する手順で構成されます。

SDK でサポートされている言語とフレームワーク

UiPath SDK のライブラリとそれがサポートする言語とフレームワークは継続的に拡張されています。以下をサポートしています。

言語/フレームワーク	リポジトリ	機能
Python (バージョン 3.11、3.12、3.13)	uipath-python	Python SDK that features a CLI for creation, packaging, and deployment of agents to the UiPath Platform. It also enables programmatic interaction with UiPath Platform resources like processes, assets, buckets, Context Grounding, data services, jobs, and more.
LangGraph を併用する Python	uipath-python 拡張機能: uipath-langchain-python	Python SDK that enables developers to build and deploy LangGraph agents to the UiPath Platform. This package provides programmatic interaction with UiPath Platform services and human-in-the-loop through Action Center.
LLamaIndex	uipath-llamaindex-python	Python SDK that enables developers to build and deploy LlamaIndex agents to the UiPath Platform. This package provides programmatic interaction with UiPath Platform services and human-in-the-loop (HITL) semantics through Action Center integration.
OpenAI Agents	uipath-openai-agents	Python SDK that enables developers to build and deploy OpenAI Agents to the UiPath Platform. This package provides programmatic interaction with UiPath Platform services.

UiPath SDK の更新に関する最新情報については「リリース ポリシー」をご覧ください。

コード化されたエージェントの機能

SDK を使用して UiPath のリソースを連携する

UiPath SDK は、UiPath リソースをコードから直接呼び出して操作するために必要なロジックを開発者に提供します。これにより、UiPath の既存の機能と UiPath リソースをシームレスに連携できます。たとえば、UiPath のアセットを使用して機密データを安全に保管および管理すること、UiPath のストレージ バケットに保存されているデータにアクセスして操作すること、さまざまなシステムやサービスへの接続を確立して管理することができます。また、コード化されたエージェントから他の UiPath プロセスをトリガーして操作することもできます。

コード化されたエージェントで使用できる UiPath リソースの詳細については SDK のドキュメントをご覧ください。

その他の例と実装パターンについては、GitHub リポジトリ (Python、LlamaIndex) でサンプル プロジェクトをご覧ください。

コード化されたエージェントでの人間参加

エージェントに割り込みポイントを定義して、人間による入力を求めることができます。割り込みがトリガーされるとエージェントの実行が一時停止し、割り当てられたユーザーに入力が求められます。人間が入力すると、実行が再開されます。

割り込みポイントの定義方法は、エージェントの言語によって次のように異なります。

• フレームワークによっては、LangGraph のようにネイティブの割り込みパターンが用意されているものがあり、エージェントの実行に人間が介入できます。

• UiPath SDK では、割り込みロジックとして UiPath タスクを導入できます。中断がトリガーされると実行が一時停止し、Action Center にタスクが作成されます。

  • ユーザーには、エージェントの進行状況の確認、フィードバックの提供、アクション アプリを通じた意思決定や生成されたタスクに対するアクションなどが可能です。
  • 人間との対話が完了すると、エージェントは中断時の状態から実行を再開します。

コード化されたエージェントの環境変数を設定する

シークレット アセットを使用してプロジェクトに環境変数を設定できるので、コードを直接変更する必要がありません。

資格情報アセットの外部資格情報ストア (CyberArk など) と連携するための Orchestrator サポートを活用すると、CyberArk ストアにリンクし、該当のシークレット アセットをエージェントで使用するための環境変数を設定できます。実行時には、Orchestrator によってアセットを通じて CyberArk からキーが安全に取得されます。そのキーを、環境変数としてエージェントで使用できます。

Orchestrator でエージェントのプロセスに移動し、エージェントのコードで必要な API キーやランタイム パラメーターなどの各種設定値を定義して管理します。詳細については「エージェント ジョブを開始する」を参照してください。

LangSmith でのトレースとデバッグを有効にする

標準の LangSmith 環境変数 (LANGCHAIN_TRACING_V2、LANGCHAIN_API_KEY、LANGCHAIN_PROJECT など) を設定して、LangSmith でのエージェントの実行を詳しくトレースできるようにします。

この連携により、UiPath エージェントを実行するたびに、使用している LangSmith アカウントに包括的なトレースが得られます。このトレースから、エージェントの推定実行パスを分析し、デバッグとパフォーマンス最適化の対象とする領域を特定できます。