Zum Hauptinhalt springen

Häufig gestellte Fragen

Kurze Antworten auf die häufigsten Fragen, jeweils mit einem Link zur entsprechenden Erklärungsseite. Fehlermeldungen finden Sie unter Fehlerbehebung.

Konzepte​

Worin besteht der Unterschied zwischen einem Workflow, einem Agenten und einem Agentengraphen?​

Ein Workflow (von der Engine und der API als Pipeline bezeichnet) ist ein Knotengraph, der Daten stets auf dieselbe Weise verschiebt und transformiert; er wird in Studio, Workflows erstellt. Ein Agent ist ein Modell mit Anweisungen und Werkzeugen, das selbstständig entscheidet, welche Funktionen aufgerufen werden; er wird in Agentic, Agents erstellt. Ein Agentengraph ist ein versionierter, mehrstufiger Graph von Modellschritten mit Rollen, Routing, Überprüfungsschleifen und einem Protokoll jeder Eingabeaufforderung. Ein Workflow kann einen Agenten als Schritt aufrufen. Siehe „Wichtige Konzepte“ und „Beliebigen Workflow erstellen“.

Was bedeuten die Laufstatus?​

Ein Workflow-Lauf erhält den Status pending, running, completed, partial, failed, cancelled oder waiting. partial bedeutet, dass der Lauf abgeschlossen wurde, aber mindestens ein Knoten ein teilweises, beeinträchtigtes oder noch zu prüfendes Ergebnis gemeldet hat. Es handelt sich also nicht um einen vollständigen Erfolg. Für Workflow-Läufe gibt es keinen Status draft, paused oder timed out; Agentengraph-Läufe verwenden einen anderen Status. Siehe „Wichtige Konzepte“.

Wie ausgereift ist jeder Teil der Plattform?​

Die aktuellen Bezeichnungen, Quelldaten und Verifizierungsgrenzen, einschließlich Hub-and-Spoke-Modi, finden Sie unter „Funktionsstatus“. X12 GA bezieht sich auf Parsing- und Workflow-Knoten; der Transport erfolgt über eine vereinbarte Datei oder API-Route, nicht über einen dedizierten X12 Connect-Konnektor. Der Reifegrad der Knoten wird separat im Katalog erfasst: Knoten drug-check und terminology-mapper liefern simulierte Daten und sind nicht für den klinischen Einsatz bestimmt.

Aufbau und Betrieb​

Warum wird mein Knoten übersprungen?​

Entweder war der zugehörige Zweig nicht aktiv (ein Knoten mit Port condition aktiviert nur Port true oder false), oder eine Kante verweist auf einen nicht existierenden Portnamen. Im zweiten Fall tritt kein Fehler auf: Der Lauf wird mit Port completed abgeschlossen, und das Ziel ist Port skipped. Überprüfen Sie den Quellportnamen an der Kante. Siehe „Beliebigen Workflow erstellen“.

Warum steht bei meinem Lauf partial ?​

Mindestens ein Knoten endete degraded, üblicherweise weil error_handling auf einem fehlerhaften Knoten log_and_continue entspricht. Öffnen Sie den Lauf in Studio, Workflows, Monitor und suchen Sie den Knoten. Der nächste Knoten muss degraded in accept_outcomes auflisten, um ausgeführt zu werden, andernfalls schlägt er mit requires a successful outcome from <node> (received degraded) fehl. Siehe „Beliebigen Workflow erstellen“.

Kann ich mit Cron einen Workflow zeitgesteuert ausführen?​

Ja. Öffnen Sie Studio, Workflows, Monitor, dann den Tab Schedules, anschließend New schedule: Wählen Sie den Workflow aus, geben Sie einen Cron (es gibt Voreinstellungen) und optionale Eingaben ein und aktivieren Sie ihn. Der Menüpunkt Schedule im Ausführen-Menü des Builders fügt lediglich einen Knoten scheduler zur Arbeitsfläche hinzu. Siehe Ausführungsoptionen.

Wie kann ich testen, ohne echte Systeme aufzurufen?​

Schalten Sie den Symbolleistenschalter von Live auf Test. Im Testmodus ersetzt eine an einen Knoten angehängte Testumgebung dessen Ausgabe, und der Knoten wird nicht ausgeführt. Testumgebungen können Sie in Resources, Test Data erstellen oder die letzte Ausgabe eines Knotens als Testumgebung festlegen. Dry run ist nur im eingestellten Modus aktiv, daher sollten Sie zuerst Schritt Test einstellen. Debug step-by-step können Sie außerdem die Daten jedes Knotens stapelweise untersuchen. Verwenden Sie synthetische Daten. Siehe „Beliebigen Workflow erstellen“ und „Workflow-Builder“.

Was bewirkt die Funktion „Bereitstellen“?​

Im Workflow-Builder speichert Deploy den Workflow, setzt seinen Status auf deployed:staging oder deployed:production (die Umgebung muss in Ihrer Organisation vorhanden sein) und protokolliert die Änderung im Verlauf. Der Workflow wird weder kopiert noch gestartet. Die separate Seite Tiet · Hub → Platform → Environments bietet Registerkarten für Umgebungen, Routen, Agenten & Workflows, Vertrauenswürdige Quellen, Genehmigungen und Aufbewahrung für die Bereitstellung und Weiterleitung. Die Steuerelemente sind vom Bereitstellungsmenü des Workflow-Builders getrennt. Ein Workflow mit einem Knoten hl7-listener empfängt Daten sofort nach dem Speichern, ohne dass eine Bereitstellung erforderlich ist. Siehe Workflow-Builder und Umgebungen und Weiterleitung.

Was passiert, wenn ein Knoten ausfällt oder zu lange braucht?​

Standardmäßig schlägt ein ausgefallener Knoten den gesamten Lauf fehl (fail_fast). Sie können dies pro Knoten mit error_handling (log_and_continue oder fallback) ändern und retry hinzufügen. Ein Knoten, der sein Limit Timeout (s) überschreitet, schlägt fehl; ist dieses Limit nicht festgelegt, wendet die Engine 5 Minuten an. Die Engine beendet einen Lauf außerdem nach insgesamt 30 Minuten, außer wenn er auf ein Ereignis wartet. Siehe Wichtige Konzepte.

Gibt es eine Begrenzung für die Anzahl der Knoten in einem Workflow?​

Die Dokumentation gibt an, dass keine Begrenzung existiert, da im Quellcode kein Grenzwert gefunden wurde. Graph-Schutzmechanismen wie max_total_steps gelten für Agentengraphen, nicht für Workflows. Siehe Agentengraph-Schutzmechanismen.

Daten, Systeme und Standards​

Welche EHR-Systeme werden unterstützt?​

Die Workflow-Palette enthält Konnektoren für Epic (epic-fhir), Oracle Health/Cerner, athenahealth, Allscripts, Dedalus, EMIS, IMS MAXIMS, diverse SAP-Module und viele weitere. Im Konnektorverzeichnis finden Sie jeweils Anbieter, Region, Authentifizierungsinformationen und Entwicklerlinks. Die Anbieter werden in Tier 1 (offene öffentliche API, Selbstregistrierung) und Tier 2 (Partnerprogramm oder Genehmigung für den Produktivzugriff erforderlich) unterteilt. Da im Repository keine Bearbeitungszeiten für Genehmigungen angegeben sind, wenden Sie sich bitte direkt an den Anbieter. Für den Produktivzugriff auf Epic ist eine Registrierung bei App Orchard erforderlich. Weitere Informationen finden Sie unter „Ihre elektronische Patientenakte verbinden“.

Welche Standards werden unterstützt und wie gut?​

Informationen zur Verfügbarkeit und zu anderen Standards rund um FHIR finden Sie unter „Funktionsstatus“ und „Weitere Standards zu FHIR“ für eine vollständige Aufschlüsselung von HL7, X12, DICOM und IHE. Die X12-Verfügbarkeit umfasst Parsing- und Workflow-Knoten, die Transportkonfiguration erfolgt separat. Die FHIR-Strukturvalidierung ist allgemein verfügbar; die Validierung des vollständigen Profils und des US-Core-Standards befindet sich im Rückstand.

Was wird bei der HL7 ADT-zu-FHIR-Konvertierung berücksichtigt?​

Für eine ADT^A01-Nachricht wird ein Patient (Identifikator, Name, Geburtsdatum, Geschlecht) und ein Encounter (Klasse IMP, Status in-progress, Ort aus PV1-3) erstellt. Besuchsnummer, Angehörige, Ereignisdetails, Allergien und Diagnosen werden nicht zugeordnet. Jede Nachricht erzeugt neue Ressourcen, daher schließt eine Entlassung keinen Encounter ab und es werden Duplikate erneut gesendet. Die Einschränkungen sind in der Anleitung „ADT zu FHIR“ beschrieben.

Soll ich eine Connect-Pipeline oder einen Workflow für HL7 verwenden?​

Verwenden Sie eine Connect-Pipe für den einfachen Transport: Empfangen, optionales Transformieren, Zustellen. Verwenden Sie einen Workflow mit einem hl7-listener Knoten, wenn Sie mit Knoten festlegen möchten, was mit jeder Nachricht geschieht. Beachten Sie, dass die HL7-zu-FHIR-Konvertierung einer Pipe ein collection Bundle erzeugt, keine Transaktion; der aktuell verifizierte Konvertierungsweg ist der Workflow. Siehe Erstellen einer Connect-Pipe.

Warum erhielt der Absender AA, aber es passierte nichts?​

Standardmäßig wird eine Nachricht, die von allen Empfängern herausgefiltert wurde, mit AA bestätigt und ignoriert. Setzen Sie den Wert von nack_on_filter auf true, um stattdessen AR zu antworten. In einer Connect-Pipeline bedeutet AA, dass die Nachricht in die Warteschlange gelangt ist, nicht, dass sie vom Ziel empfangen wurde. Siehe Fehlerbehebung.

Wo werden meine Daten gespeichert und sind sie verschlüsselt?​

Diese Dokumentation enthält keine Angaben zu Datenspeicherung, Aufbewahrung, Verschlüsselung oder Zertifizierung, da diese im Quellcode des Produkts nicht definiert sind. Die Schalter Compliance and evidence und API boundary auf der Seite Security der Administrationskonsole sind gespeicherte Flags, die die Absicht protokollieren; die Einstellung „Nichts gefunden“ aktiviert die Verschlüsselung oder Aufbewahrung. Fragen Sie in Tietai nach der Antwort für Ihre Bereitstellung. Siehe Administration.

Zugangsdaten, Token und Geheimnisse​

Warum kann ich die Menüpunkte „Compliance“, „Agenten“ oder andere Menüpunkte nicht sehen?​

Die Seitenleiste zeigt nur Module Ihrer Organisation und Elemente an, für die Sie Berechtigungen besitzen. Für Agents und Workflows ist Berechtigung access:hydra plus eine weitere Berechtigung erforderlich, Compliance eine Berechtigung zum Lesen, Verwalten, Überprüfen oder Auditieren von Compliance-Daten. Die Gruppen Organization, Platform und Security der Admin-Konsole sind nur für Organisationsadministratoren sichtbar. Ein Administrator prüft Ihre Rollen, Gruppen und direkten Berechtigungen in Admin Console, Organization, Roles & Permissions. Siehe Anwendungsgrundlagen sowie Tiet · Studio und Tiet · Agentic.

Wie funktionieren API-Token?​

Ein Organisationsadministrator erstellt ein Token in der Admin-Konsole unter „Plattform“ > „API-Token“ > „Token erstellen“. Dabei wählt er einen Namen, Gültigkeitsbereiche, optional eine Gültigkeitsdauer (1 bis 365 Tage), ein Ratenlimit und zulässige IP-Adressen. Das Token beginnt mit tia_m2m_, wird nur einmal angezeigt und speichert lediglich einen Hashwert. Senden Sie es als Authorization: Bearer <token>. Ein Token ist an die Organisation gebunden, die es erstellt hat. Durch den Widerruf wird es sofort gesperrt und kann nicht rückgängig gemacht werden. Weitere Informationen finden Sie in der Administrations- und API-Referenz.

Wo kann ich ein API-Token verwenden?​

Nur bei bestimmten Workflow-Engine-Routen: POST /execute (Bereich pipeline:{id}:execute oder pipelines:execute), POST /v1/agents/{id}/invoke (Bereich agent:{id}:execute, agents:execute und ähnliche) sowie den Manifest-, Instanz- und Bereitstellungsrouten. Alle anderen Routen, wie z. B. das Auflisten von Pipelines, Agents, Ausführungen, Konnektoren oder Modellen, benötigen ein Benutzer-JWT. Ein API-Token gibt hier 401 {"error":"unauthorized: invalid token"} zurück. Siehe API-Referenz.

Wie werden Geheimnisse behandelt?​

Tragen Sie die Anmeldeinformationen in die geheimen Felder des Knotens (client_secret, auth_token, private_key_pem usw.) ein, die vom mandantenspezifischen Anmeldeinformationsauflöser verarbeitet werden. Eine Workflow-Variable mit der Kennzeichnung is_secret wird nicht durch einen Platzhalter mit der Kennzeichnung {{NAME}} ersetzt; das empfangende System erhält den Originaltext. Verwenden Sie nicht-geheime Variablen nur für Werte, die im Workflow sicher angezeigt werden können, z. B. eine Basis-URL. Die Anmeldeinformationen für den Connector werden getrennt von der Connector-Konfiguration gespeichert. Auf Seite Secrets der Administrationskonsole werden Organisationsgeheimnisse aufgelistet. Da im Quellcode des Authentifizierungsdienstes jedoch nur die Auflistung und die Rotationsprüfung vorhanden sind, kann das Hinzufügen, Rotieren oder Anzeigen eines Werts fehlschlagen. Weitere Informationen finden Sie unter „Beliebigen Workflow erstellen“ und „Administration“.

Funktioniert SSO mit SAML oder OIDC?​

Noch nicht für die Anmeldung. Die Seite SSO / SAML speichert Anbietereinstellungen (Google, Microsoft, Okta, Auth0, benutzerdefiniertes OIDC, benutzerdefiniertes SAML) und kann die Konnektivität des Anbieters testen. Der Authentifizierungsdienst verfügt jedoch über keinen OIDC- oder SAML-Anmeldeendpunkt, und die Anmeldeseite enthält keine entsprechende Schaltfläche. Die Google-Anmeldung funktioniert mit den zulässigen E-Mail-Domänen, sofern diese Funktion in Ihrer Bereitstellung aktiviert ist. Die Anmeldung mit Passwort ist immer möglich. Siehe „Organisation einrichten“.

Ist eine Multi-Faktor-Authentifizierung verfügbar?​

Die Sicherheitsseite verfügt über einen Schalter mit Require multi-factor authentication, dieser wird jedoch nur gespeichert: Es gibt keinen MFA-Registrierungsprozess im Produkt, und kein Code liest diese Einstellung aus. Siehe Administration.

Welche Passwortregeln gelten?​

Der Server erzwingt ein Passwort mit mindestens 8 Zeichen, bestehend aus Großbuchstaben, Kleinbuchstaben und einer Zahl. Symbole sind nicht erforderlich. Wiederholte Zeichen und einfache Zeichenfolgen werden abgelehnt. Die letzten 5 Passwörter können nach dem Zurücksetzen nicht wiederverwendet werden. Fünf fehlgeschlagene Anmeldeversuche sperren das Konto für 30 Minuten. Die organisationsspezifischen Werte auf der Seite „Sicherheit“ werden gespeichert, aber bei der Passwortprüfung nicht ausgelesen. Siehe Administration.

Die Anwendung und diese Dokumentation​

Was ist die Hilfe- und Supportseite?​

System, Help & Support ist eine anwendungsinterne Anleitung, die aus der Seitenleiste erstellt wurde. Sie listet die für Sie sichtbaren Module auf (die gleichen Berechtigungsregeln wie für die Seitenleiste, daher werden ausgeblendete Bereiche nicht angezeigt), mit einem Filter pro Seitenleistengruppe (Alle Bereiche plus jede sichtbare Gruppe), einem Suchfeld („Anwendungsanleitung durchsuchen…“) und für jedes Modul einer Anleitung mit Screenshots, einem empfohlenen Workflow, wichtigen Bereichen und kurzen FAQs. Am Ende finden Sie unter „ Benötigen Sie weitere Hilfe?“ zwei Links: Documentation (https://docs.tiet.ai/) und Contact support (https://tiet.ai/contact/). Auf der Seite selbst wird empfohlen, Kennungen und Screenshots zu teilen, wenn ein Backend-basierter Lauf oder Bericht fehlschlägt. Siehe Fehlerbehebung.

Was soll ich an den Support senden?​

Bitte geben Sie den genauen Fehlertext, die Ausführungs-ID, die Nachrichten-ID oder die Ausführungs-ID, den Knoten, die Uhrzeit und die Organisation, in der Sie gearbeitet haben, wie unter „Bevor Sie den Support kontaktieren“ aufgeführt, an. Senden Sie keine Patientendaten, Token oder Passwörter.

Welche Sprachen sind verfügbar?​

Die Anwendung enthält Übersetzungsdateien für Englisch, Spanisch und Französisch; alle anderen Namen in der Sprachliste werden automatisch auf Englisch umgestellt. Ändern Sie die Sprache in System → Admin Console → Account → Profile → Locale & Language oder verwenden Sie den Sprachumschalter oben rechts auf der Anmeldeseite. Einige Bildschirme sind nicht übersetzt: Die Beschriftungen von Graph Agent Studio sind englischer Festtext. Diese Dokumentationsseite ist derzeit nur auf Englisch verfügbar. Siehe Anwendungsgrundlagen.

Welche Browser werden unterstützt?​

In der Dokumentation wird keine Liste unterstützter Browser angegeben, da in der Originalquelle keine definiert ist.

Gibt es eine mobile App?​

Das Repository enthält eine mobile Begleit-App für Consult, in der die Phasen P0 bis P4 implementiert sind; die Verfügbarkeit in App-Stores ist hier nicht dokumentiert. Siehe Tiet · Consult.

Sind die klinischen Apps bereit für den klinischen Einsatz?​

Prüfen Sie den Status jeder Seite. Beispielsweise ist das Rezept für die Sprachnachverfolgung nur in der Entwicklungsphase verifiziert und noch nicht für die klinische Anwendung zugelassen. Für Tiet · Consult liegt ein Entwurf des Designdokuments vor, und Agenten, die mit klinischen Systemen kommunizieren, sollten Vorschläge oder Entwürfe verfassen, die von einer Person geprüft werden. Siehe Rezept: Sprachnachverfolgung, Tiet · Consult und Agenten und Governance.

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