> For the complete documentation index, see [llms.txt](https://docs.kiloiot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kiloiot.io/kilo-docs-de/kilo-iot-server/physical-ai.md).
# Physische KI-Plattform für KI-Agenten
Erfahren Sie, wie die Kilo Physical AI-Plattform KI-Agenten über MCP, APIs, getestete Automatisierung, sichere Befehle, Verifizierung und Audit-Trails mit IoT-Geräten verbindet.
KI-Modelle können Ziele interpretieren und komplexe Informationen schlussfolgern. Den Betrieb eines Gebäudes, einer Maschine, einer Flotte oder eines entfernten Standorts zu steuern erfordert eine weitere Ebene: ein zuverlässiges System, das die Absicht des Modells in Aktionen übersetzt, die die physische Infrastruktur annehmen kann, und dann meldet, was tatsächlich passiert ist.
Der Kilo IoT Server stellt genau diese Ausführungsebene für Physical AI bereit. Er bietet KI-Agenten eine konsistente Schnittstelle zu heterogenen Geräten und hält dabei Geräteprotokolle, Organisationsgrenzen, Berechtigungen, betriebliche Schutzmechanismen und Ergebnisverläufe im IoT-System, das dafür gebaut wurde, sie zu verwalten.
## Wie KI-Agenten reale Geräte steuern
Das KI-Modell liefert die Intelligenz: Es interpretiert die Anfrage, bewertet den Kontext und schlägt vor, was geschehen sollte. Kilo liefert die physischen Abläufe: Es verwaltet den Gerätezustand, schränkt ein, was geändert werden kann, führt getestete Automatisierungen oder Gerätebefehle aus und gibt Belege über das Ergebnis zurück.
Diese Trennung ist wichtig, weil eine generierte Antwort und eine physische Aktion unterschiedliche Fehlerbilder haben. Ein Modell sollte nicht jedes Mal, wenn es handelt, Funkprotokolle, Befehls-Payloads, Geräteverfügbarkeit, Zugriffsrichtlinien oder Wiederherstellungsverhalten improvisieren müssen.
## Sicherer Lebenszyklus der KI-Gerätesteuerung
Kilo unterstützt einen Produktionslebenszyklus rund um reale Aktionen:
1. **Beobachten** — normalisierte Telemetrie, Gerätezustand, Alarme und Betriebskontext lesen.
2. **Schlussfolgern** — der KI fundierte Informationen aus dem Einsatz statt losgelöster Nutzdaten bereitstellen.
3. **Simulieren** — Teste die Automatisierungslogik mit repräsentativen Eingaben vor der Bereitstellung, einschließlich gegen [emulierte Geräte](/kilo-docs-de/kilo-iot-server/devices/emulated-devices.md) die die von dir angegebenen Messwerte erzeugen, sodass ein Ablauf getestet werden kann, bevor die Ausrüstung existiert.
4. **Genehmigen** — die Berechtigungen des angemeldeten Benutzers anwenden und dort eine Bestätigung verlangen, wo der Workflow sie vorsieht.
5. **Ausführen** — eine Regel bereitstellen oder einen typisierten Gerätebefehl über die konfigurierte Verbindung ausführen.
6. **Verifizieren** — die Zustellung des Befehls, optionale Gerätebestätigung und den resultierenden Zustand prüfen.
7. **Aufzeichnen** — den relevanten Ausführungs- oder Versionsverlauf aufbewahren, damit Betreiber untersuchen und wiederherstellen können.
Die [Rules Engine](/kilo-docs-de/kilo-iot-server/rules-engine.md) bietet Debugging, Simulation, kontrollierte Builds, Bereitstellung, Versionsverlauf und Wiederherstellung. [Gerätebefehle](/kilo-docs-de/kilo-iot-server/devices/commands.md) stellt benannte Aktionen mit typisierten Parametern, Versandstatus und optionaler Verifikation bereit.
## Physische KI-Infrastruktur für Modellanbieter
Kilo bietet eine Möglichkeit, Fähigkeiten aus der physischen Welt hinzuzufügen, ohne eine IoT-Steuerungsebene neu aufzubauen. Eine Integration kann Sensoren, Maschinen, Aktoren, Gebäude, Flotten und andere vernetzte Assets verschiedener Hersteller und Protokolle erreichen.
Der IoT Server liefert bereits die operative Grundlage rund um diese Integration: Gerätemodelle, Konnektivität, organisationsübergreifenden Zugriff, Dashboards, Alarme, Automatisierung, Fernsteuerung, Cloud- oder On-Premise-Bereitstellung und Schnittstellen für KI-Clients und Software. Modellanbieter können sich auf die Intelligenz konzentrieren, während Kilo die Grenze dort übernimmt, wo Software auf physische Abläufe trifft.
Kilo ist modellunabhängig. Teams können OpenAI, Anthropic, OpenRouter, einen selbst gehosteten oder anderweitig kompatiblen Modell-Endpunkt oder ein anderes KI-System verwenden, ohne die Geräte- und Betriebsebene zu ersetzen.
## KI-Agenten über MCP oder APIs mit dem IoT verbinden
### Einen externen KI-Client über MCP verbinden
Die [Kilo MCP-Server](/kilo-docs-de/kilo-iot-server/api/mcp-server.md) ermöglicht es einem kompatiblen KI-Client, sich mit einem Kilo-Konto anzumelden und die dem Benutzer verfügbaren Tools zu entdecken. Die Verbindung ist auf die ausgewählte Organisation beschränkt und übernimmt die Berechtigungen des Benutzers.
Zu diesem Toolset gehört jetzt auch die Gerätesteuerung. Ein verbundener Client kann die an einem Gerät konfigurierten Befehle auflisten, einen ausführen und prüfen, ob er zugestellt wurde — `device_command_list`, `device_command_execute`, `device_command_status` — sodass ein externes Modell die **Ausführen** und **Verifizieren** obigen Schritte abschließen kann, ohne die Konversation zu verlassen. Die Ausführung erfolgt hinter einer Bestätigung, nutzt Befehlsdefinitionen, die bereits auf dem Gerät existieren, und landet wie jeder andere Versand im Verlauf der Befehlsausführung.
Verwenden Sie MCP, wenn eine Person möchte, dass ChatGPT, Claude, Codex, Cursor oder ein anderer kompatibler Client mit einer aktiven Kilo-Bereitstellung arbeitet. Die genauen verfügbaren Aktionen hängen von den vom Server bereitgestellten Tools und dem Zugriff des angemeldeten Benutzers ab.
### Den integrierten KI-Assistenten verwenden
Die [IoT AI Assistant](/kilo-docs-de/kilo-iot-server/ai-assistant.md) arbeitet innerhalb von Kilo. Er kann über aktuelle und historische Bereitstellungskontexte schlussfolgern und dabei helfen, Geräte bereitzustellen, Regeln zu erstellen und zu simulieren sowie Alarme zu konfigurieren, während er folgenschwere Änderungen zur Bestätigung anzeigt.
Verwenden Sie den integrierten Assistenten, wenn Betreiber KI in derselben Oberfläche wie ihre Geräte, Regeln, Alarme und Dashboards wünschen.
### Einen Dienst über REST oder gRPC integrieren
Die [Kilo IoT-Plattform-API](/kilo-docs-de/kilo-iot-server/api.md) ist für Software gedacht, die Ihr Team entwickelt, einschließlich Agenten-Backends, Berichtssystemen, industriellen Integrationen und unbeaufsichtigten Workflows. API-Schlüssel tragen explizite Scopes und Organisationskontext.
Verwenden Sie eine API, wenn Sie eine deterministische Anwendungseinbindung statt eines vom Benutzer autorisierten Gesprächsclients benötigen.
## Unternehmenskontrollen für Physical AI
* **Berechtigungsgrenzen:** Der KI-Zugriff bleibt innerhalb der Rolle und Organisation des verbundenen Benutzers.
* **Vor der Bereitstellung testen:** Automatisierungen können debuggt und simuliert werden, bevor sie die Live-Infrastruktur erreichen.
* **Kontrollierte Freigaben:** Regel-Builds werden explizit bereitgestellt und frühere Versionen können wiederhergestellt werden.
* **Eingeschränkte Befehle:** Typisierte Parameter definieren die Eingaben, die eine Geräteaktion akzeptiert.
* **Ergebnisverifikation:** Befehle behalten den Versandstatus bei und können dort, wo unterstützt, eine Gerätebestätigung erfordern.
* **Nachverfolgbare Verläufe:** Regelversionen und -ausführungen, Gerätebefehlsausführungen und Änderungen des Organisationszugriffs behalten jeweils ihre eigenen entsprechenden Aufzeichnungen.
* **Bereitstellungswahl:** dasselbe Betriebsmodell ist über Kilo Cloud oder einen IoT-Server vor Ort verfügbar.
Diese Kontrollen machen nicht jede physische Aktion automatisch sicher. Die Organisation entscheidet weiterhin, welche Geräte steuerbar sind, welche Parameterbereiche angemessen sind, wer handeln darf und wo eine menschliche Genehmigung erforderlich ist.
## Einen KI-Agenten über den IoT-MCP-Server verbinden
1. Öffnen [Kilo IoT MCP-Server für KI-Agenten](/kilo-docs-de/kilo-iot-server/api/mcp-server.md) und fügen Sie den veröffentlichten Endpunkt einem kompatiblen Client hinzu.
2. Melden Sie sich mit Ihrem üblichen Kilo-Konto an und autorisieren Sie die Verbindung.
3. Beginnen Sie mit einer Nur-Lese-Anfrage, z. B. dem Auflisten von Geräten oder dem Zusammenfassen von Alarmen.
4. Bestätigen Sie die ausgewählte Organisation und die für Ihr Konto verfügbaren Tools.
5. Testen Sie eine vorgeschlagene Automatisierung, bevor Sie ihre Bereitstellung genehmigen.
6. Prüfen Sie nach einer physischen Aktion den entsprechenden Regel- oder Befehlsverlauf.
Für ein benutzerdefiniertes Backend beginnen Sie mit der [Public REST API](/kilo-docs-de/kilo-iot-server/api/public-rest-api.md) und erstellen Sie einen begrenzten Schlüssel unter **Einstellungen → API-Schlüssel**.
## Siehe auch
* [IoT AI Assistant](/kilo-docs-de/kilo-iot-server/ai-assistant.md)
* [Kilo IoT MCP-Server für KI-Agenten](/kilo-docs-de/kilo-iot-server/api/mcp-server.md)
* [Rules Engine](/kilo-docs-de/kilo-iot-server/rules-engine.md)
* [Gerätebefehle](/kilo-docs-de/kilo-iot-server/devices/commands.md)
* [Benutzer und Berechtigungen](/kilo-docs-de/kilo-iot-server/account/users-and-permissions.md)
* [Prüfpfad](/kilo-docs-de/kilo-iot-server/reports/audit-trail.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.kiloiot.io/kilo-docs-de/kilo-iot-server/physical-ai.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
