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
Hinweise:
Anzeigename: Read ALBERT | AI chat
Interner Name: agorum_ai_agents_chat_read
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:
albert-ai-chat, der beschreibt, wie mit einem übergebenen Chat zu arbeiten istDas 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.
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.
| 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: 50Maximum: 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 |
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. |
historyTruncated ist dann true und historyShortened nennt die Anzahl.Chat-ID: 1234abcd-... Lies den Chat mit chat_read und arbeite die Aufgabe nach dem Skill albert-ai-chat ab.
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.