Tutorials
Diese Tutorials führen Sie durch OctoMesh, von der ersten Anmeldung bis zur eigenen Anwendung. Sie bauen aufeinander auf, lassen sich aber auch einzeln lesen.
| # | Tutorial | Sie lernen |
|---|---|---|
| 1 | Erste Schritte mit OctoMesh | Die Grundbegriffe (Tenant, Construction Kit, Runtime-Entity, Blueprint, Pipeline, Stream Data), einen Rundgang durch das Refinery Studio und die Anmeldung mit octo-cli |
| 2 | Auf Daten zugreifen | Wie Sie ein Access-Token erhalten und Runtime-Entities, Assoziationen und Zeitreihen über GraphQL abfragen, mit curl und Python |
| 3 | Energiedaten verstehen | Ein Anwendungsfall durchgängig: das Datenmodell einer Energiegemeinschaft, Zählerregister (OBIS-Codes), Datenqualität, die tägliche Verteilung und die daraus abgeleiteten Kennzahlen |
| 4 | Lösungen mit KI über den MCP-Server bauen | Wie Sie einen KI-Assistenten mit OctoMesh verbinden, Daten in natürlicher Sprache erkunden und den Assistenten eine Auswertung oder eine kleine App erzeugen lassen |
| 5 | Eigene Daten über Pipeline-Endpunkte einbringen | Wie HTTP-Endpunkte auf dem Mesh Adapter funktionieren und wie Sie sie von eigenen Geräten oder Diensten aus aufrufen |
Was Sie brauchen
- Einen OctoMesh-Tenant und ein Benutzerkonto darin. Die Beispiele verwenden
die Platzhalter
<tenant>für die Tenant-Id und<your-domain>für die Domain Ihrer OctoMesh-Installation; das Asset Repository ist also unterhttps://assets.<your-domain>erreichbar und der Identity Service unterhttps://connect.<your-domain>. Die tatsächlichen Werte nennt Ihnen Ihre Administration. - Einen Webbrowser für das Refinery Studio.
- Für die Kommandozeilen-Teile: octo-cli,
curlsowie Python 3.10 oder neuer mit dem Paketrequests. - Für Tutorial 4: einen MCP-fähigen KI-Client wie Claude Code oder Claude Desktop.
Zuerst nur lesen
Die Tutorials 1 bis 4 lesen ausschließlich Daten. Sie können ihnen auch in einem produktiven Tenant folgen, ohne etwas zu verändern. Tutorial 5 schreibt Daten; verwenden Sie dafür einen Test-Tenant.
Wie es weitergeht
Die Tutorials verweisen überall dort auf die Referenzdokumentation, wo ein Thema tiefer geht:
- Technology Guide → Datenzugriff für alle Abfrageoptionen der GraphQL-API
- Technology Guide → Construction Kits für die Datenmodellierung
- Technology Guide → Kommunikation für Adapter und Pipelines
- Glossar für die in der Dokumentation verwendeten Begriffe