Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > agorum core Module und Plugins > ALBERT | AI Suite > ALBERT| AI KI-Tools-Dokumentationen


chat_read – Übergebenen ALBERT | AI Chat lesen (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: Read ALBERT | AI chat

Interner Name: agorum_ai_agents_chat_read

Was macht das Tool?

Das Tool liest einen Chat aus ALBERT | AI, den ein Benutzer an einen externen Coding Agent wie Claude Code oder Codex übergeben hat. Es liefert alles, was der Coding Agent braucht, um die Aufgabe in seiner eigenen Umgebung weiterzuführen:

Das Tool liest nur und verändert nichts im System. Den Stand seiner Arbeit meldet der Coding Agent mit chat_update in den Chat zurück.

Empfohlener Einsatzzweck

Ein Coding Agent ruft das Tool als Erstes auf, wenn er einen Auftrag mit einer Chat-ID bekommt. Ohne gelesenen Chat hat er die Aufgabe nicht. Wie Benutzer einen Chat an einen Coding Agent übergeben, beschreibt Mit ALBERT | AI Coding Agents arbeiten.

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.
includeHistory
(optional)
Legt fest, ob der Verlauf des Chats mitgeliefert wird.
Standard: true
historyLimit
(optional)
Liefert nur die letzten Einträge des Verlaufs. 0 liefert die letzten 500.
Standard: 50
Maximum: 500
resolveVariables
(optional)
Löst die Variablen im Systemprompt auf, etwa den Namen des Benutzers und das aktuelle Datum. Dabei werden auch Tool-Aufrufe ausgeführt, die der Prompt einbettet, wie es der Chat selbst auch tun würde. Mit false liefert das Tool den Prompt ohne Auflösung.
Standard: true
includeToolDetails
(optional)
Liefert die vollständigen Definitionen der Tools der KI-Voreinstellung statt nur ihrer Namen. Die Definitionen sind der mit Abstand größte Teil der Antwort.
Standard: false

Rückgabe

Das Tool liefert ein JSON-Objekt, unter anderem mit diesen Angaben:

Feld Beschreibung
chatId, title, titleSet Kennung und Titel des Chats. titleSet: false bedeutet, dass der Chat noch seinen allgemeinen Standardnamen trägt.
owner Besitzer des Chats mit Anmeldename, vollständigem Namen und Sprachcode.
identity Name und Regel, unter denen der Coding Agent antwortet. Ist das Feld null, gehört der Chat keinem Coding Agent: Er wurde nicht übergeben oder der Benutzer hat ihn zurückgeholt.
running, externalAgent Ob gerade gearbeitet wird und welcher Coding Agent den Chat übernommen hat.
systemPrompt, variablesResolved Der Systemprompt der KI-Voreinstellung und ob seine Variablen aufgelöst sind.
preset Die KI-Voreinstellung des Chats mit den Namen ihrer Tools. Der Coding Agent deckt diese Fähigkeiten mit eigenen Werkzeugen ab.
task, attachments Die Aufgabe des Benutzers und die Anhänge des Chats.
history, historyTotal, historyTruncated, historyShortened Der Verlauf, die Gesamtzahl seiner Einträge und ob bzw. wie viele ältere Einträge weggelassen wurden.
skill Name und UUIDs des Skills albert-ai-chat, den der Coding Agent vor der Arbeit liest.

Grenzen

Beispiel-Prompt

Chat-ID: 1234abcd-...
Lies den Chat mit chat_read und arbeite die Aufgabe nach dem Skill albert-ai-chat ab.

Tipps und Tricks

Tipp: Setzen Sie includeToolDetails nur, wenn der Coding Agent die genauen Definitionen der Tools wirklich braucht. Die Namen der Tools reichen meist, um die Fähigkeiten des Chats zu erkennen.