TixFinDocs
Aufgaben für VeranstalterIntegrationen

Vorschläge

Wie Ihr KI-Client in TixFin etwas ändert, nur über einen Vorschlag, den Sie sehen und bestätigen, einmal angewendet und bei Geld mit frischem zweitem Faktor

7 Min. Lesezeit

Ihr KI-Client ändert in TixFin nie direkt etwas. Jedes Werkzeug, das etwas anlegen, ändern oder löschen würde, antwortet stattdessen mit einem Vorschlag: was sich ändern würde, gezeigt gegen den aktuellen Stand, und ein Handle, das ihn anwendet. Nichts ändert sich, bevor der Vorschlag angewendet wird.

Vorschläge brauchen auf der Zustimmungsseite Änderungen vornehmen, die du bestätigst (tixfin.write), und solche, die Geld bewegen oder Käufer erreichen, zusätzlich Aktionen ausführen, die Geld bewegen oder Käufer erreichen (tixfin.money). Siehe KI-Client verbinden.

Was ein Vorschlag zeigt

Ein Vorschlag listet seine Schritte in der Reihenfolge, in der sie laufen. Zu jedem Schritt zeigt er:

  • Die Operation: ihren Namen in TixFin und die genaue Anfrage, zum Beispiel PUT /projects/…/events/…. Hat der Client eine eigene Beschreibung hinzugefügt, steht sie getrennt und in Anführungszeichen als Beschreibung der KI, damit Sie die Worte von TixFin von denen des Clients unterscheiden können.
  • Die Änderungen in Worten, gegen den aktuellen Stand, der in diesem Moment live gelesen wird: "name": "Spring gala" → "Spring Gala 2027", "capacity": set to 500 und wie viele Felder ihren aktuellen Wert behalten. Ein Schritt, der etwas anlegt, hat keinen aktuellen Stand; ein Löschen heißt deletes it. Eine lange Liste zeigt ihre Anzahl und die ersten fünf Einträge. Die Vorschau ist englisch.
  • Personenbezogene Daten bleiben maskiert in der Vorschau, solange die Verbindung sie nicht sehen darf.

Darf die Verbindung den aktuellen Stand nicht lesen, etwa weil Sie das Lesen nicht erlaubt haben, sagt die Vorschau das und zeigt nur die neuen Werte.

Ihr KI-Client fasst den Vorschlag womöglich in eigenen Worten zusammen. Maßgeblich ist, was TixFin zeigt: Weichen die Zusammenfassung des Clients und die Vorschau von TixFin voneinander ab, vertrauen Sie der Vorschau.

Bestätigen

Wie Sie bestätigen, hängt von Ihrem Client ab:

  • Clients, die Sie selbst fragen können, zeigen das Bestätigungsformular von TixFin mit den Änderungen und einer Auswahl apply. Nur ein Ja wendet den Vorschlag an. Ein Nein ändert nichts, und der Vorschlag bleibt offen, bis er abläuft.
  • Jeder andere Client zeigt Ihnen den Vorschlag im Gespräch und wendet ihn mit proposal_apply an, sobald Sie zustimmen.

TixFin sieht Ihr Gespräch nicht. Bei der zweiten Art von Client geben Sie Ihr Ja dem Client, nicht TixFin. Erlauben Sie Änderungen deshalb nur einem Client, dem Sie zutrauen, Sie zu fragen, und lesen Sie das Ergebnis, das er meldet.

Einmal angewendet, 15 Minuten offen

  • Ein Vorschlag läuft 15 Minuten nach seiner Erstellung ab. Ein abgelaufener wird abgelehnt; bitten Sie den Client um einen neuen.
  • Ein Vorschlag wird einmal angewendet. Erneutes Anwenden wird abgelehnt; proposal_get zeigt, dass er angewendet wurde, und seine Änderungen gegen den aktuellen Stand.
  • Ein Vorschlag gilt nur für Sie, auf der Verbindung und dem Client, die ihn erstellt haben, und in seinem Projekt. Ein anderes Mitglied, ein anderer Client oder eine andere Anmeldung kann ihn nicht anwenden.
  • Jeder Schritt wird beim Anwenden erneut geprüft, gegen dieselben Berechtigungen, Scopes und dasselbe Projekt wie bei der Erstellung.
  • Eine Verbindung wendet jeweils nur einen Vorschlag an.

Wenn etwas schiefgeht

Die Schritte laufen der Reihe nach, und der erste Schritt, der nicht gelingt, beendet den Lauf. Der Client erhält einen Bericht, der jeden Schritt als applied (angewendet), refused (abgelehnt), outcome unknown (Ausgang unbekannt) oder not sent (nicht gesendet) nennt.

  • TixFin hat den ersten Schritt abgelehnt (etwa wegen einer fehlenden Berechtigung oder eines ungültigen Werts): Nichts hat sich geändert, und der Vorschlag bleibt offen, bis er abläuft.
  • Ein späterer Schritt wurde abgelehnt: Die Schritte davor sind angekommen und bleiben. TixFin macht sie nicht rückgängig. Der Vorschlag ist verbraucht.
  • Ausgang unbekannt: TixFin hat nicht geantwortet oder ist beim Antworten gescheitert, der Schritt ist also vielleicht angekommen, vielleicht nicht. Der Vorschlag ist verbraucht und wird nie wiederholt, damit nichts zweimal läuft. Lassen Sie den Client den aktuellen Stand lesen, bevor Sie einen neuen Vorschlag für das anfordern, was noch fehlt.

Ein Event in einem Zug planen

event_plan erstellt einen Vorschlag für ein neues Event:

  1. das Event, immer als Entwurf angelegt, nicht im Verkauf;
  2. bis zu 20 Ticketarten dafür;
  3. bis zu 10 Gruppenrabatte dafür;
  4. eine Shopseite, versteckt angelegt.

Jeder spätere Schritt gilt dem Event, das der erste Schritt anlegt; wo die Vorschau den Wert noch nicht kennen kann, steht set to step 1's "id", once it has run. Ein Rabatt senkt, was Käufer zahlen, deshalb ist ein Plan mit einem Rabatt ein Geld-Vorschlag: Er braucht Aktionen ausführen, die Geld bewegen oder Käufer erreichen und einen frischen zweiten Faktor, siehe unten. Die Spielstätte und ein Saalplan aus einer Vorlage sind eigene Vorschläge (venue_upsert, seatmap_apply_template). Wenn der Entwurf passt, schlägt event_publish vor, das Event in den Verkauf zu bringen.

Geld und der zweite Faktor

Manche Vorschläge bewegen Geld, senken, was Käufer zahlen, stellen Tickets aus oder lassen ein, oder erreichen Ihre Käufer: Erstattungen, Umtausch, ein Event absagen, verschieben oder löschen, eine Kampagne senden, Gästelisten-Anmeldungen bestätigen (jeder Gast erhält eine E-Mail), Gästelisten-Links, einen Gruppenrabatt anlegen oder löschen, Pakete, ein Produkt oder den Plan eines Saalplans ändern, externe Einlässe importieren, die Designeinstellungen des Shops ändern, eine Entwurfsbestellung für einen Käufer anlegen und einen Badge-Druck wiederholen, und nach dem, was sie verlangen, eine Ticketart für ein bestehendes Event oder die Erstattungsregeln, den Beginn, den Saalplan oder das Land der Spielstätte eines Events ändern. Die Werkzeugreferenz listet sie. Ein Vorschlag mit einem solchen Schritt ist als Ganzes ein Geld-Vorschlag.

Einen Geld-Vorschlag anzuwenden braucht einen zweiten Faktor, der in den letzten zehn Minuten auf dieser Verbindung bestätigt wurde. Die Anmeldung in Ihrem Browser zählt nicht, und die Bestätigung hier ändert Ihre Browser-Sitzung nicht.

Der Client wendet den Vorschlag an. Hat die Verbindung keinen frischen zweiten Faktor, sendet TixFin einen Link zur Seite Mit deinem zweiten Faktor bestätigen. Ein Client, der Links für Sie öffnen kann, öffnet ihn; jeder andere zeigt Ihnen den Link in seiner Antwort.
Öffnen Sie den Link, melden Sie sich an, falls nötig, und prüfen Sie den Namen des Clients, seine Client-ID, wann Sie ihn verbunden haben und was Sie ihm erlaubt haben.
Geben Sie den Code aus Ihrer Authenticator-App ein und klicken Sie auf Bestätigen.
Kehren Sie zu Ihrem Client zurück und lassen Sie ihn den Vorschlag erneut anwenden. Bevor Sie bestätigt haben, hat sich nichts geändert.

Die Bestätigung gilt zehn Minuten für die Verbindung, nicht nur für einen Vorschlag, wie ein zweiter Faktor in Ihrem Browser. Hier funktioniert nur ein Code aus einer Authenticator-App, kein Passkey und kein Backup-Code. Ohne Zwei-Faktor-Authentifizierung bittet die Seite Sie, sie zuerst einzurichten. Jeder Link gilt zehn Minuten und ist verbraucht, sobald Sie mit einem richtigen Code bestätigt haben; ein falscher Code lässt ihn offen.

TixFin prüft den zweiten Faktor bei jeder Geld-Anfrage selbst erneut, nicht nur, wenn der Client den Vorschlag anwendet. Laufen die zehn Minuten ab, bevor der erste Schritt gesendet ist, ändert sich nichts, der Vorschlag bleibt offen und Sie erhalten einen neuen Link. Laufen sie zwischen zwei Schritten ab, bleiben die Schritte davor angewendet, und der Bericht nennt den zweiten Faktor als Grund für den Abbruch.

Eine Absage erstattet selbst nichts. Ein Event abzusagen öffnet seinen Erstattungsauftrag, sobald die Absage die Bestellungen erreicht. Die Erstattungen zu starten ist ein eigener Vorschlag, der nichts anderes enthalten darf: Seine Vorschau zeigt den Status des Auftrags, die offenen Bestellungen, den Betrag, den er höchstens erstattet, und was Geschenkkarten bezahlt haben. Ihr Ja zu einer Absage startet also nie Erstattungen. Die Erstattungen selbst laufen über dieselbe Operation, Berechtigungen und Prüfungen wie im Dashboard.

Was festgehalten wird

Eine Änderung über einen KI-Client wird im Prüfprotokoll von TixFin als Ihre festgehalten, mit der ID des Clients daneben, überall dort, wo dieselbe Änderung aus dem Dashboard festgehalten wird.

Verwandte Seiten

Auf dieser Seite