Won ist für diejenigen gedacht, die die Erinnerung lesen.

Der größte Teil dieser API antwortet mit Erinnerung. Won antwortet über sie: wie viel von einem Store neu geschrieben wurde und wie weit man ihm vertrauen kann. Gedacht ist das für die lesende Seite, meist für den Assistenten, den Sie bauen, und nicht für die Person, von der die Erinnerungen handeln.

Wontopos ist Won + Topos, ein Ort, an dem Erinnerung wohnt. Won ist der Teil dieses Ortes, der über die Erinnerung Auskunft gibt, statt sie zurückzugeben. Diese Aufrufe sind kostenlos, nur lesend, und rühren den Abruf nie an: Das Fragen kostet Ihre Nutzer nichts und ändert nichts an dem, was gespeichert ist.

Was es heute umfasst

Heute ein Aufruf.

Ein durchgerechnetes Beispiel

Verwenden Sie das Verhältnis, nicht die absolute Zahl. 3 von 40 und 30 von 40 erfordern eine unterschiedliche Behandlung.

r = mem.revisions()
# {"revised": 3, "total": 40, "counts": "…", "excludes": "…"}

if r["revised"] / r["total"] > 0.1:
    system += "Some of what you remember here has been corrected since."

const r = await mem.revisions();
// { revised: 3, total: 40, counts: "…", excludes: "…" }

if (r.revised / r.total > 0.1) {
  system += "Some of what you remember here has been corrected since.";
}

let r = mem.revisions(None).await?;
let (rev, tot) = (r["revised"].as_f64().unwrap_or(0.0),
                r["total"].as_f64().unwrap_or(1.0));
if rev / tot > 0.1 { /* say so in the system prompt */ }

curl -X POST https://api.wontopos.com/api/v1/won/revisions \
  -H "X-API-Key: $WOS_KEY" -H "Content-Type: application/json" \
  -d '{"user_id":"alice"}'

# → {"user_id":"alice","revised":3,"total":40,
#     "counts":"memories a transform has touched (supersede, update, retract, image removed)",
#     "excludes":"deletions — a deleted memory leaves nothing to count"}

counts und excludes werden als Sätze zurückgegeben, nicht als Flags, da der Aufrufer oft ein Modell ist. Löschungen werden nicht gezählt.

Preis und Limits

Beide Obergrenzen antworten mit 429 und Retry-After in Sekunden sowie einer Meldung, die nennt, welche davon erreicht wurde.

Retry-After: 41

{ "error": { "type": "rate_limit_error",
    "message": "This endpoint is free and limited to 10 requests per
                minute, counted per endpoint. Retry in 41s." } }