Bu yol, Proxus'u özel mantıkla genişletmek, uygulamalarına entegre etmek veya otomasyon iş akışları oluşturmak isteyen yazılımcılar içindir. Sonunda C# edge fonksiyonları yazıp dağıtabilecek, REST API'yi kullanabilecek ve yapay zeka destekli MCP sunucusunu anlayabileceksiniz.
Neler Yapabileceksiniz
- Edge'de telemetri işleyen C# fonksiyonları yazma ve dağıtma
- Fonksiyonlarınızda önbellek, zamanlama ve MQTT istemci özelliklerini kullanma
- REST API ile kimlik doğrulama ve CRUD işlemleri gerçekleştirme
- Telemetri API ile ClickHouse'dan veri sorgulama
- Yapay zeka destekli operasyonlar için MCP Sunucusunu anlama
Tahmini süre: 2–3 saat
Ön Koşullar
- Proxus kurulu ve simüle bir cihaz veri gönderiyor (Hızlı Başlangıç Kılavuzu)
- C# ve temel REST API kavramlarına hakimsiniz
- Yönetim Konsoluna admin olarak giriş yapabiliyorsunuz
Adım Adım Yol
Neyin nerede çalıştığını anlayın (15 dk)
Kod yazmadan önce çalışma ortamını kavrayın:
- Platform Mimarisi — Veri Akış Pipeline'ı: Alımdan Depolamaya.
- Durumsuz Edge Mimarisi — Gateway'lerin iş yüklerini nasıl aldığı ve yürüttüğü.
- Birleşik İsim Alanı — Kodunuzun etkileşimde bulunacağı veri modeli.
Kritik çıkarım: C# kodunuz Merkez Sunucuda değil, Edge Gateway üzerinde çalışır. Veriler platforma ulaşmadan önce yerel olarak işlenir.
İlk edge fonksiyonunuzu yazın (30 dk)
- Edge Scripting Genel Bakış — Edge scripting ne zaman kullanılır, kurallar yerine ne zaman tercih edilir.
- Kullanıcı Fonksiyonları Yazma — C# fonksiyon mimarisi,
FunctionBasesınıfı, mesaj işleme.
Uygulamalı alıştırma: Sıcaklık verisinden verimlilik hesaplayan ve sonucu pipeline'a geri enjekte eden bir fonksiyon oluşturmak için kod örneğini takip edin.
Tamamladıktan sonra: Fonksiyonunuz Yönetim Konsolunda Edge Scripting altında, SYSTEM gateway'ine dağıtılmış olarak görünmelidir.
SDK yeteneklerini inceleyin (15 dk)
Kullanıcı Fonksiyonları sayfasında kalın ve şunları inceleyin:
- Loglama:
LogInformation,LogWarning,LogError,LogDebug - Veri İşlemleri:
Save(),SendNotification(),UpdateDeviceStatus() - Önbellek: Otomatik süre sonlu, thread-safe
Cachesözlüğü - Zamanlama: Tekrarlayan arka plan işleri için
ExecuteScheduledTask() - MQTT İstemcisi: Harici broker'lara
PublishMqttMessage(),SubscribeToMqttTopic()
Kritik soru: OnMessageReceive içinde işlemek yerine ExecuteScheduledTask ne zaman kullanılır?
Fonksiyonunuzu izleyin (10 dk)
- Dağıtım ve Loglar — Dağıtım durumu, çalışma zamanı logları ve çökme raporlama.
Okuduktan sonra: Fonksiyonunuzun loglarını nerede bulacağınızı ve 10 işlenmeyen istisnadan sonra ne olacağını bilmelisiniz.
Kural Motorunu öğrenin (20 dk)
Kurallar fonksiyonları tamamlar. Basit koşul-aksiyon kalıpları için kuralları, karmaşık mantık için fonksiyonları kullanın.
- Kural Motoru Genel Bakış — Değerlendirme modları ve kural yapısı.
- İfade Sözdizimi — Koşul oluşturma için ifade dili.
- Anomali Tespiti — Z-Score ve istatistiksel anomali modelleri.
Önerilen alıştırma: Sıcaklığın 5 ardışık okumada 70°C'nin üzerinde kalmasını tespit eden bir kural oluşturun.
REST API'yi kullanın (30 dk)
- REST API Referansı — Kimlik doğrulama, OData endpoint'leri ve Telemetri API.
Uygulamalı alıştırmalar:
- Kimlik doğrulayın ve JWT token alın
- OData endpoint'i ile
$filterkullanarak tüm cihazları listeleyin - ClickHouse'dan son bir saatlik telemetri verilerini sorgulayın
Sayfada Curl, JavaScript, Python ve C# örnekleri mevcuttur.
MCP Sunucusunu keşfedin (15 dk)
- MCP Sunucusu — Platform operasyonları için yapay zeka dostu arayüz.
Okuduktan sonra: Yapay zeka ajanlarının yapılandırılmış araç çağrıları ile cihazları nasıl sorgulayabileceğini, telemetri okuyabileceğini ve kuralları nasıl yönetebileceğini anlamalısınız.
Geliştiriciler için yapılandırmayı gözden geçirin (referans)
- Kullanıcı Fonksiyonları Yapılandırması — Çökme eşikleri, otomatik try/catch enjeksiyonu, log hız limitleri.
- JWT & WebAPI Yapılandırması — Token imzalama anahtarları, süre sonu, CORS.