UIP-Kontextgrundlage

Syntax und Optionen für `uip context-grounding`, eine Brücke zur Python UiPath CLI für Kontextgrundlagenvorgänge.

uip context-grounding ist eine Thin Bridge zu den Kontextgrundlagenvorgängen des Python-basierten UiPath SDK. Es erkennt einen geeigneten Python-Interpreter, bestätigt, dass das Python-Paket uipath installiert ist, und leitet alles andere als uipath context-grounding <args> an die Python-CLI weiter – dieses Tool definiert keine nativen Unterbefehle über setup hinaus.

Im Gegensatz zu uip codedagent, das nur eine feste weiße Liste von Unterbefehlsnamen weiterleitet, leitet context-grounding-tool jeden nicht erkannten Befehl weiter – hier gibt es keine Zulassungsliste, die konsultiert werden muss, bevor ein neues Python-Seiten-Verb funktioniert.

Unter Tools (Plugins) erfahren Sie, wie sich Thin-Wrapper von vollständigen Tools unterscheiden.

Zusammenfassung

uip context-grounding setup [--force]
uip context-grounding <any-command> [args...]
uip context-grounding help
uip context-grounding

setup und jeder weitergeleitete Befehl berücksichtigen die globalen Optionen (--output, --output-filter, --log-level, --log-file). Austrittscodes folgen dem Standardvertrag.

Einrichtung der Kontextgrundlage

Erkennen Sie Python und stellen Sie sicher, dass das uipath -Paket installiert ist. Die Ergebnisse werden in einer Datei pro Benutzer zwischengespeichert, sodass nachfolgende context-grounding -Befehle die Python-Binärdatei sofort auflösen können.

Argumente

Keine.

Optionen

• --force – Die Erkennung wird erneut ausgeführt, auch wenn ein zwischengespeichertes Ergebnis vorhanden ist.

Beispiele

uip context-grounding setup
uip context-grounding setup --force

Datenform (--output json)

{
  "Code": "ContextGroundingSetup",
  "Data": {
    "PythonPath": "/usr/bin/python3.11",
    "Package": "uipath",
    "PackageInstalled": "Yes",
    "PackageVersion": "1.0.0"
  }
}

Umgebungsprüfungen

• Zulässige Python-Versionen werden über die Umgebungsvariable PYTHON_TOOL_PYTHON_VERSIONS konfiguriert. Eine leere Liste löst Failure zur Einrichtungszeit aus.
• Wenn ein .venv -Verzeichnis im aktuellen Arbeitsverzeichnis vorhanden ist, aber keine virtuelle Umgebung aktiviert ist, verweigert das Setup die Ausführung und schlägt vor, es zuerst zu aktivieren (.venv\Scripts\activate unter Windows, source .venv/bin/activate an anderer Stelle).

Weitergeleitete Befehle

Jeder Unterbefehl, der nicht setup oder help ist, wird als uipath an die Python-CLI weitergeleitet uipath context-grounding <args> – es gibt keine feste weiße Liste, gegen die geprüft werden kann; Ein brandneues Verb, das das Python-Paket morgen hinzufügt, funktioniert hier heute, mit einer Ausnahme:

Hinweis:

auth ist blockiert. Der Aufruf uip context-grounding auth ... schlägt sofort mit Result: ValidationError (Exitcode 3) fehl und der Meldung „‚uip Login‘ für Authentifizierung verwenden.“ – es sei denn, Sie übergeben --force, wodurch dieser eine Filter umgangen wird und der auth -Aufruf an Python durchgeführt wird. Dies ist das Gegenstück der Auswirkung von --force auf uip codedagent, bei der --force immer im Hintergrund entfernt wird und Python nie erreicht – hier ist es ein echtes, wenn schmales Escape-Hook.

Beispiele

# Hand off to the Python CLI's index command
uip context-grounding index ./my-index

# Search a context grounding index
uip context-grounding search "invoice total" --index my-index

# Blocked without --force
uip context-grounding auth login
# Result: ValidationError — "Use 'uip login' for authentication."

# Bypasses the auth filter
uip context-grounding auth login --force

Hinweis:

Da weitergeleitete Befehle durch das uipath -Python-Paket definiert sind, entsprechen ihre Flags und Ausgabeform dem, was dieses Paket ausgibt – nicht der standardmäßige Code/Data -Umschlag der CLI. Behandeln Sie die CLI hier als Transport. Führen Sie für die Argumentoberfläche uip context-grounding <command> --help aus.

Ausgabeformat-Relay: Wenn das globale --output json ist, fügt die CLI --format json automatisch an den weitergeleiteten Befehl an (wird bei --help -Aufrufen übersprungen oder wenn die weitergeleiteten Argumente bereits --format enthalten) – die Python-CLI muss --format json unterstützen, damit dies wirksam wird; Auf diese Weise wird kein anderes Ausgabeformat weitergeleitet.

Bare-Aufruf und help leiten beide weiter – im Gegensatz zu uip codedagent (wo die leere help die eigene Hilfe des Befehl immer anzeigen), uip context-grounding ohne Argumente an exec --help und uip context-grounding help leitet explizit denselben exec --help -Aufruf weiter . Beide zeigen den eigenen Hilfetext des Python-Pakets an, nicht den dieses Tools.

Auth-Relay: Vor der Weiterleitung liest die CLI die von uip login erstellte Sitzung und fügt sie in die Umgebung des Python-Unterprozesses ein, wobei der gleiche Mechanismus auch uip codedagent verwendet wird. Wenn Sie nicht angemeldet sind, funktioniert die Weiterleitung weiterhin; Die Python-CLI wird ohne diese Variablen ausgeführt.

Exitcodes

Es gelten die Standard -Exitcodes sowie 3 speziell für den oben beschriebenen blockierten auth -Befehl. Der Exitcode des weitergeleiteten Teilprozesses wird andernfalls direkt an die übergeordnete Shell weitergeleitet.

Zugehörig

• Tools (Plugins) – Thin-Wrapper-Tool-Modell.
• uip codedagent – das gleiche Python-Bridge-Muster, mit einer festen Whitelist für die Weiterleitung, anstatt alles weiterzuleiten.
• uip login – erstellt die Sitzung, die an die Python-Laufzeit weitergeleitet wird.
• uip tools – Installieren, Aktualisieren und Deinstallieren des context-grounding-tool -Pakets selbst.