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 Codierungs-Agent installiert hat, kennt bereits die LangGraph-Integrationsmuster, die korrekten SDK-Importe, die Py} dantic-Schemakonventionen und die relevanten SDK-Anforderungen. Ohne diese Fähigkeiten müssten Sie all dies im Prompt selbst angeben.

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

Update main.py to implement this UiPath coded agent using LangGraph as a single-node graph with no tools and no retry or error-handling logic.

The agent is a quest intake classifier for a fantasy 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` (a Literal type constrained to exactly "Trivial", "Standard", "Heroic", "Legendary" — not a plain string, so the model can't emit an out-of-vocabulary tier) and `reasoning` (string)

Update the existing langgraph.json to point at the new graph, and create an input.json with this exact sample quest: {"description": "Clear the rats out of the inn cellar"}.

Only touch main.py, langgraph.json, and input.json.

Don't run any uip codedagent commands or otherwise verify that the agent runs — I will do this myself.

Hinweis:

Warum dieser Prompt so spezifisch ist. Es benennt die genauen Dateien, die bearbeitet werden sollen, und weist den Codierungs-Agent an, keine uip codedagent -Befehle auszuführen oder seine eigene Arbeit zu überprüfen. Das ist hier bewusst: Der Rest dieses Experiments Führt dieselben CLI-Befehle direkt in den nächsten Schritten aus, sodass die Überprüfung Ihnen überlassen wird, anstatt dass der Codierungsagent sie zuerst ausführt.

Die obige Eingabeaufforderung ist eine gute Vorlage für den Einstieg in Ihre eigenen Projekte, aber Sie sollten die letzten beiden Sätze entfernen, damit der Codierungsagent seine Arbeit testen und Dateien nach eigenem Ermessen organisieren kann.

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.

Und beachten Sie, dass Sie, wenn Ihr Codierungs-Agent eine Frage zur „Bereitstellung“ stellt (Studio Web, lokaler Entwicklungsserver oder überspringen), Überspringen wählen – vorerst fertig . Herstellen einer Verbindung mit Studio Web in Schritt 10.

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 im nächsten Schritt ausführen.

Schritt 6 – Führen Sie den Agent lokal aus

Führen Sie den Agent mit der Beispieleingabedatei aus, die Ihr Codierungsagent erstellt hat:

uip codedagent run agent --file input.json

Sie sollten sehen, wie der Agent die Anforderung klassifiziert und eine Stufe mit Argumentation zurückgibt.

Sie können Eingaben auch inline übergeben. Diese Beispiele verwenden die Bash-Syntax für einzelne Anführungszeichen. Wenn Sie PowerShell verwenden, verwenden Sie stattdessen --file mit einer JSON-Datei:

uip codedagent run agent '{"description": "Clear the rats out of the inn cellar"}'

Versuchen Sie es mit Ihren eigenen Eingaben, um zu überprüfen, ob die Klassifizierungen sinnvoll sind, z. B.:

uip codedagent run agent '{"description": "Slay the ancient red dragon terrorizing the countryside"}'

---

Wenn der Agent korrekt klassifiziert wird, sind Sie bereit, ihm etwas zu geben, anhand dem seine Antworten überprüft werden können.