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

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

How coded agents work

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

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

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

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

1. Defining the agent logic in an IDE.
2. Establishing a secure connection to UiPath.
3. Deploying the agent to Orchestrator.
4. Executing the agent within the UiPath ecosystem.

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

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

言語/フレームワーク	リポジトリ	機能
Python (バージョン 3.11、3.12、3.13)	uipath-python	エージェントの作成、パッケージ化、UiPath Platform へのデプロイで使用する CLI を備えた Python SDK。 また、UiPath Platform の各種リソースをプログラムで操作することもできます。このようなリソースとして、プロセス、アセット、バケット、コンテキスト グラウンディング、データ サービス、ジョブなどがあります。
LangGraph を併用する Python	uipath-python 拡張機能: uipath-langchain-python	開発者が LangGraph エージェントを構築して UiPath Platform にデプロイできるようにする Python SDK。 このパッケージは、UiPath Platform サービスとのプログラムによる対話機能、および Action Center を通じた人間参加型の対話機能を提供します。
LLamaIndex	uipath-llamaindex-python	開発者が LlamaIndex エージェントを構築して UiPath Platform にデプロイできるようにする Python SDK。このパッケージは、UiPath Platform サービスとのプログラムによる対話機能、および Action Center との連携を通じた人間参加型 (HITL) のセマンティクスによる対話機能を提供します。
OpenAI Agents	uipath-openai-agents	開発者が OpenAI エージェントを構築して UiPath Platform にデプロイできるようにする Python SDK。このパッケージは、UiPath Platform サービスとのプログラムによる対話機能を提供します。

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

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

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

UiPath SDKs provide the logic to invoke and interact with other UiPath resources directly within your code, enabling seamless integration with existing UiPath functionalities. For example, you can:

• Use UiPath assets for secure storage and management of sensitive data.
• Access and manipulate data stored in UiPath storage buckets.
• Establish and manage connections to various systems and services.
• Trigger and interact with other UiPath processes from within the coded agent.

コード化されたエージェントで使用できる 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 アカウントに包括的なトレースが得られます。このトレースから、エージェントの推定実行パスを分析し、デバッグとパフォーマンス最適化の対象とする領域を特定できます。