Governance und Vertrauen

Wie Zugriff, Authentifizierung und sichere Standardeinstellungen gelten, wenn ein Codierungs-Agent auf Ihre UiPath-Organisation eingreift.

Wenn ein Codierungsagent eine UiPath-Arbeit erstellt und ausführt, handelt er über die uip -CLI unter Ihrer angemeldeten Identität. Wenn Sie diese Grenze verstehen, kann der Workflow sicher in ein Unternehmen eingeführt werden.

Wichtig:

Auf dieser Seite wird das vorgesehene Vertrauensmodell beschrieben. Bestätigen Sie die Einzelheiten gegen die Sicherheitsrichtlinien Ihrer Organisation und das aktuelle Plattformverhalten, bevor Sie sich bei Compliance-Entscheidungen darauf stützen.

Empfohlene Richtlinien, bevor Sie beginnen

Bevor Sie einen Codierungs-Agent für Ihre UiPath-Organisation handeln lassen, empfehlen wir die folgenden Methoden, um die konforme und verantwortungsvolle Nutzung zu unterstützen.

• Authentifizierung. Ein dediziertes, tokenisiertes Konto mit minimalen Berechtigungen wird empfohlen, anstatt eines, das Ihren vollständigen Zugriff erbt. Dadurch werden die Auswirkungen begrenzt, wenn das Token jemals kompromittiert wird, und die Aktionen des Agents können separat von Ihren in einer kontrollierten, nachverfolgbaren Umgebung geprüft werden.
• Konfiguration. Der Attended-Ausführungsmodus hält einen Menschen auf dem Laufenden und reduziert das Risiko unbeabsichtigter, autonomer Aktionen. Die Option „Unattended“ erfordert erhöhte oder unbeaufsichtigte Berechtigungen und ist mit einem höheren Risiko verbunden, daher ist der Attended-Modus der sicherere Standard.
• Leitplanken. Geeignete Leitplanken für den Codierungsagenten eines Drittanbieters, die eingerichtet wurden, bevor er Zugriff auf die UiPath-Umgebung erhält, tragen dazu bei, die Möglichkeiten des Agents zu begrenzen und das Risiko eines unerwarteten oder bösartigen Verhaltens zu verringern. Der Scope der Berechtigungen des Agents wird am besten vor der Bereitstellung sorgfältig definiert.
• Persönliche Daten. Wenn personenbezogene Daten verarbeitet werden, sollte diese Verarbeitung gemäß den Richtlinien Ihrer Organisation und den geltenden Datenschutzanforderungen zulässig sein, bevor der Zugriff des Agents aktiviert oder erweitert wird.
• Menschliche Aufsicht. Bei jedem Schritt, bei dem Ihre internen Prozesse einen Kontrollpunkt oder eine Genehmigung erfordern, bleibt menschliche Aufsicht erforderlich.

Warnung:

Haftungsausschluss: Ein Codierungs-Agent validiert nicht die Konformität des generierten Codes. Sie sind dafür verantwortlich, den gesamten generierten Code zu überprüfen, bevor Sie ihn gemäß Ihren internen Richtlinien in der Produktion bereitstellen.

Der Agent fungiert als Sie

Die CLI authentifiziert sich als bestimmte UiPath-Identität in einer bestimmten Organisation und einem bestimmten Mandanten. Alles, was Ihr Codierungsagent über die CLI ausführt, ist durch die Berechtigungen dieser Identität begrenzt – er kann keine Ressourcen erreichen, die das angemeldete Konto nicht erreichen kann. Der Scope-Zugriff funktioniert daher immer auf die gleiche Weise wie bei UiPath: über Rollen, Ordner und Mandantenzuweisung.

Authentifizierung und Identität

Die interaktive Anmeldung verwendet Ihren Browser und die normale Anmeldung Ihrer Organisation, einschließlich aller Multi-Faktor- und bedingten Zugriffsrichtlinien. In automatisierten Kontexten verwendet die nicht interaktive Authentifizierung von Ihnen bereitgestellte und gesteuerte Anmeldeinformationen. Der Agent benötigt nie Ihr Kennwort; Es funktioniert mit der Sitzung, die die CLI herstellt.

Geheimnisse und Anmeldeinformationen

Anmeldeinformationen und Geheimnisse gehören in Ihren geheimen Speicher oder die Geheimnisverwaltung Ihres CI/CD-Systems, nicht in Prompts, Projektdateien oder Source Control. Hier gilt die gleiche Regel, die Sie für jede Automatisierung anwenden.

Wir erfassen Daten

Zwei Quellen senden eine Telemetrie zur Produktnutzung an das UiPath-eigene Azure Application Insights, das in der Region Westeuropa gehostet wird: die eigene Befehlstelemetrie der uip -CLI und die UiPath-Fähigkeiten, die der Codierungs-Agent über die CLI aufruft. Beide befinden sich in derselben von UiPath verwalteten Ressource und sind mit Tags versehen, damit sie unterscheidbar bleiben. Die Daten helfen uns zu verstehen, welche Befehle und Fähigkeiten verwendet werden und wo sie fehlschlagen.

Die Fähigkeitentelemetrie ist standardmäßig deaktiviert – siehe Ein- oder Ausschalten der Telemetrie unten.

Was gesammelt wird

• Befehls- und Fähigkeitsnutzung – für jeden uip -Befehls- oder fähigkeitsgesteuerten Toolaufruf: der Befehls- oder Toolname, der abgeleitete uip -Unterbefehl (die ersten ein oder zwei Verben, niemals die vollständige Befehlszeile), der Fähigkeitsname (Nur UiPath-Fähigkeiten), wie lange sie lief und ob sie erfolgreich war, unterbrochen wurde oder fehlgeschlagen ist (mit der Fehlermeldung für CLI-Befehle).
• Dateityp – die Dateierweiterung, die an einem Toolaufruf beteiligt ist (z. B. .flow), niemals der Dateipfad.
• Umgebung – Die CLI- und Fähigkeitsversionen, die Cloud-Umgebung, die sich aus Ihrer Anmeldung abgeleitet hat (z. B. Alpha, Staging oder Produktion) und welcher KI-Codierungsagent die CLI aufgerufen hat (z. B. Claude Code, Cursor, Gemini-CLI oder Codex).
• Identität – Ihre angemeldete UiPath Cloud-Identität: Cloud-Benutzer-ID, Mandanten-ID und Organisations-ID. Diese Telemetrie ist nicht anonym; Sie hat die gleiche Identität wie alle anderen uip -CLI-Aktivitäten.
• Korrelations-IDs – Sitzungs- und Aufrufbezeichner, die die Schritte einer einzelnen Ausführung verknüpfen.

Was nie gesammelt wird

Die folgenden Informationen verlassen Ihre Maschine nie, obwohl der Agent und die CLI sie lokal lesen, um ihre Arbeit zu erledigen:

• Dateiinhalte, Befehlsausgabe (stdout und stderr) und Agent-Transkripte.
• Vollständige Befehlszeilen – nur das abgeleitete Unterbefehlsverb.
• Dateipfade und Ihr Arbeitsverzeichnis – nur die Dateierweiterung.

Jedes Telemetriefeld wird aus einem bestimmten, begrenzten Teil der Nutzlast extrahiert, sodass Freiform-Inhalte (z. B. eine Ausgabe, die zufällig einen Pfad oder einen Befehlsnamen enthält) nicht in ein Feld gelangen. Für die eigene Befehlstelemetrie der CLI werden Werte an der Quelle zusätzlich entfernt. Alles, was einem der folgenden Elemente ähnelt, wird durch [REDACTED] ersetzt:

• Token oder Schlüssel
• Geheimnis oder Kennwort
• Anmeldeinformationen oder Zertifikat

Bezeichner und E-Mails werden gehostet; URLs werden auf ihren Host reduziert.

Wohin es geht

Azure Application Insights im Besitz von UiPath in der Region Westeuropa. Die Verbindung befindet sich im Besitz der CLI; Die Fähigkeiten halten es nie. Sie können Telemetrie an eine andere Instanz mit der Umgebungsvariablen UIPATH_AI_CONNECTION_STRING weiterleiten, obwohl dies bei normaler Verwendung nicht erforderlich ist.

Aufbewahrung

Die Aufbewahrung wird durch die Konfiguration des Application Insights-Arbeitsbereichs und nicht durch die CLI oder die Fähigkeiten gesteuert. Azure Application Insights ist standardmäßig 90 Tage eingestellt, sofern der Arbeitsbereich nicht anders konfiguriert ist. Ihr Plattformteam kann den konfigurierten Aufbewahrungszeitraum bestätigen, bevor Sie sich darauf verlassen können.

Telemetrie ein- oder ausschalten

Eine einzige Umgebungsvariable, UIPATH_TELEMETRY_DISABLED, steuert beide Quellen, aber ihre Standardwerte unterscheiden sich:

• Die Telemetrie zu Fähigkeiten ist standardmäßig deaktiviert. Es wird nur gesendet, wenn Sie UIPATH_TELEMETRY_DISABLED=0 explizit festlegen.
• Die eigene Befehlstelemetrie der CLI wird gesendet, es sei denn, Sie entscheiden sich durch Einstellung UIPATH_TELEMETRY_DISABLED=1 ab.
• Die gesamte Telemetrie kann durch Einstellung UIPATH_TELEMETRY_DISABLED=1 deaktiviert werden. Wenn diese Option deaktiviert ist, wird nichts gesendet und die CLI behält nur die lokale Debugprotokollierung bei.

Die Kontrolle behalten

Codierungs-Agents schlagen Aktionen vor und stellen in ihren Standardkonfigurationen Befehle bereit, die Sie vor der Ausführung genehmigen müssen. Durch die Überprüfung, was der Agent generiert hat – und was er ausführen soll – vor der Genehmigung wird ein Mensch für alles auf dem Laufenden gehalten, was den Status in Ihrer Organisation ändert.

Informationen zur Untersuchung von Problemen, wenn etwas schief läuft, finden Sie unter Fehlerbehebung und FAQ.