Coding Agents を使用して、コード化されたエージェントを構築する

Python ベースのコード化されたエージェントを、コーディング エージェントとターミナルから完全に UiPath Orchestrator にスキャフォールディング、記述、パッケージ化して UiPath Orchestrator にパブリッシュします。

uipath-agents スキルをインストールしたコーディング エージェントは、Python ベースのエージェントをターミナルから完全に実行、記述、パッケージ化、UiPath Orchestrator へのパブリッシュを行うことができます。コード化されたエージェントは、LangGraph、LlamaIndex、または OpenAI エージェントで構築された標準の Python プロジェクトであり、エージェントのデプロイ後、UiPath がオーケストレーション、スケジュール設定、エスカレーション、ガバナンスを処理します。

セットアップ (エージェントのインストール、ログイン、スキルのインストール) については、「 インストールとセットアップ」をご覧ください。

uip codedagent コマンドの完全なリファレンスについては、『UiPath CLI ガイド』をご覧ください。

前提条件

• コーディング エージェントにインストールされている uipath-agents スキル。詳しくは、「 インストールとセットアップ」をご覧ください。
• ログイン中のセッション (uip login) です。
• Python 3.11 以降。
• uv パッケージ マネージャー。

エージェントでできること

領域	エージェントでできること	質問の例
プロジェクトを初期化する	を使用して新しい Python プロジェクトを作成し uv任意の UiPath SDK パッケージを追加し、 uip codedagent setup と uip codedagent new を実行してプロジェクト構造を構成します	「invoice-processor という新しいコード化されたエージェント プロジェクトを初期化してください。」
エージェント ロジックを記述する	LangGraph、LlamaIndex、または OpenAI エージェントを使用して、Python エージェントのコードを記述して反復処理する	「UiPath コンテキスト グラウンディングのインデックスを呼び出して企業ポリシーを確認するツールを追加してください」
設定	uip codedagent initを実行して、Python プロジェクトを UiPath のオーケストレーション レイヤーに接続します	「UiPath Orchestrator 用にエージェントを設定してください」
パッケージ	uip codedagent packを実行して、エージェントをデプロイ可能な成果物としてバンドルします	「エージェントをパッケージ化してください。」
公開	uip codedagent publishを実行してパッケージを Orchestrator にアップロードし、プロセスを自動作成します	「エージェントを個人用ワークスペースにパブリッシュしてください。」
Studio Web と同期	ローカル ファイルをリモートの Studio Web プロジェクトにアップロードするには uip codedagent push を実行し、リモート プロジェクトからローカル ワークスペースにすべてのファイルをダウンロードするには uip codedagent pull を実行します	「ローカルの変更を Studio Web にプッシュしてください。」

ビルド ループ

コーディング エージェントは、コード化されたエージェントを構築または反復処理する際に、次のサイクルに従います。

パッケージ>初期化>書き込み>評価 > Studio Web と同期 (任意) > [パブリッシュ] > [実行] >環境変数を設定する

1. 初期化 — 新しい Python プロジェクトを作成し、UiPath SDK を追加して、プロジェクト構造を素早く設定します。

   mkdir my-agent && cd my-agent
   uv init
   uv add uipath-langchain   # or uipath-llamaindex / uipath-openai-agents
   uip codedagent setup
   uip codedagent new my-agent
   uip login
   uip codedagent init
   

2. 書き込み — コーディング エージェントに Python エージェント ロジックの記述と編集を依頼します。コード化されたエージェントは標準の Python であり、UiPath 固有の機能に限定されません。

3. 評価 — パブリッシュする前にエージェントをテストします。

   • 分析 — コーディング エージェントに、テスト セットの設定と実行、スコアの説明を依頼します。

   • 反復処理 — 結果が正しく見えるまでプロンプトまたはロジックを調整します。

4. パッケージ化 — デプロイ可能な成果物を作成するために、 uip codedagent pack を使用してエージェントをパッケージ化します。

5. Studio Web と同期 (任意) — Studio Web でさらに変更を加える場合は、以下の手順を実行します。

   • プッシュ — uip codedagent push を実行して、ローカル ファイルをリモートの Studio Web プロジェクトにアップロードします。
   • プル — uip codedagent pull を実行して、リモートの Studio Web プロジェクトからすべてのファイルをローカル ワークスペースにダウンロードします。

6. パブリッシュ — パッケージを Orchestrator にアップロードする uip codedagent publish --my-workspace でエージェントをパブリッシュします。プロセスは、初回パブリッシュ時に個人用ワークスペース内に自動作成されます。

7. 環境変数を設定する — Orchestrator でプロセスの設定を開き、必要な環境変数 (API キー、接続文字列) を追加します。

8. 実行 — ジョブを開始します。

結果: エージェントが Orchestrator にデプロイされ、プロセスとして実行されます。スケジュール設定、リトライ、ログ記録は UiPath が処理します。

SDK パッケージ

エージェントのフレームワークに合ったパッケージを選択します。

パッケージ	フレームワーク
uipath-langchain	LangChain / LangGraph
uipath-llamaindex	LLamaIndex
uipath-openai-agents	OpenAI Agents

3 つのパッケージはすべて、フレームワークネイティブの抽象化を通じて、同じ UiPath の機能 (コンテキスト グラウンディング、人間参加型のエスカレーション、ガードレール、ジョブの添付ファイル) を公開します。

ビルド例

コーディング エージェントを開き、構築するエージェントの説明を入力します。コード化されたエージェントは標準の Python であるため、要求できる内容に制限はありません。UiPath SDK は、オーケストレーション、ガバナンス、プラットフォームとの連携をさらに追加します。

何を尋ねるか	構築されるもの
「トピックを調査して要約レポートを生成するコード化されたエージェントを作成してください」	LLM 呼び出しを使用したエージェントの調査
「入力として指定された CSV ファイルを分析するコード化されたエージェントを構築してください。」	ジョブの添付ファイルを入力として受け取るようにエージェントが接続されている
「UiPath のコンテキスト グラウンディングのインデックスを使用して会社のポリシーを確認するコード化されたエージェントを作成してください」	UiPath コンテキスト グラウンディングのインデックスに対する RAG (検索拡張生成) パイプライン

サンプル

次のリポジトリには、参照実装が含まれています。

• UiPath LangChain のサンプル — ガードレール、人間参加型、分散エージェント、会話型エージェントをカバーする 20+ のサンプル。
• LlamaIndex のサンプル — LlamaIndex の UiPath 連携パターンです。
• OpenAI Agents のサンプル — OpenAI エージェント用の UiPath 連携パターンです。

参照

• インストールとセットアップ — エージェントの設定とスキルをインストールします。
• コーディング エージェントを使用したローコード エージェントの構築 — コーディング エージェントから Agent Builder エージェントを構築します。
• UiPath Python SDK ドキュメント — コード化されたエージェントの完全な SDK リファレンスです。