はじめに

UiPath CLI とコーディング エージェントのスキルを使用して、コード化された LangGraph エージェントを構築、評価、パブリッシュします。

このラボでは、UiPath CLI とコーディング エージェントのスキルをインストールしてから、コーディング エージェントを使用して LangGraph エージェントを構築、実行、評価します。次の操作を行います。

1. UiPath CLI とコーディング エージェントのスキルをインストールします。
2. ローカル プロジェクトをスキャフォールディングし、スキルに基づいて LangGraph エージェントを構築します。
3. Add a live external lookup tool to the agent.
4. エージェントをローカルで実行して評価します。
5. プロジェクトを UiPath Studio Web に接続し、最初のバージョンをプッシュします。

最終的には、UiPath のスキルに従ってコーディング エージェントを使用して動作する LangGraph エージェントを構築し、評価のトレースを Studio Web に送信できるようになります。

There are three approaches to create UiPath agents. This uses the LangGraph SDK; you can also create agents using the low-code Agent Builder and using the UiPath CLI.

推定時間: 45 分から 60 分

構築する内容

This lab walks you through building a quest intake classifier for a fictional adventurer's guild: a coded LangGraph agent that reads a quest description and sorts it into one of four difficulty tiers.

It starts as a simple, single-node classifier so the focus stays on the CLI workflow, not the domain logic. Then you give it a tool so it can check its answer against a live external API before finalizing a tier, instead of guessing from vibes alone.

構築しているものの完全なデザインは次のとおりです。

コンポーネント	詳細
入力: description	string; the incoming quest description
出力: tier	A Literal type constrained to exactly "Trivial", "Standard", "Heroic", or "Legendary", not a plain string, so the model cannot emit an out-of-vocabulary tier
出力: reasoning	string; the agent's explanation for the tier it chose
Tool: get_challenge_rating	A LangGraph tool, called only when a quest names or implies a specific creature, that looks up its challenge rating from the Open5e System Reference Document (SRD) API and cites it in the reasoning

注:

Why add a tool at all? A driving reason to run a LangGraph agent on UiPath, instead of a low-code agent, is complex Python logic that can call out to external systems, not just classify text. The tool step in this lab demonstrates that: the agent decides at runtime whether a quest needs verification, calls a live API, and reasons over the result.

---

前提条件

• CLI version - validated against UiPath CLI v1.201.0 (installed in Step 1). Different versions may behave differently; report drift with uip feedback send.
• UiPath アカウント - 開始する前に UiPath Automation Cloud に登録またはログインしてください。
• Node.js 18+ - UiPath CLI をインストールするために必要です。node --versionで確認します。必要に応じて nodejs.org からダウンロードします。
• VS Code とコーディング エージェント (Claude Code、Copilot、または Cursor)。ラボの指示では Claude Code を使用しますが、サポートされている任意のコーディング エージェントで機能します。
• Bash ターミナル - このラボのコマンドでは、Bash 構文を使用します。VS Code で新しいターミナルを開き、ターミナルの種類として [Git Bash ] (または同等のもの) を選択します。PowerShell と CMD の構文が異なるため、予期しないエラーが発生する可能性があります。
• uv - 高速な Python パッケージ マネージャー。以下を使用してインストールします。

  pip install uv
  

  その他のオプションについては、 UV インストールのドキュメント を参照してください。
• 管理者権限 - グローバルな npm パッケージと Python 依存関係をインストールするには、管理者/管理者特権が必要です。制限のある仕事用ノート PC を使用している場合は、開始する前にパッケージをインストールできるか、事前に IT チームに相談してください。

このラボには、UiPath に関する既存の知識は必要ありませんが、このラボを迅速に進めることができます。

---

注:

このラボの 2 つの「エージェント」「コード化されたエージェント」とは、プラットフォームにデプロイされた Python エージェントを指す UiPath の用語です。このラボでは、LangGraph SDK を使用して 1 つを構築します。ラボの指示では、Python コードの記述を支援するために、お使いの「コーディング エージェント」(Claude Code、Copilot、Cursor) も参照します。

When the instructions say "ask your coding agent," they mean your integrated development environment (IDE) assistant; when they say "run the agent" or "your LangGraph agent," they mean the UiPath agent being built.