Erinnerungen sind kurze Fakten über einen Endnutzer, die das Brain bei jeder Anfrage dieser Person berücksichtigt, zum Beispiel „bevorzugt kurze Antworten“ oder „Ansprechpartnerin im Einkauf ist Frau Berger“. Das Brain legt solche Erinnerungen selbst an. Über die Schnittstelle kannst du sie zusätzlich anlegen, durchsuchen, ändern und löschen.
Wie Erinnerungen wirken
Jede Erinnerung gehört zu genau einem Endnutzer deines Teams. Bei späteren Anfragen mit derselben external_identifier ziehen wir die passenden Erinnerungen als Kontext heran. Andere Endnutzer sehen sie nie. Wie das Brain grundsätzlich funktioniert, steht in Brain nutzen: Unterhaltungen je Endnutzer speichern und fortsetzen.
Alle Aufrufe brauchen external_identifier, damit klar ist, um welche Person es geht.
Eine Erinnerung anlegen
curl -X POST https://api.flowmodels.one/v1/memories \
-H "Authorization: Bearer at_dein_schluessel" \
-H "Content-Type: application/json" \
-d '{"external_identifier": "kunde-1042", "text": "Bevorzugt kurze Zusammenfassungen mit drei Stichpunkten.", "kind": "preference"}'
textist Pflicht und darf höchstens 10.000 Zeichen lang sein.kindist optional und hilft dir, Erinnerungen zu ordnen.
Die Antwort enthält die id der Erinnerung und revision: 1. Heb die Revision auf, du brauchst sie beim Ändern.
Eine Erinnerung von Hand anzulegen funktioniert auch dann, wenn die automatische Erinnerung für diesen Endnutzer abgeschaltet ist.
Erinnerungen auflisten oder durchsuchen
GET /v1/memories beantwortet zwei verschiedene Fragen:
Alle Erinnerungen auflisten, die neuesten zuerst:
curl "https://api.flowmodels.one/v1/memories?external_identifier=kunde-1042&limit=50" \
-H "Authorization: Bearer at_dein_schluessel"
Das ist kostenlos. Weitere Seiten holst du mit after und dem Wert aus last_id, solange has_more auf true steht.
Nach Bedeutung suchen mit query:
curl "https://api.flowmodels.one/v1/memories?external_identifier=kunde-1042&query=Ansprechpartner" \
-H "Authorization: Bearer at_dein_schluessel"
Die Suche findet auch Einträge, die das Suchwort nicht wörtlich enthalten. Sie ist kostenpflichtig, weil wir den Suchtext dafür in einen Vektor umwandeln. Der Suchtext darf höchstens 1.000 Zeichen lang sein. Ein Suchergebnis ist eine Rangfolge ohne weitere Seiten: has_more steht auf false und last_id auf null.
Eine Erinnerung ändern
curl -X PATCH https://api.flowmodels.one/v1/memories/018f1234-5678-7abc-9def-0123456789ab \
-H "Authorization: Bearer at_dein_schluessel" \
-H "Content-Type: application/json" \
-d '{"external_identifier": "kunde-1042", "text": "Bevorzugt sehr kurze Zusammenfassungen.", "revision": 1}'
Mit revision sagst du, welchen Stand du ändern willst. Hat sich die Erinnerung inzwischen geändert, zum Beispiel durch einen zweiten Prozess deiner Anwendung, antwortet die API mit 409 memory_revision_conflict. Hol dann den aktuellen Stand neu ab, gleiche deine Änderung ab und schick sie mit der neuen Revision noch einmal. So überschreibst du nie versehentlich eine neuere Fassung.
Eine Erinnerung löschen
curl -X DELETE https://api.flowmodels.one/v1/memories/018f1234-5678-7abc-9def-0123456789ab \
-H "Authorization: Bearer at_dein_schluessel" \
-H "Content-Type: application/json" \
-d '{"external_identifier": "kunde-1042"}'
Willst du alle Daten einer Person auf einmal löschen, nimm stattdessen die Löschung des Endnutzers, siehe Endnutzer per API verwalten und löschen: Metadaten, Löschung und Löschbeleg.
Automatische Erinnerungen abschalten
Bei neuen Endnutzern legt das Brain Erinnerungen aus den Unterhaltungen automatisch an. Möchtest du das für eine Person nicht, schaltest du es ab:
curl -X PATCH https://api.flowmodels.one/v1/end-users/018f1234-5678-7abc-9def-0123456789ab \
-H "Authorization: Bearer at_dein_schluessel" \
-H "Content-Type: application/json" \
-d '{"memory_extraction_enabled": false}'
Hier verwendest du die id des Endnutzers aus POST /end-users, nicht deine eigene Kennung.
Wenn etwas nicht klappt
404 memory_not_found: Die Erinnerung gibt es nicht, oder sie gehört zu einem anderen Endnutzer. Prüfe dieexternal_identifier.400 invalid_cursor: Der Wert inafterstammt nicht aus einer vorherigen Seite. Bei einer Suche mitquerygibt es keine weiteren Seiten.409 memory_revision_conflict: Siehe oben, aktuellen Stand neu abrufen.
Wie viele Erinnerungen ein Endnutzer hat, siehst du auch in der Oberfläche unter Endnutzer in der Spalte Erinnerungen.
