Erste Schritte

Auf dieser Seite werden Sie durch die Installation des SDK, das Erstellen eines Projekts und die lokale Ausführung Ihrer ersten Python-Funktion geführt.

Voraussetzungen

• Python 3.10 oder höher.
• Die uipath -CLI und das SDK, installiert mit pip.
• Ein UiPath-Konto mit Zugriff auf den Orchestrator (zum Veröffentlichen und Aufrufen).

Installieren Sie das SDK

pip install uipath

Überprüfen Sie die Installation:

uipath --version

Gerüst für ein Projekt

Erstellen Sie ein neues Funktionsprojekt:

uipath new my-function

Dadurch wird ein Gerüst für die von Ihnen bearbeiteten Dateien erstellt:

Datei	Zweck
main.py	Ihre Funktionslogik und die Modelle Input/Output. Startet als ausführbares Beispiel.
pyproject.toml	Projektmetadaten und Abhängigkeiten.
uipath.json	Deklariert die aufrufbaren Einstiegspunkte. Das Gerüst registriert main für Sie.

Schreiben Sie Ihre erste Funktion

Ersetzen Sie die Gerüst-Logik in main.py:

from pydantic.dataclasses import dataclass


@dataclass
class Input:
    message: str = ""


@dataclass
class Output:
    reply: str = ""


def main(input: Input) -> Output:
    return Output(reply=f"Hello, {input.message}!")

Das Gerüst für uipath.json deklariert diesen Einstiegspunkt bereits:

{
  "functions": {
    "main": "main.py:main"
  }
}

Der Schlüssel (main) ist der Name des Einstiegspunkts, der in CLI-Befehlen verwendet wird; Der Wert verweist auf die Datei und Funktion. Aktualisieren Sie sie nur, wenn Sie die Funktion umbenennen oder weitere Einstiegspunkte hinzufügen.

Generieren Sie das Projektschema

Nachdem Sie Input und Output definiert sind, generieren Sie das Schema und die Bindungen:

uipath init

Dadurch werden Ihr Code und uipath.json gelesen und Folgendes generiert:

Datei	Zweck
entry-points.json	Das von Ihren Modellen abgeleitete Eingabe-/Ausgabe-JSON-Schema wird für die Variablenbindung verwendet.
bindings.json	Ressourcenbindungsmanifest, das nur dann mit einer leeren Struktur erstellt wird, wenn die Datei nicht bereits vorhanden ist.

Führen Sie uipath init erneut aus, wenn Sie Ihre Input - oder Output -Modelle ändern. Sie generiert entry-points.json neu und ändert nie bindings.json – Ressourcenbindungen werden manuell verwaltet. Was sie tun und wie sie deklariert werden, finden Sie unter Ressourcenbindungen.

Führen Sie sie lokal aus

uipath run main '{"message": "world"}'

Lokale Ausführungen lösen Plattformressourcen über die Einträge in bindings.json auf, sodass Sie vor der Veröffentlichung mit echten Orchestrator-Assets und -Buckets testen können. Dieselben Einträge ermöglichen es, jede Ressource neu zuzuordnen, wenn das Paket in einem anderen Mandanten ausgeführt wird.

Nächste Schritte

• Erstellen Sie Python-Funktionen – typisierte Schemas, Fehlerbehandlung und mehrere Einstiegspunkte.
• Ressourcenbindungen – Deklarieren Sie die Plattformressourcen, die Ihre Funktion erreicht.
• Verpacken und Veröffentlichen – Bereitstellen im Orchestrator.