chat_update – Stand in einen übergebenen ALBERT | AI Chat melden (ALBERT | AI Tool)

Hinweise:

Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins ALBERT | AI Agents (Bestandteil der ALBERT | AI Suite). Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.
Wie Sie die KI-Tools in Ihren KI-Voreinstellungen verwenden, erfahren Sie hier: ALBERT | AI Agents KI-Tools einrichten

Anzeigename: Update ALBERT | AI chat

Interner Name: agorum_ai_agents_chat_update

Was macht das Tool?

Mit diesem Tool meldet ein externer Coding Agent wie Claude Code oder Codex den Stand seiner Arbeit in einen übergebenen ALBERT | AI Chat zurück. Solange der Coding Agent arbeitet, ist der Chat für den Benutzer gesperrt. Die Meldungen sind das Einzige, was der Benutzer im Chat von der Arbeit sieht.

Eine abschließende Meldung gibt den Chat nicht zurück. Er bleibt dem Coding Agent zugeordnet, bis der Benutzer ihn über Kontrolle übernehmen zurückholt. So schreibt niemand gleichzeitig in dieselbe Unterhaltung.

Empfohlener Einsatzzweck

Der Coding Agent ruft das Tool in vier Situationen auf:

Direkt nach dem Lesen des Chats mit chat_read: Status running, damit der Benutzer sieht, dass die Arbeit begonnen hat.
Während langer Aufgaben: eine kurze Zeile in note, woran der Coding Agent gerade arbeitet.
Am Ende: Status finished oder failed mit einer kurzen Zusammenfassung. Dieser Aufruf ist Pflicht, sonst bleibt der Chat als beschäftigt markiert.
Wenn der Coding Agent später am selben Chat weiterarbeitet: erneut Status running.

Das Tool ist Bestandteil der Toolgruppe external_use_tools für externe Coding Agents und steht damit über MCP zur Verfügung.

Funktionsbeschreibung

Parameter	Beschreibung
chatId (Pflicht)	Die Chat-ID, die mit dem Auftrag übergeben wurde.
status (optional)	Neuer Stand der Arbeit: `running`, `finished` oder `failed`.
note (optional)	Kurze Zeile zum aktuellen Schritt, die der Benutzer während der Arbeit sieht.
summary (optional)	Abschließende Zusammenfassung. Sie wird als Nachricht im Chat gespeichert, außer der Chat zeigt die Sitzung des Coding Agents selbst an. Kurz halten, in der Sprache des Chat-Besitzers, und auf angelegte oder geänderte Objekte mit `[Name](object:UUID)` verweisen.
title (optional)	Kurzer Titel für den Chat in der Sprache des Chat-Besitzers. Er wird nur übernommen, solange der Chat noch keinen eigenen Titel hat (`titleSet: false` in der Antwort von `chat_read`). Ein Titel, den der Benutzer vergeben hat, wird nie überschrieben. Maximal 60 Zeichen.

Rückgabe

Feld	Beschreibung
chatId, status, running	Der Chat und sein neuer Stand.
titleSet	Ob der Chat jetzt einen eigenen Titel trägt.
mirrored	`true`: Der Chat zeigt die Sitzung des Coding Agents laufend an. Seine Antworten stehen dann schon im Chat, gesetzt wird nur der Stand; die Zusammenfassung wird nicht gespeichert.
aborted	`true`: Der Benutzer hat den Chat zurückgeholt. Der Coding Agent beendet die Arbeit am Chat und sagt das dem Benutzer.

Beispiel-Prompt

Melde mit chat_update den Status running für den Chat 1234abcd-...
und setze den Titel "Changelog Oktober prüfen".

Tipps und Tricks

Tipp: Der Skill albert-ai-chat beschreibt, wann und wie ein Coding Agent sich meldet. Binden Sie ihn ein, damit der Coding Agent die Meldungen auch in langen Sitzungen nicht vergisst.