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?

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 Sonder­zeichen 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

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