Erstellen Sie den Agent

Verwenden Sie Ihren Codierungs-Agent und Ihre UiPath-Fähigkeiten, um einen LangGraph-Agent lokal zu erstellen, zu konfigurieren und auszuführen.

Wenn die CLI installiert ist, die Fähigkeiten vorhanden sind und Ihr Konto authentifiziert wurde, können Sie ein Gerüst für das lokale Projekt erstellen.

Schritt 4 – Einrichten des lokalen Projekts

Erstellen Sie einen neuen Ordner für Ihr Agent-Projekt und öffnen Sie es in VS Code (Datei → Ordner öffnen). Alle Befehle ab diesem Schritt werden vom Stamm des Projektordners aus ausgeführt.

Erstellen Sie die Python-Umgebung

Erstellen Sie eine virtuelle Umgebung, die an eine unterstützte Python-Version angeheftet ist, und aktivieren Sie sie:

mkdir QuestIntake
cd QuestIntake

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

Hinweis:

Windows: Verwenden Sie .venv\Scripts\activate anstelle von source .venv/bin/activate.

Hinweis:

Python-Version: uv lädt Python automatisch herunter und verwaltet es, wenn sich 3.13 nicht auf Ihrem PATH befindet. Unterstützte Versionen sind 3.11, 3.12 und 3.13.

Installieren Sie die LangGraph-Integration

LangGraph ist ein Python-Framework zum Erstellen von statusbezogenen LLM-Agents als Diagramme von Knoten und Kanten. uipath-langchain ist die UiPath-Integrationsebene, die einen LangGraph-Agent für die Bereitstellung und Auswertung auf der UiPath-Plattform verpackt.

Installieren Sie das UiPath LangGraph-Paket in der aktiven Anwendung. Dadurch wird der Framework auch für die Projektgerüst im nächsten Schritt verfügbar:

uv pip install uipath-langchain

Registrieren Sie Python mit der UiPath CLI

Teilen Sie der CLI mit, in welcher sich die UiPath-kompatible ausführbare Python-Datei befindet:

uip codedagent setup --force

Sie sollten "Result": "Success" sehen. Dieser Schritt ist einmal pro Maschine (und nach env-Änderungen) erforderlich, bevor uip codedagent -Befehle verwendet werden.

Gerüst für das Projekt

Erstellen Sie die UiPath-Projektstruktur. uip codedagent new erkennt das installierte Framework und generiert die richtigen Gerüst-Dateien:

uip codedagent new QuestIntake

Dadurch werden pyproject.toml, main.py, langgraph.json, uipath.json, entry-points.json, bindings.json und Codierungsagent-Kontextdateien (AGENTS.md, CLAUDE.md, .agent/) erstellt. main.py ist ein Platzhalter; Ihr Codierungsagent ersetzt ihn in Schritt 5.

Fügen Sie die lokale Entwicklungsserver-Abhängigkeit hinzu und synchronisieren Sie die Sperrdatei:

uv add uipath-dev --dev
uv sync

Einstiegspunkte generieren

Führen Sie init aus, um die Einstiegspunktschemas aus dem Gerüst-Code zu generieren:

uip codedagent init

Das Projekt hat zu dieser Phase einen Platzhalter-Einstiegspunkt. Führen Sie init in Schritt 5 erneut aus, nachdem Ihr Codierungs-Agent den echten Agent-Code geschrieben hat.

---

Schritt 5 – Erstellen Sie den Agent mit Ihrem Codierungsagent

Hier zahlen sich die UiPath-Fähigkeiten aus. Öffnen Sie Ihren Codierungs-Agent und fordern Sie ihn auf, die Agent-Logik zu erstellen. Der folgende Prompt ist kurz: Es wird beschrieben, was der Agent tun soll, nicht wie er erstellt wird.

Die uipath-agents -Fähigkeit, die Ihr Codierungsagent installiert hat, kennt bereits die LangGraph-Integrationsmuster, korrekte SDK-Importe, Pydantic Schemakonventionen und die Anforderung an die verzögerte LLM-Initialisierung (der LLM-Client muss innerhalb der Knotenfunktion initialisiert werden, nicht zur Ladezeit des Moduls – UiPath). Die Container-Runtime unterstützt keine LLM-Objekte auf Modulebene; ein funktionierendes Beispiel finden Sie im SDK-Schnellstart ). Ohne Fähigkeiten müssten Sie all dies in der Eingabeaufforderung selbst angeben.

Verwenden Sie folgenden Prompt (oder passen Sie ihn an Ihren Anwendungsfall an):

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.

Wichtig:

Codierungs-Agents sind nicht-deterministisch. Ihr generierter Code wird sich von allen hier gezeigten Beispielen unterscheiden; das erwartet wird. Wichtig ist, dass main.py ohne Fehler ausgeführt wird und eine Klassifizierung zurückgibt.

Hinweis:

Bereitstellungsfrage: Wenn Ihr Codierungsagent eine Bereitstellungsfrage stellt (Studio Web, lokaler Entwicklungsserver oder Skip), wählen Sie Überspringen – vorerst aus . Herstellen einer Verbindung mit Studio Web in Schritt 9.

Sobald der Codierungs-Agent fertig gestellt ist, führen Sie init erneut aus, um die aktualisierten Einstiegspunkte aus den neuen Pydantic-Schemas zu übernehmen:

uip codedagent init

Sie sollten eine Ausgabe sehen, die bestätigt, dass der Einstiegspunkt erkannt wurde, zusammen mit einem ASCII-Diagramm:

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

Bevor Sie fortfahren, öffnen Sie pyproject.toml und fügen Sie einen authors -Eintrag unter [project] hinzu, falls noch kein Eintrag vorhanden ist. UiPath benötigt dieses Feld, um das Projekt zu verpacken:

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

---

Wenn der Agent lokal ausgeführt wird und die Einstiegspunkte registriert sind, können Sie ihn ausführen und im nächsten Abschnitt einen Auswertungssatz erstellen.