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:
| Typ | Trägt |
|---|---|
any | Alles. Verbindet sich mit jedem beliebigen Typ. |
json | Strukturierte Daten |
text | Klartext |
number, boolean | Eine einzelne Zahl oder ein Wahrheitswert (wahr/falsch). |
binary | Rohdaten |
fhir-bundle, fhir-resource | Ein FHIR-Bundle oder eine einzelne FHIR-Ressource |
hl7-message | Eine HL7 v2-Nachricht |
x12-message | Eine X12-Transaktion |
dicom | Ein DICOM-Objekt |
ndjson, csv, xml, html | Datenformate; 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
completedund der Zielknoten istskipped. 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,erroroderdisabledund 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,smtpundwebhook_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.
| Status | Bedeutung |
|---|---|
pending | Akzeptiert, aber noch nicht begonnen. |
running | Die Knoten werden ausgeführt |
completed | Der Lauf ist beendet |
partial | Der Testlauf wurde abgeschlossen, aber mindestens ein Knoten meldete ein teilweises, beeinträchtigtes oder noch ausstehendes Ergebnis. |
failed | Ein Knoten ist ausgefallen oder eine Frist ist abgelaufen. |
cancelled | Der Lauf wurde abgesagt |
waiting | Ein Knoten wartet auf ein externes Ereignis. Der Lauf wird fortgesetzt, sobald das Ereignis an /api/execute/resume/{token} gesendet wurde. |
skipped | Nur 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
| Konzept | Was es ist | Wo |
|---|---|---|
| Agent | Ein 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 graph | Ein 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 |
| Workflow | Ein 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..