Monatsrückblick Oktober 2026 ist online!

[Alex1808]

Aktuelle Test Version	0.9.4
Veröffentlichungsdatum	30.10.2026
Github Link	https://github.com/sadam6752-tech/ioBroker.pi-agent

Hallo zusammen,

der Adapter pi-agent ist jetzt im Latest-Repository und ich suche Tester.

Warum noch ein KI-Adapter?

Ein Sprachmodell an ioBroker anzubinden ist schnell gemacht. Schwierig wird es, wenn das Modell schalten soll:

• Was passiert, wenn ioBroker oder der Adapter mitten in einer Anfrage neu startet? Wird das Licht zweimal geschaltet, oder geht die Anfrage verloren?
• Wer legt fest, was die KI schreiben darf, und wer bestätigt kritische Aktionen?
• Wie bekommt man denselben Agenten in den Admin, nach Telegram und in Skripte, ohne alles mehrfach einzurichten?

pi-agent baut auf dem Agenten-Framework Pi (Durable Harness) auf. Jeder Modell- und jeder Werkzeugaufruf wird vor der Ausführung als Checkpoint gespeichert. Nach einem Neustart oder Absturz läuft die Anfrage an der richtigen Stelle weiter. Ein Schreibvorgang wird nie wiederholt: Das Modell erfährt, dass der Aufruf unterbrochen wurde, und prüft zuerst den aktuellen Wert. Jede Anfrage wird genau einmal beantwortet.

Was der Adapter kann

Lesen und Finden

• Datenpunkte suchen und lesen, mit Typ, Einheit, min/max und erlaubten Werten
• Räume und Funktionen wie in ioBroker angelegt („die Lichter in der Küche“)
• Historie (z. B. über influxdb/history/sql), Log und Benachrichtigungen des Hosts, Status der Instanzen

Schalten – nur mit Erlaubnis

• Tabelle „Schreibrechte“: pro Instanz, Objekt-ID oder Muster festlegen, was geschrieben werden darf, wo eine Bestätigung nötig ist (✅/❌ im Chat) und welche Instanzen neu gestartet werden dürfen
• Simulationsmodus ab Werk an: Der Agent sagt, was er tun würde, schreibt aber nichts
• Befehle an andere Adapter (sendTo), z. B. eine Telegram-Nachricht

Planen und Erinnern

• Erinnerungen („erinnere mich in 2 Stunden …“) und Schreibvorgänge zu einem späteren Zeitpunkt
• Benachrichtigung, wenn ein Datenpunkt eine Bedingung erfüllt („sag Bescheid, wenn die Waschmaschine fertig ist“)
• Wiederkehrende und längere Aktionen über den Adapter fullcalendar, falls installiert

Wartung

• Adapter-Updates aus dem Repository oder von npm, nur für freigegebene Adapter und immer mit Bestätigung (optional, ab Werk aus); pi-agent kann sich auch selbst aktualisieren
• Instanzen neu starten (mit Bestätigung)

Wege zum Agenten

• Chat direkt im Admin (eigener Tab, mehrere Unterhaltungen)
• Telegram und MAX, mit Liste der erlaubten Benutzer
• sendTo(..., 'ask', ...) aus Skripten und anderen Adaptern; ioBroker.assistant kann pi-agent bereits als Anbieter nutzen
• Die Datenpunkte chat.input / chat.answer

Sonstiges

• Anbieter: Anthropic, OpenAI, DeepSeek, Google Gemini, OpenRouter, jeder OpenAI-kompatible Server (z. B. Ollama lokal) oder die systemweiten KI-Einstellungen des Admins
• Langzeitgedächtnis über alle Unterhaltungen hinweg (abschaltbar)
• Backup der Unterhaltungen (täglich oder wöchentlich), optional zusätzlich per SFTP auf ein NAS, mit Wiederherstellung
• Verbrauch (Tokens, Kosten) als Datenpunkte

Installation

Im Admin unter „Adapter“ mit aktivem Repository Beta (latest) nach „pi-agent“ suchen. Voraussetzungen: Node.js 22.19+, js-controller 6.0.11+, Admin 8.0.0+ und ein API-Schlüssel des gewählten Anbieters (für Ollama lokal ist keiner nötig).

Empfehlung für den Start: Simulationsmodus anlassen, ein paar Fragen im Admin-Chat stellen, dann einzelne Datenpunkte in den Schreibrechten freigeben.

Was ich gern wissen möchte

• Läuft es mit eurem Anbieter und Modell?
• Findet der Agent eure Geräte, Räume und Funktionen?
• Wie verhält er sich nach Neustarts mitten in einer Anfrage?
• Fehlermeldungen im Log, unverständliche Einstellungen, fehlende Übersetzungen

Fehler und Wünsche gern hier im Thread oder als Issue auf GitHub:
https://github.com/sadam6752-tech/ioBroker.pi-agent

Bilder

Spoiler

[Alex1808]

pi-agent 0.8.0 - 0.8.2: Skripte, TypeScript und Bestätigung in der Sprache des Satelliten

Hallo zusammen,

seit dem letzten Post sind einige Versionen von ioBroker.pi-agent erschienen. Hier das Wichtigste:

0.8.0 – Der Agent schreibt Skripte
Der Agent kann jetzt Skripte des javascript-Adapters lesen, anlegen, ändern, starten, stoppen und auf die vorige Version zurücksetzen. Zum Beispiel: „Schreib ein Skript, das bei Sonnenuntergang das Licht im Flur einschaltet.“

Die Funktion ist ab Werk aus und richtet sich ausdrücklich an Nutzer, die den Code lesen, bevor sie bestätigen. Ein Skript läuft mit den Rechten des javascript-Adapters, nicht mit denen von pi-agent. Die Schreibrechte und der Simulationsmodus begrenzen ein laufendes Skript also nicht.

Spoiler

Deshalb gibt es mehrere Schutzmechanismen:

• Eigener Ordner: Der Agent schreibt nur in script.js.pi-agent. Andere Skripte, auch globale, ändert er nur mit der zusätzlichen Einstellung „Auch andere Skripte ändern“. Blockly und Rules bleiben schreibgeschützt.
• Jeder Schritt einzeln bestätigt: Speichern, Starten, Stoppen und Zurücksetzen werden jeweils extra bestätigt. Ein neues Skript bleibt gestoppt, bis der Start bestätigt ist.
• Änderung Zeile für Zeile: Der Admin-Chat zeigt die Änderung als Diff, Telegram und MAX zeigen sie, soweit eine Nachricht reicht.
• Hinweise im Code: pi-agent sucht selbst nach exec, require, Dateizugriffen, Objektänderungen, sendTo, Netzwerkaufrufen und setState auf States außerhalb der eigenen Schreibrechte und nennt sie in der Frage. Das ist ein Hinweis, kein Schutz.
• Syntaxprüfung: Fehler gehen zuerst an das Modell zurück. Gefragt wird erst, wenn der Code kompiliert.
• Kontrolle nach dem Start: Der Agent schaut einige Sekunden ins Log der javascript-Instanz und meldet Fehler des Skripts.
• Vorige Versionen: Fünf Versionen pro Skript werden aufbewahrt und landen in den Backups.
• Per Sprache (z. B. über ioBroker.assistant) nur mit eigener Einstellung. Der Code wird dabei nicht vorgelesen, nur was das Skript tut und welche Hinweise pi-agent gefunden hat.
• ab 0.8.1 Neue Skripte können auch in TypeScript angelegt werden, wenn man danach fragt („schreib es in TypeScript“). Bestehende Skripte behalten ihre Sprache. TypeScript wird ebenfalls auf Syntaxfehler geprüft (über stripTypeScriptTypes von Node.js). Typfehler selbst prüft erst der Compiler des javascript-Adapters beim Start.
• 0.8.2 (Danke an @GermanBluefox für den Pull Request!) Die Bestätigungsfrage kommt jetzt in der Sprache, die der Aufrufer mitschickt (ioBroker.assistant sendet die Sprache seiner Satelliten), statt in der Systemsprache.
  Das Log zeigt, was gehört und wie entschieden wurde.

Adapter-Updates per Chat (seit 0.7.0)

Spoiler

Mit „Adapter-Updates erlauben“ (Tab „Schreibrechte“, ab Werk aus) kann der Agent Adapter aktualisieren. Zum Beispiel: „Gibt es Updates?“ oder „Aktualisiere telegram.“

• Was es gibt: list_updates zeigt die installierten Adapter, für die es im in ioBroker gewählten Repository eine neuere Version gibt (so wie Admin es anzeigt), und ob der Agent sie aktualisieren darf. check_npm zeigt die neueste Version auf npm, für Adapter, deren Update noch nicht im Repository ist. Dann bietet der Agent das Update von npm an.
• Welche Adapter: nur solche mit einer Instanz, die in den Schreibrechten „Schreiben erlaubt“ hat, und pi-agent selbst. Nie admin oder js-controller, und nur Adapter auf dem Host von pi-agent.
• Jedes Update wird bestätigt mit ✅/❌ im Chat der Unterhaltung, auch ohne „Bestätigung erforderlich“. Ein sendTo-Aufrufer wie ioBroker.assistant kann nur bestätigen, wenn „Bestätigung per Text in sendTo-Unterhaltungen“ eingeschaltet ist. Sonst ist das Update dort gesperrt. Im Simulationsmodus wird nichts installiert.
• Selbst-Update: Aktualisiert sich pi-agent selbst, startet er neu und meldet danach im Chat, ob die neue Version läuft. In der Zwischenzeit steht der State update.pending.

Wie immer: Feedback, Fehlerberichte und Ideen gerne hier oder auf GitHub:
https://github.com/sadam6752-tech/ioBroker.pi-agent

Viele Grüße

Alex