chat ask
chat ask hängt einen einzelnen Turn an eine bestehende Konversation, streamt die Antwort und beendet sich. Kein Prompt-Loop, kein interaktiver Terminal nötig — gedacht für Skripte, Pipes und geplante Aufrufe. Wer lieber im Browser fragt, nutzt den Chat der Web-Oberfläche.
Wofür ist das?
- Skript- oder Cron-Aufrufe. Eine Frage in einer Pipeline stellen, die Antwort weiterverarbeiten — ohne dass jemand am Terminal sitzt.
- Mehrfach asken. Wiederholte
chat ask-Aufrufe gegen dieselbe NanoID hängen weitere User-Turns an dieselbe Konversation an. Das ist die Headless-Variante eineschat continue. - Headless statt Browser. Frage und Antwort gibt es auch grafisch im Chat der Web-Oberfläche;
chat askist der Weg ohne Oberfläche — eine Frage rein, die Antwort raus, ohne dass jemand am Terminal oder im Browser sitzt.
Eine ganz neue Konversation muss zuerst über chat start angelegt werden — chat ask braucht eine NanoID, weil es keinen Setup-Pfad für einen leeren Verlauf hat.
Aufruf
apparat chat ask V1StGXAA "Welche Personen kennt der Vault?" apparat chat ask V1StGXAA "…" --vault=demo apparat chat ask V1StGXAA "…" -v
| Argument / Option | Bedeutung |
|---|---|
id |
Pflicht. NanoID einer existierenden Konversation. |
prompt |
Pflicht. Der User-Turn als Klartext; bei Leerzeichen oder Sonderzeichen quoten. Eine leere Eingabe wird mit Exit 1 abgewiesen. |
| `--vault=<name | path |
-v, --verbose |
Werkzeug-Returns als [tool: <name> → ok] anzeigen und am Ende einen [tokens: prompt=<n>, response=<m>]-Footer ausgeben. |
Beispielausgabe
$ apparat chat ask V1StGXAA "Welche Personen kennt der Vault?" --vault=demo [tool: list_entities_by_type] Im Vault sind aktuell zehn Personen erfasst, darunter Maria Beispiel (V1StGXAA), Anna Schmidt (Bx7tYu3v) …
-v zusätzlich:
$ apparat chat ask V1StGXAA "Welche Personen kennt der Vault?" -v [tool: list_entities_by_type] [tool: list_entities_by_type → ok] Im Vault sind aktuell zehn Personen erfasst, darunter … [tokens: prompt=1842, response=137]
apparat chat show V1StGXAA zeigt anschließend den neuen User-Turn und die Antwort als zusätzliche Einträge im Verlauf.
Wird chat ask als allererster Turn einer noch unbenannten Konversation aufgerufen, vergibt Apparat im Anschluss an die Antwort automatisch einen Titel (kurzer zweiter Sprachmodell-Pass). Bei einem Folge-Turn passiert nichts Zusätzliches — ein einmal gesetzter Titel bleibt stabil; chat retitle ändert ihn auf Wunsch.
Voraussetzungen
- Lokaler Sprachmodell-Dienst läuft und das ursprüngliche Modell der Konversation ist weiterhin gepullt —
chat pingbestätigt beides. - Graph- und Vektor-Index sind aktuell.
chat ask wird vom apparat-Wrapper transparent in den Container delegiert.
Exit-Codes
| Code | Bedeutung |
|---|---|
| 0 | Turn erfolgreich abgeschlossen. |
| 1 | Vault-Auflösung fehlgeschlagen, NanoID unbekannt, Prompt war leer, oder ein Turn ist im Streaming-Pfad fehlgeschlagen. |
Verwandt
chat start— eine neue Konversation interaktiv eröffnen.chat continue— eine bestehende Konversation interaktiv fortsetzen.chat show— den vollständigen Verlauf einer Konversation anzeigen.chat retitle— den automatisch vergebenen Titel einer Konversation neu setzen.