Objects

Anirag arbeitet mit fünf Kern-Objekten. Jedes hat einen id, created_at und updated_at.

Workspace

Die oberste Isolations-Ebene.

json{
  "id": "ws_01HKQR...",
  "name": "ops",
  "region": "eu-fra1",
  "created_at": "2026-04-10T08:00:00Z",
  "members": 12,
  "documents": 1842,
  "settings": {
    "default_model": "claude-sonnet-4-6",
    "audit_retention_days": 90,
    "byok": true
  }
}

Document

Eine hochgeladene Datei plus Metadata.

json{
  "id": "doc_01HKQR...",
  "workspace": "ws_01HKQR...",
  "name": "handbuch.pdf",
  "mime_type": "application/pdf",
  "bytes": 4194304,
  "page_count": 124,
  "chunks_count": 287,
  "status": "indexed",
  "acl": ["group:engineering", "group:operations"],
  "metadata": { "tags": ["wartung"], "version": "v3.2" }
}

Chunk

Ein Embedding-Chunk eines Dokuments. Wird beim Query-Filter geprüft.

json{
  "id": "chunk_01HKQR...",
  "document": "doc_01HKQR...",
  "page": 42,
  "tokens": 487,
  "text": "Wartung der Hydraulik erfolgt alle 500 Betriebsstunden ...",
  "embedding_model": "text-embedding-3-small",
  "acl": ["group:engineering"]
}

Citation

Wird als Teil einer Query-Antwort zurückgegeben.

json{
  "doc_id": "doc_01HKQR...",
  "doc_name": "handbuch.pdf",
  "page": 42,
  "chunk_id": "chunk_01HKQR...",
  "score": 0.87
}

Session

Optionaler Container für Multi-Turn-Conversations.

json{
  "id": "sess_01HKQR...",
  "workspace": "ws_01HKQR...",
  "user": "usr_01HKQR...",
  "messages_count": 8,
  "started_at": "2026-04-15T09:00:00Z"
}

Sessions sind nach 24 h inaktiv automatisch geschlossen.