Zum Hauptinhalt springen

Schlüsselkonzepte

Der Wortschatz, dem Sie in Tietai begegnen, wobei jeder Begriff mit der Stelle in der Anwendung verknüpft ist, an der er vorkommt.

Arbeitsabläufe (Pipelines)​

Ein Workflow ist ein Diagramm verbundener Schritte zur Datenverarbeitung. Die Anwendung spricht von Workflow (Tiet · Studio → Workflows, Schaltfläche New Workflow); die Engine und die API verwenden den Begriff Pipeline. Beides ist dasselbe: Ein neuer Workflow öffnet einen Canvas-Tab mit dem Namen „Neue Pipeline“.

Daten fließen über Verbindungen von Knoten zu Knoten. Ein Knoten startet, sobald seine Eingaben bereit sind. Ein Workflow darf keine Schleife enthalten: Die Kompilierung eines Workflows mit einer Schleife schlägt mit circular dependency detected fehl.

Ein Workflow kann manuell (über die Taste Run), nach einem Zeitplan, durch einen eingehenden Triggerknoten wie hl7-listener oder durch ein Ereignis, das einen wartenden Lauf fortsetzt, gestartet werden.

Knoten​

Ein Knoten entspricht einem Schritt. Jeder Knotentyp verfügt über eine ID (z. B. hl7-to-fhir, condition, fhir-crud), Eingangs- und Ausgangsports sowie ein Konfigurationsformular. Der Katalog umfasst 198 Knotentypen in 18 Kategorien: Gesundheitswesen, elektronische Patientenakte (EHR), Daten, KI/ML, Integration, Sicherheit, Transformation, Steuerung, Agent, Trigger, RAG, Monitoring, klinische Tools, Cloud-Speicher, Forschung, Infrastruktur, Analytik und Datenbank. Sie finden diese in der Palette auf der Builder-Arbeitsfläche.

Wählen Sie einen Knoten aus, um ihn im Eigenschaftenfenster zu konfigurieren. Der Reifegrad der Knoten variiert; siehe den Funktionsstatus.

Anschlüsse und Typen​

Jeder Port hat einen Typ. Die Canvas lehnt Verbindungen ab, deren Typen nicht kompatibel sind. Die Typen sind:

TypTrägt
anyAlles. Verbindet sich mit jedem beliebigen Typ.
jsonStrukturierte Daten
textKlartext
number, booleanEine einzelne Zahl oder ein Wahrheitswert (wahr/falsch).
binaryRohdaten
fhir-bundle, fhir-resourceEin FHIR-Bundle oder eine einzelne FHIR-Ressource
hl7-messageEine HL7 v2-Nachricht
x12-messageEine X12-Transaktion
dicomEin DICOM-Objekt
ndjson, csv, xml, htmlDatenformate; alle sind auch mit text verbunden.

Die Kompatibilität folgt einer Hierarchie. Ein Subtyp ist nach oben verbunden: fhir-bundle speist json und any json speist außerdem die Eingänge fhir-bundle, fhir-resource, hl7-message und ndjson. Typen ohne angegebenen Pfad sind nicht verbunden: Ein Ausgang number speist nur number oder any.

Zwei Verhaltensweisen, die man kennen sollte:

  • Eine Verbindung von einem nicht existierenden Portnamen führt zu keinem Fehler. Der Lauf endet mit dem Ergebnis completed und der Zielknoten ist skipped. Wenn ein Knoten keine Aktion ausführt, überprüfen Sie den Portnamen.
  • Ein Bedingungsknoten aktiviert einen Ausgangsport, der andere Zweig wird übersprungen. Übersprungene Zweige blockieren keinen Knoten, der beide verbindet.

Steckverbinder​

Ein Konnektor ist eine gespeicherte, benannte Verbindung zu einem externen System. Sie verwalten sie unter Tiet · Hub → Platform → Connectors.

  • Add Connector erstellt eine Quelle. Discover source öffnet einen Dialog zum Ermitteln und Registrieren einer Quelle.
  • Ein Konnektor hat einen Gültigkeitsbereich: Organization (jedes Projekt) oder Project (ein Projekt).
  • Ein Connector hat einen Status: unconfigured, untested, testing, active, error oder disabled und einen Gesundheitszustand, der auf der Seite als Gesamt, Gesund, Ausgefallen und Beeinträchtigt zusammengefasst wird.
  • Auf der Registerkarte Activity wird das Protokoll des Konnektors angezeigt.
  • Die Seite kennt folgende Konnektortypen: postgres, mysql, mssql, sqlite, bigquery, snowflake, s3, gcs, azure_blob, local_filesystem, sftp, ftp, hl7_fhir_r4, hl7_v2, dicom_dimse, dicom_stow, rest_api, graphql, kafka, rabbitmq, smtp und webhook_outbound. Der Server meldet, welche davon in Ihrer Bereitstellung verfügbar sind; einige werden möglicherweise nicht angeboten.

Viele EHR-Knoten, wie z. B. Knoten epic-fhir, verwenden eigene Verbindungseinstellungen in der Knotenkonfiguration anstelle eines Konnektors. Überprüfen Sie die Felder des Knotens.

Hinrichtungen​

Eine Ausführung ist ein einzelner Durchlauf eines Workflows. Sie können Durchläufe unter Tiet · Studio → Workflows → Monitor einsehen. Ein Ausführungsdatensatz enthält einen Gesamtstatus, eine Fehlermeldung im Fehlerfall, Start- und Endzeitpunkt, ein Ergebnis pro Knoten (Status, Eingaben, Ausgaben, Fehler, Wiederholungsversuche) und die endgültigen Ausgaben.

Ein Lauf beginnt als ausstehend, wird dann ausgeführt und endet als abgeschlossen, teilweise, fehlgeschlagen oder abgebrochen. Ein laufender Lauf kann auf ein Ereignis warten und dann fortgesetzt werden.

StatusBedeutung
pendingAkzeptiert, aber noch nicht begonnen.
runningDie Knoten werden ausgeführt
completedDer Lauf ist beendet
partialDer Testlauf wurde abgeschlossen, aber mindestens ein Knoten meldete ein teilweises, beeinträchtigtes oder noch ausstehendes Ergebnis.
failedEin Knoten ist ausgefallen oder eine Frist ist abgelaufen.
cancelledDer Lauf wurde abgesagt
waitingEin Knoten wartet auf ein externes Ereignis. Der Lauf wird fortgesetzt, sobald das Ereignis an /api/execute/resume/{token} gesendet wurde.
skippedNur auf Knotenebene: Der Knoten konnte nicht ausgeführt werden, da alle eingehenden Zweige inaktiv waren.

Für einen Workflow-Lauf gibt es keinen Status draft, paused oder timed out.

Auszeiten​

  • Pro Knoten. Ein Knoten, der länger als sein Timeout läuft, schlägt fehl. Das Feld Timeout (s) des Knotens überschreibt den Standardwert. Wenn Sie es nicht setzen, verwendet die Engine den Wert 5 minutes. Auch wenn es nicht gesetzt ist, zeigt das Feld eine Zahl an (30 oder den vom Knoten festgelegten Standardwert); dies ist lediglich eine Anzeigeoption; der Standardwert der Engine beträgt die oben genannten 5 Minuten.
  • Der gesamte Durchlauf wird beendet. Der Executor beendet einen Durchlauf auch nach 30 minutes Punkten. Ein Durchlauf, der auf ein Ereignis wartet, ist davon ausgenommen.

Einzelne Knotentypen können ihre eigenen Beschränkungen hinzufügen; überprüfen Sie die Seite des Knotens.

Agenten, Agentengraphen und Workflows​

KonzeptWas es istWo
AgentEin konfiguriertes Modell mit Anweisungen und Werkzeugen. Erstellt mit einem Namen, einem Typ (Konversationell, Aufgabenorientiert, Hybrid oder ReAct), einer Beschreibung und einem Projekt.Tiet · Agentic → Agents → Agents Tab
Agent graphEin versionierter, mehrstufiger Graph der Modellschritte. Die Version ist draft (bearbeitbar) oder published. Die Ausführungen haben die Status „Ausstehend“, „Wird ausgeführt“, „Angehalten“, „Erfolgreich“, „Fehlgeschlagen“ und „Abgebrochen“.Tiet · Agentic → Agents → Agent Graphs Tab
WorkflowEin Graph deterministischer und KI-Knoten. Er kann Agentenknoten enthalten.Tiet · Studio → Workflows

Verwenden Sie einen Workflow zum Verschieben und Transformieren von Daten; verwenden Sie einen Agenten, wenn der Schritt eine Begründung oder den Einsatz eines Tools erfordert. Die Ausführungsstatus des Agentendiagramms unterscheiden sich von den oben genannten Workflow-Ausführungsstatus. Vermischen Sie diese nicht.

Organisationen und Berechtigungen​

Eine Organisation ist Ihr isolierter Arbeitsbereich. Benutzer, Konnektoren, Workflows, Agenten und Daten gehören zu einer Organisation. Wenn Sie mehreren Organisationen angehören, wechseln Sie mit Company im Kontomenü (unten links in der Seitenleiste); siehe „Verwendung der Anwendung“.

Der Zugriff erfolgt über Berechtigungen. Eine Berechtigung hat die Form action:resource, z. B. read:users oder access:hydra. In der Seitenleiste werden alle Module und Elemente ausgeblendet, für die Sie keine Berechtigung besitzen. Beispielsweise benötigen Sie für das Element „Workflows“ die Berechtigung access:hydra sowie eine der Berechtigungen „Builder“, „Bibliothek“ oder „Pipeline“. Administratoren vergeben Berechtigungen über Rollen, Gruppen und direkte Zuweisungen (siehe Punkt Admin Console → Organization → Roles & Permissions. Die Elemente der Admin-Konsole unter „Organisation“, „Plattform“ und „Sicherheit“ sind nur für Organisationsadministratoren sichtbar.

Falls eine Seite oder ein Button fehlt, sollten Sie als Erstes Ihre Berechtigungen überprüfen.

Weiterführende Literatur​

Etwas unklar? Senden Sie Feedback zur Dokumentation per E-Mail..