エージェントを構築する

コーディング エージェントと UiPath のスキルを使用して、LangGraph エージェントをローカルで構築、設定、実行します。

CLI をインストールし、スキルを配置し、アカウントが認証されたら、ローカル プロジェクトをスキャフォールディングする準備が整いました。

手順 4 - ローカル プロジェクトを設定する

エージェント プロジェクトの新しいフォルダーを作成し、VS Code で開きます ([ファイル] → [フォルダーを開く])。この手順以降のすべてのコマンドは、プロジェクト フォルダーのルートから実行されます。

Python 環境を作成する

サポートされている Python のバージョンにピン留めされた仮想環境を作成し、アクティブ化します。

mkdir QuestIntake
cd QuestIntake

uv venv --python 3.13
source .venv/bin/activate

注:

Windows:ではなく .venv\Scripts\activatesource .venv/bin/activateを使用してください。

注:

Python バージョン: 3.13 が PATH にない場合、 uv は Python を自動的にダウンロードして管理します。サポートされているバージョンは 3.11、3.12、3.13 です。

LangGraph 連携をインストールする

LangGraph は、ノードとエッジのグラフとしてステートフル LLM エージェントを構築するための Python フレームワークです。uipath-langchain は、UiPath Platform でのデプロイと評価のために LangGraph エージェントをパッケージ化する UiPath 統合レイヤーです。

アクティブな venv に UiPath LangGraph パッケージをインストールします。これにより、次のステップのプロジェクト スキャフォールディングにもフレームワークが利用できるようになります。

uv pip install uipath-langchain

UiPath CLI に Python を登録する

UiPath 互換の Python 実行可能ファイルが存在する場所を CLI に指示します。

uip codedagent setup --force

が表示されます "Result": "Success"。この手順は、 uip codedagent コマンドを使用する前に、マシンごとに 1 回 (および venv の変更後に) 必要です。

プロジェクトのスキャフォールディング

UiPath プロジェクトの構造を作成します。uip codedagent new インストールされているフレームワークを検出し、適切なスキャフォールディング ファイルを生成します。

uip codedagent new QuestIntake

これにより、 pyproject.toml、 main.py、 langgraph.json、 uipath.json、 entry-points.json、 bindings.json、およびコーディング エージェントのコンテキスト ファイル (AGENTS.md、 CLAUDE.md、 .agent/) が作成されます。main.pyはプレースホルダーです。手順 5 でコーディング エージェントがこれを置き換えます。

ローカルの開発サーバー依存関係を追加し、ロックファイルを同期します。

uv add uipath-dev --dev
uv sync

エントリ ポイントを生成する

init を実行して、スキャフォールド コードからエントリ ポイント スキーマを生成します。

uip codedagent init

この段階では、プロジェクトにプレースホルダーのエントリ ポイントがあります。コーディング エージェントが実際のエージェント コードを記述した後、手順 5 で init を再実行します。

---

手順 5 - コーディング エージェントでエージェントを構築する

ここで UiPath のスキルが実を結びます。コーディング エージェントを開き、エージェント ロジックを作成するようプロンプトで指示します。以下のプロンプトは簡潔で、エージェントを構築する方法ではなく、エージェントが何をすべきかを説明しています。

コーディング エージェントがインストールする uipath-agents スキルは、LangGraph の連携パターン、SDK の正しいインポート、Pydantic スキーマの規則、および遅延 LLM の初期化の要件をすでに認識しています (LLM クライアントはモジュールの読み込み時ではなく、ノード関数内で初期化する必要があります。UiPath のコンテナー ランタイムはモジュールレベルの LLM オブジェクトをサポートしていません。実用的な例については、 SDK のクイック スタート をご覧ください)。スキルがない場合は、プロンプト自体でこれらすべてを指定する必要があります。

次のプロンプトを使用します (または、ユース ケースに合わせて調整してください)。

Create a UiPath coded agent using LangGraph.

The agent is a quest intake classifier for a D&D adventurer's guild. Given a
description of an incoming quest, it classifies the difficulty as one of four tiers:
- Trivial: Simple errands anyone can handle (e.g., deliver a letter, clear rats from a cellar)
- Standard: Moderate quests requiring some skill (e.g., escort a merchant caravan)
- Heroic: Difficult quests requiring significant expertise (e.g., slay a wyvern, infiltrate a thieves' guild)
- Legendary: Extreme quests requiring top-tier heroes and special approval (e.g., defeat a lich, close a planar rift)

Return the classification tier and a brief reasoning.

Use these exact field names in the State schema:
- Input field: `description` (string)
- Output fields: `tier` (string) and `reasoning` (string)

Create a langgraph.json and an input.json with a sample D&D quest for testing.

重要:

コーディング エージェントは非決定論的です。生成されるコードは、ここに示す例とは異なります。それは予想通りです。重要なのは、 main.py がエラーなしで実行され、分類が返されることです。

注:

配信に関する質問: コーディング エージェントから「配信」に関する質問 (Studio Web、ローカル開発サーバー、またはスキップ) が提示された場合は、[ スキップ ( 今のところ完了)] を選択します。手順 9 で Studio Web に接続する

コーディングエージェントが終了したら、 init を再実行して、新しい Pydantic スキーマから更新されたエントリポイントを取得します。

uip codedagent init

エントリ ポイントが検出されたことを確認する出力が ASCII グラフ ダイアグラムとともに表示されます。

Created 'entry-points.json' file with 1 entrypoint(s).

続行する前に、pyproject.toml を開き、[[project]] にauthorsエントリがまだ存在しない場合は追加します。UiPath では、プロジェクトをパッケージ化するためにこのフィールドが必要です。

authors = [{ name = "Your Name" }]

---

エージェントをローカルで実行し、エントリ ポイントを登録したら、次のセクションでエージェントを実行して評価セットを構築する準備が整います。