IDas Fragenbuch
Verbindlich beantwortet.
Alles, was Teams fragen, bevor sie SQAI einem Agenten übergeben — was es grundsätzlich nicht kann, was die Maschine verlässt, was ein Replay beweist, was es kostet. Knappe Antworten, echte Zahlen und die Seiten mit der vollständigen Geschichte.
IIWas es ist, wie schnell, wo es läuft
Produkt
Q01Was ist SQAI?
Structured Query AI — das kontrollierte, schreibgeschützte Structured-Data-Tool für KI-Agenten. Eine Frage wird zu einem typisierten, richtliniengeprüften Plan; der Plan läuft auf einer deterministischen Engine; die Antwort kommt mit Hashes zurück, die sie wiederholbar machen.
Eine Oberfläche deckt Dateien und Live-Datenbanken ab, zusammen mit 4.778 schreibgeschützten Compute-Fähigkeiten in 445 Modulen — von Medianen bis zur Optionspreisberechnung.
stats.median · finance.npv · option_pricing.black_scholes_call
Q02Ist es schnell?
Es gibt keinen Cold Start pro Abfrage. Die Query-Ebene läuft in-process — bei typischen Dateien unter einer Millisekunde.
Compute wird einmalig bereitgestellt: Der allererste Aufruf lädt die signierte Laufzeit herunter und initialisiert sie in etwa 110 Sekunden. Danach bleibt der Daemon warm und resident; ein warmer Compute-Aufruf misst 0,83–0,93 ms.
finance.npv = 0.83–0.93 ms (warm) · first provision ≈ 110 s
Q03Welche Plattformen werden unterstützt?
Die signierte Laufzeit wird für Apple-Silicon-macOS und x64-Linux ausgeliefert. Unter Windows gibt ein managed-compute-Aufruf einen strukturierten, benannten Fehler zurück, anstatt abzustürzen.
Die Query-Ebene läuft überall. Ebenso die self-hosted und hosted Modi, da Compute an eine Remote-Engine übergeben wird. Node 20 oder neuer; Python 3.10 oder neuer.
darwin-arm64 · linux-x64 · node ≥ 20 · python ≥ 3.10
Q04Kann ich eine kleinere Laufzeit ausliefern?
Ja. Standardmäßig installiert SQAI das fixierte Bundle, das die gesamte exponierte Oberfläche abdeckt. Benennen Sie nur die benötigten Module, und der Build-Service kompiliert ein signiertes, sha256-fixiertes Bundle für diese Teilmenge, gecacht nach Filter-Hash.
Gefilterte Daemons erhalten eigene Sockets und Ports und kollidieren daher nie mit dem vollständigen.
SQAI_RUNTIME_MODULES → POST /v1/runtime/build · sha256-pinned
Q05Etwas ist fehlgeschlagen. Wie debugge ich?
Die Agent-Tools werfen nie. Fehler kommen als strukturierte Ausgabe mit einem Status und einem Code zurück, der die Ablehnung benennt — eine Richtlinienablehnung, eine unbekannte Fähigkeit, ein fehlender Seed.
Für alles unterhalb der Tools prüft ein einziger Befehl die Installation, die Laufzeit und die sprachübergreifende Parität in einem Durchlauf.
output.status === "error" · sqai doctor --parity --json
IIISchreibschutz durch Konstruktion, nicht durch Flag
Sicherheit
Q06Ist es wirklich schreibgeschützt?
Ja — durch Konstruktion, nicht durch Berechtigung. Das Modell verfasst typisierte Absichten, nie SQL; SQAI validiert sie gegen einen hash-fixierten Fähigkeitsvertrag, wendet Ihre Richtlinie an und führt erst dann aus.
Von 4.778 Fähigkeiten sind 4.574 exponiert: nur jene, die schreibgeschützt und deterministisch sind oder bei Angabe eines Seeds deterministisch werden. Die 204, die den Test nicht bestehen — einschließlich aller Schreiboperationen — fehlen in der paketierten Oberfläche. Keine Einstellung kann erreichen, was nie ausgeliefert wurde.
read_only && (deterministic || deterministic_when_seeded)
Q07Wie gebe ich einem Agenten schreibgeschützten Zugriff auf meine Daten?
Registrieren Sie Ihre Quellen im Code und übergeben Sie dem Modell das Tool-Set — genau drei Tools. Eines listet auf, was existiert, eines zeigt einen Plan ohne Ausführung in der Vorschau, und eines führt gegen die schreibgeschützte Oberfläche aus.
Eine schreibgeschützte Datenbankrolle ist ein Flag, das jemand aufheben kann. Eine Oberfläche, die ohne Schreibfähigkeiten kompiliert wurde, nicht.
sqai.tools() → listSources · explainQuery · queryData
Q08Wie blockiere ich DELETE oder DROP in LLM-generiertem SQL?
Sie filtern das SQL nicht. Sie hören auf, es zu erzeugen.
String-Filter und Schreibschutz-Flags sichern eine Sprache, die immer einen Schreibvorgang ausdrücken kann — und prompt-injiziertes SQL gelangt in der Ausgabe des Modells an, jenseits Ihres Eingabe-Sanitizers. SQAIs Modell schreibt einen typisierten Plan in einer Grammatik ohne Schreibformen: DELETE wird nicht abgelehnt, es ist unschreibbar.
kind: "query" | "computation" · version: "1"
Q09Kann das Modell meine Richtlinie ausweiten?
Nein. Die Richtlinie ist im Code fixiert, wenn Sie den Client erstellen, und wird in-process vor jeder Ausführung geprüft. Die Tool-Schemas tragen kein Allow-List-Feld irgendeiner Art, sodass es nichts gibt, das ein Prompt erreichen könnte.
Eine explizite Allow-List kann nur einschränken. Eine Fähigkeit außerhalb der zulässigen Oberfläche zu benennen schlägt dennoch fehl — die paketierte Oberfläche ist die Obergrenze.
policy_denied_source · policy_denied_field · policy_denied_function
Q10Gibt es eine Notfallluke?
Ja — für Menschen, nie für Modelle. Die ungesicherte Laufzeit liegt hinter einem separaten Import, der Vertrag, Richtlinie und Seed-Prüfungen umgeht, und wird dem Agent-Tool-Set nie exponiert.
Ein Entwickler kann bewusst aussteigen. Ein Agent kann sie mit keiner Eingabe erreichen.
import { getUnsafeRuntime } from "@thyn-ai/sqai/unsafe"
IVWas abfließt, was verbindet, was trainiert
Daten
Q11Welche Daten verlassen mein Gerät?
Im standardmäßigen lokalen Modus keine. Die Query-Ebene wird prozessintern aufgelöst, und die Compute-Runtime ist ein signierter Daemon auf Ihrem Gerät. Der einzige ausgehende Aufruf ist der Erststart-Download des Runtime-Bundles — Engine-Code, nicht Ihre Daten.
Zeigt eine Umgebungsvariable auf eine selbst gehostete oder gehostete Engine, werden Pläne dorthin übermittelt — mit verschlüsselten Zugangsdaten, ohne Datenkopie.
local: in-process · self_hosted: SQAI_ENGINE_URL · api: SQAI_API_KEY
Q12Welche Datenquellen kann ich abfragen?
Prozessintern ohne Schlüssel: CSV, TSV, JSON, In-Memory-Zeilen und SQLite — sowie Excel und Parquet in Python. Über eine Engine: PostgreSQL, MySQL, Oracle mit gebündeltem Thin-Mode-Treiber, SQL Server, Snowflake, BigQuery, ClickHouse, Redshift, Objektspeicher, Redis, Neo4j, Elasticsearch, REST-APIs und Git-Repositories.
Jede Quelle präsentiert dieselbe typisierte Form — nachgelagerter Code kann CSV nicht von Snowflake unterscheiden. Quellen sind nach der Registrierung unveränderlich.
SqaiSource { fields, typed_fields, row_count, schema_revision }
Q13Trainiert SQAI auf meinem Schema oder meinen Daten?
Niemals. SQAI ist kein Modell und trainiert nichts — es gibt keine Lernschleife. Im lokalen Modus verlassen Ihre Daten das Gerät überhaupt nicht.
Das einzige Modell in der Schleife ist das von Ihnen mitgebrachte, und es sieht höchstens 25 Zeilen pro Ergebnis. Alles Darüber hinaus wird abgeschnitten — deklariert, nie stillschweigend — wobei der vollständige Wert unter einer opaken Ergebnis-ID gespeichert wird, die nach 15 Minuten abläuft.
maxRowsToModel 25 · maxCellsToModel 250 · maxBytesToModel 32,000
VGleiche Frage, gleiche Bytes
Determinismus
Q14Wie ist es deterministisch — und identisch in TypeScript und Python?
Deterministisch innerhalb des deklarierten Ausführungsrahmens — 64-Bit-Floats, ein einzelner Thread, eine fixierte Runtime — und jedes Ergebnis dokumentiert diesen Rahmen, ohne zu viel zu versprechen.
Der kanonische Serialisierer ist konformitätsgesperrt über beide SDKs hinweg, sodass dieselbe Berechnung in TypeScript und Python dieselbe Zahl und byteidentische Hashes liefert.
finance.npv(0.1, [-1000, 300, 420, 560, 680]) = 505.020148896933computation_hash b74f67d0… · TS ≡ PY
Q15Wie verhindern Sie, dass ein LLM Zahlen erfindet?
Indem es die Arithmetik nie selbst ausführt. Fragt man ein Modell nach einer Summe über 200 Zeilen, erhält man eine plausible Zahl — ohne jedes Signal, dass sie falsch ist.
Mit SQAI wählt das Modell nur die Berechnung; die Engine führt sie aus. In unserem Genauigkeits-A/B-Test stieg dasselbe Modell bei quantitativen Fragen von 0 von 16 auf 16 von 16, sobald die Engine die Berechnung übernahm.
accuracy A/B: 0/16 → 16/16
Q16Lässt sich die Antwort eines Agenten wiederholen?
Ja — dafür sind die Hashes da. Jedes Ergebnis trägt einen Plan-Hash, einen vor der Ausführung bekannten Invokations-Hash, einen danach bekannten Berechnungs-Hash sowie einen Determinismus-Umschlag, der Runtime-Version, Plattform, Präzision und Seed festhält.
Führen Sie die Invokation Monate später im selben Rahmen erneut aus, stimmt der Hash bytegenau überein. Hat sich das zugrundeliegende Schema verändert, erhalten Sie einen benannten Schema-Revisions-Konflikt — keine stillschweigend abweichenden Zahlen.
run1 b74f67d0d7a594aa7ac91f6291612452aa8ccdf603351ebc8d801a6fddd91bc8run2 b74f67d0d7a594aa7ac91f6291612452aa8ccdf603351ebc8d801a6fddd91bc8identical: true
VIWas kostenlos ist, was gesperrt ist
Preise
Q17Benötige ich einen API-Schlüssel oder ein Konto?
Nein. Der lokale Modus ist ohne Konfiguration nutzbar — kein Schlüssel, kein Konto, keine Karte. Die Runtime richtet sich beim ersten Compute-Aufruf selbst ein.
Die Anmeldung ist optional und verwendet einen Gerätecode; sie stellt eine Offline-Lizenz aus, die ein signiertes Token überträgt — niemals Ihre Daten. Schlüssel existieren nur, um auf eine andere Engine zu verweisen.
sqai login → RFC 8628 device code · WDJB-MJHT
Q18Ist SQAI kostenlos oder kostenpflichtig?
Lokale Entwicklung und verwaltetes Compute sind kostenlos — im SDK gibt es keine Lizenzprüfung.
Kostenpflichtige Stufen beschränken Geräte, Lizenzen und kommerzielle Rechte — niemals Compute-Funktionen. Developer: kostenlos, ein Gerät, nicht-kommerziell. Pro: 25 $ pro Monat, drei Geräte, kommerzielle Nutzung, asynchrone Jobs, Webhooks, Audit-Trail. Team: 99 $ pro Monat, zehn Geräte, mit rollenbasiertem Zugriff (RBAC) und Lizenzverwaltung.
Developer $0 · Pro $25/mo · Team $99/mo
VIINoch eine Frage
Fragen Sie uns direkt.
Was oben nicht beantwortet ist, verdient eine echte Antwort — von einem Menschen.