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
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 500und wie viele Felder ihren aktuellen Wert behalten. Ein Schritt, der etwas anlegt, hat keinen aktuellen Stand; ein Löschen heißtdeletes 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_applyan, 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_getzeigt, 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:
- das Event, immer als Entwurf angelegt, nicht im Verkauf;
- bis zu 20 Ticketarten dafür;
- bis zu 10 Gruppenrabatte dafür;
- 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.
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
Was Ihr KI-Client kann
Die Werkzeuge, Prompts und Eventübersichten, die TixFin einem verbundenen KI-Client anbietet, und wie er Änderungen vorschlägt
Datenschutz und Sicherheit bei KI-Clients
Wer für das verantwortlich ist, was Ihr KI-Client erhält, was TixFin sieht und protokolliert, und wie eine Verbindung an Sie und Ihre Projekte gebunden ist