UiPath Documentation
maestro
latest
false
Benutzerhandbuch zu Maestro Orchestrate
Wichtig :
Bitte beachten Sie, dass dieser Inhalt teilweise mithilfe von maschineller Übersetzung lokalisiert wurde. Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.

Ablaufverfolgungen von externen Agents

Verwenden Sie W3C Trace Context and Data Export, um zu sehen, was in den externen Agents passiert, die Ihre Maestro-Prozesse aufrufen, eingefügt in Ihre Beobachtbarkeitsplattform.

Problembeschreibung​

Maestro-Prozesse rufen häufiger externe Agents auf – Agents, die auf Plattformen wie Azure AI Foundry, Databricks und anderen ausgeführt werden. Ein externer Agent-Aufruf teilt Maestro nur mit, dass der Agent ausgeführt wurde und ob er erfolgreich war – nicht, was darin geschah: Welches Modell aufgerufen wurde, welche Tools verwendet wurden, wie lange jeder Schritt gedauert hat oder warum ein Aufruf fehlgeschlagen ist.

Ohne diese Transparenz können Prozessverantworliche die externen Agent-Schritte in ihren Prozessen nicht prüfen, optimieren oder debuggen. Wenn ein externer Aufruf fehlschlägt, zeigt das Protokoll nur das Ergebnis an der Grenze – so können sich die Teams bei jeder externen Plattform anmelden, Zeitstempel erraten und nicht verwandte Aktivitäten durchsuchen, um zu rekonstruieren, was schief gelaufen ist. Externe Agent-Ablaufverfolgungen schließen diese Lücke.

Wie die Ablaufverfolgung von externen Agents hilft​

Maestro nimmt an der verteilten Ablaufverfolgung mithilfe des standardmäßigen Open W3C Trace Context teil. Jeder externe Agent-Aufruf von Maestro hat eine gemeinsame Ablaufverfolgungs-ID. Agents, die den Standard verstehen, zeichnen ihre eigene Aktivität unter derselben Ablaufverfolgungs-ID auf, sodass Ihre Beobachtbarkeitsplattform die Schritte von Maestro und die internen Schritte des externen Agents in einer einzigen End-to-End-Ansicht zusammenfügen kann.

Wie es funktioniert​

  1. Maestro generiert eine Trace-ID. Wenn eine Prozessinstanz gestartet wird, erstellt Maestro eine eindeutige Master-Trace-ID für die Ausführung.
  2. Maestro überträgt sie bei jedem ausgehenden Aufruf. Vor dem Aufrufen eines externen Agenten fügt Maestro die Trace-ID als W3C- traceparent -Header in die Anforderung ein – zum Beispiel: traceparent: 00-<trace-id>-<span-id>-01
  3. Konforme Agents setzen die Ablaufverfolgung fort. Ein externer Agent, der W3C-Trace-Kontext unterstützt, liest den Header, behält die Master-Trace-ID und zeichnet seine interne Arbeit (Modellaufrufe, Toolverwendung, Latenz, Fehler) als untergeordnete Spannen unter derselben Ablaufverfolgung auf.
  4. Spannen fließen zu Ihrer Beobachtbarkeitsplattform. Die Spannen von Maestro erreichen Ihre Plattform über den Datenexport; Die Spannen des externen Agents gelangen über seine eigene Telemetriepipeline. Da beide dieselbe Ablaufverfolgungs-ID haben, fasst Ihre Plattform sie in einer Wasserfallansicht zusammen.
Hinweis:

Die Weitergabe von Ablaufverfolgungen ist ein einziges Verhalten auf Framework-Ebene. Sie gilt automatisch für externe Agent-Aufrufe in Maestro – es gibt nichts zu aktivieren, was pro Connector oder pro Agent aktiviert werden muss.

Voraussetzungen​

  • Sie müssen ein Organisationsadministrator sein, um den Datenexport zu konfigurieren, und für den Mandanten muss Insights aktiviert sein.
  • Ein unterstütztes Ablaufverfolgungsziel: Databricks, Arize oder ein OTLP-Endpunkt (OpenTelemetry Protocol).
  • Der externe Agent muss Traces ausgeben, wobei die Ablaufverfolgung auf der Agent-Seite aktiviert ist. Nur-Modell- oder LLM-Bereitstellungsendpunkte erzeugen im Allgemeinen keine Ablaufverfolgungen – nur Agents, für die die Ablaufverfolgung aktiviert ist, erzeugen eine Ablaufverfolgung.

Konfigurieren Sie den Datenexport​

Externe Agent-Ablaufverfolgungen werden sichtbar, sobald die Ausführungs-Ablaufverfolgungen von Maestro in Ihre Beobachtbarkeitsplattform exportiert wurden.

  1. Navigieren Sie zu Ihrer Organisation, wählen Sie die Registerkarte Administrator und dann die Karte Datenexport aus.
  2. Wählen Sie + Hinzufügen aus und schließen Sie den Konfigurationsassistenten ab.
  3. Wählen Sie den Mandanten und dann die Datenquelle für Agent und Maestro Traces aus. Diese Datenquelle wird als OTEL-Ablaufverfolgungsdaten exportiert.
  4. Wählen Sie Ihr Ziel – Databricks, Arize oder einen OTLP-Endpunkt – aus, geben Sie die Verbindungsdetails an und speichern Sie.

Sobald der Export aktiv ist, werden Maestro-Ablaufverfolgungen – einschließlich der Spannen aus externen Agent-Aufrufen – an Ihr Ziel gestreamt, wo Sie anhand der Ablaufverfolgungs-ID suchen können, um die vollständige Ausführung anzuzeigen.

Setup-Details und zielspezifische Anweisungen finden Sie unter Data Export.

Hinweis:

Databricks: Die Databricks Agent-API berücksichtigt keine eingehenden W3C-Ablaufverfolgungsheader und gibt stattdessen eine eigene Ablaufverfolgungs-ID pro Aufruf aus. Um Databricks-Aufrufe zu korrelieren, erfasst Maestro die vom Aufruf zurückgegebene Databricks-Ablaufverfolgungs-ID und zeichnet sie in einer externen Agent- Aufrufspanne auf, die unter der Aktivitätsspanne verschachtelt ist. Damit dies auf der Databricks-Seite funktioniert:

  • Die MLflow-Ablaufverfolgung muss auf dem Agent aktiviert sein.
  • Der Agent muss so konfiguriert sein, dass er seine Trace-ID an UiPath zurückgibt.
  • Eine aktuelle Version von MLflow ist erforderlich – ältere Versionen geben die Ablaufverfolgungs-ID nicht zurück, sodass keine Ablaufverfolgungsspanne generiert wird.

Häufig gestellte Fragen​

Muss ich etwas in meinen externen Agents installieren?​

Nein. Maestro überträgt den Ablaufverfolgungskontext mithilfe des offenen W3C-Ablaufverfolgungskontextstandards. Jeder externe Agent, der diesen Standard bereits unterstützt, zeichnet seine Spannen automatisch unter der Ablaufverfolgungs-ID von Maestro auf – dem Code des Agents ist nichts hinzuzufügen.

Muss ich die Ablaufverfolgung für jeden Connector oder Agent konfigurieren?​

Nein. Die Trace-Weitergabe ist ein einziges Verhalten auf Framework-Ebene, das für externe Agent-Aufrufe in Maestro gilt. Die einzige Einrichtung, die erforderlich ist, ist die Konfiguration eines Datenexportziels, damit die Ablaufverfolgungen Ihre Beobachtungsplattform erreichen.

Warum werden für einige externe Agents Ablaufverfolgungen angezeigt, für andere jedoch nicht?​

Ein externer Agent trägt nur Traces bei, wenn er sie tatsächlich ausgibt. Einfache Modell- oder LLM-Endpunkte erzeugen im Allgemeinen keine Ablaufverfolgungen – nur Agents, bei denen die Ablaufverfolgung aktiviert ist. Für Agents, die W3C Trace Context unterstützen, werden ihre Spannen automatisch unter der Trace-ID von Maestro angezeigt. Für Agents, die dies nicht tun, wie z. B. Databricks, muss die Ablaufverfolgung auf der Agent-Seite aktiviert und konfiguriert werden, damit eine Ablaufverfolgungs-ID an Maestro zurückgegeben wird.

Wo werden die Ablaufverfolgungen angezeigt?​

In Ihrer eigenen Beobachtbarkeitsplattform. Sobald der Datenexport aktiv ist, suchen Sie an der Ablaufverfolgungs-ID, um die Spannen von Maestro und die Spannen des externen Agents zusammenzufassen, die in einer einzigen End-to-End-Ansicht zusammengefügt sind.

War diese Seite hilfreich?

Verbinden

Benötigen Sie Hilfe? Support(opens in new window)

Möchten Sie lernen? UiPath Academy(opens in new window)

Haben Sie Fragen? UiPath-Forum(opens in new window)

Auf dem neuesten Stand bleiben