KI-Gedächtnis-Quickstart

Einen Integration-Schlüssel besorgen

Erstellen Sie eine Integration im Conare-Dashboard. Sie erhalten einen bereichsbeschränkten Bearer-Schlüssel (cint_...) – er wird einmal angezeigt und nur als SHA-256-Digest gespeichert, legen Sie ihn also in einen serverseitigen Secret Manager. Liefern Sie ihn niemals an einen Browser aus.

Die Anmeldedaten verifizieren

GET /api/v1/status ist ein nebenwirkungsfreier Smoke-Test: Er validiert den Schlüssel, das Namespace-Routing und den Memory-Plane-Hop, ohne einen Endnutzer anzulegen oder Kontingent zu verbrauchen.

curl https://api.conare.ai/api/v1/status \
  -H "Authorization: Bearer $CONARE_KEY"

Eine Erinnerung speichern

Speichern Sie destillierte Beobachtungen (einen Satz oder Absatz), keine Rohereignisse. Denselben Inhalt zweimal zu speichern ist ein No-Op (deduped: true).

curl https://api.conare.ai/api/v1/memories \
  -H "Authorization: Bearer $CONARE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endUserId": "u_123",
    "content": "User prefers smaller islands, wants to avoid crowds. ASA 104 certified.",
    "containerTag": "profile"
  }'

Sie abrufen

Zwei Retrieval-Modi, wählen Sie je Aufrufsituation:

# Rohe hybride Suche – sub-sekunde, kein LLM. Ihr Agent übernimmt das Reasoning.
curl https://api.conare.ai/api/v1/search \
  -H "Authorization: Bearer $CONARE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "endUserId": "u_123", "query": "charter budget boat type", "limit": 10 }'

# Deep Recall – LLM-synthetisierte, mit Zitaten belegte Antwort (~3–6 s).
# Injizieren Sie `answer` beim Session-Start in den System-Prompt Ihres Agents.
curl https://api.conare.ai/api/v1/recall \
  -H "Authorization: Bearer $CONARE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "endUserId": "u_123", "query": "what do we know about this user and their upcoming trip" }'

Jede Antwort trägt X-Request-Id. Senden Sie Ihre eigene (1–128 Zeichen, zuerst alphanumerisch), um eine Anfrage durch den Conare-Edge und die Memory-Plane zu korrelieren.

Weiter: verstehen Sie Integrationen, Endnutzer und Container oder springen Sie zur vollständigen API-Referenz.

Erste Schritte

Grundlagen

KI-Gedächtnis-Quickstart