Bir yapay zeka asistanından size Delphi'de bir WebSocket istemcisi yazmasını isteyin, kendinden emin, düzgün yapılandırılmış ve ince biçimde yanlış bir şey üretecektir. Var olmayan bir özellik. Yanlış birime yerleştirilmiş bir bileşen. Üç sürüm önce kaldırılmış bir API. Sonra da makul görünen dört satırdan hangisinin derlenmediğini bulmak için yirmi dakika harcarsınız.
Nedeni basit. Bu modeller genel koddan öğrendi ve eSeGeCe bileşenleri ticari olduğundan model onları hiç okumadı. Bir Delphi bileşen kitaplığının nasıl göründüğünü bilir, gerisini başka kitaplıklara dair hatırladıklarıyla doldurur.
Bu boşluğu kapatmak için ajan becerileri yayımladık. Ücretsizdirler, MIT lisanslıdır ve kurmak için bir lisansa ihtiyacınız yoktur.
Ajan becerisi nedir
Bir beceri, bir ajanın gerektiğinde yüklediği bir Markdown klasörüdür. Bizimkiler her kitaplığın genel API'sini taşır: her bileşeni, özelliklerini, olaylarını ve yöntemlerini, bulunduğu birimi ya da ad alanını, onu içeren sürüm türünü ve ürünle birlikte gelen demolardan alınmış gerçek örnekleri. Her sürümde kitaplığın kaynak kodundan üretilirler, dolayısıyla modelin yarım yamalak hatırladığı sürümü değil, elinizde gerçekten bulunan sürümü anlatırlar.
Her şey tek bir depoda, github.com/esegece-com/agent-skills adresinde, altı eklenti halinde paketlenmiş olarak bulunur.
Kurulum
Claude Code ve GitHub Copilot CLI'da marketplace'i bir kez ekleyin, ardından istediğiniz eklentileri kurun:
/plugin marketplace add esegece-com/agent-skills
/plugin install sgcwebsockets-delphi@esegeceCodex CLI'da:
codex plugin marketplace add esegece-com/agent-skills
codex plugin add sgcwebsockets-delphi@esegeceVS Code'da Komut Paleti'ni açın ve "Chat: Install Plugin From Source" komutunu çalıştırın. Cursor'da ve bir beceri klasörü okuyan diğer ajanlarda, beceri klasörünü depodan ajana göre .cursor/skills/, .claude/skills/, .github/skills/, .agents/skills/ ya da .junie/skills/ dizinine kopyalayın.
Altı eklenti şunlardır: sgcwebsockets-delphi, sgcwebsockets-dotnet, sgcsign-delphi, sgcopenapi-delphi, sgcindy-delphi ve sgcbiometrics-delphi.
sgcWebSockets neden tek beceri değil de 18 beceri
sgcWebSockets 222 bileşen kaydeder. Hepsini kapsayan tek bir beceri işe yaramayacak kadar büyük olurdu: ajan, MQTT ile ilgili bir soruyu yanıtlamak için kitaplığın tamamını yüklerdi. Bu yüzden alanlara bölünmüştür: WebSocket çekirdeğini, mesaj broker'larını, sgc alt protokollerini, borsa akışlarını, yapay zeka ve LLM'i, servis entegrasyonlarını, HTTP ve taşıma katmanlarını, kimlik doğrulamayı, P2P ve WebRTC'yi ve IoT'yi kapsayan 18 beceri, ayrıca sgcHTML widget'ları için altı beceri daha.
Bir MQTT broker'ına bağlanması istenen bir ajan mesaj broker'ı becerisini yükler, başka hiçbir şeyi değil. .NET eklentisi aynı fikri 7 beceriyle izler.
Bir becerinin içinde ne var
Her beceri elle yazılmış bir uygulama kılavuzuyla açılır: becerinin ne için olduğu, ihtiyaç duyduğunuz uses yan tümcesi ya da using yönergesi, kod yazmadan önce geliştiriciye sorulmaya değer sorular ve insanların gerçekten takıldığı hatalar. Ardından üretilen malzeme gelir: her üye için hem Delphi hem C++Builder imzasını, .NET eklentisinde ise C# imzasını içeren eksiksiz API başvurusu, ajanın var olan bir sabiti kullanması için seçenek ve numaralandırma türü sayfaları, ürünle birlikte gelen demolardan damıtılmış örnekler ve her bileşenin gerektirdiği sürüm türü.
Bu son nokta, belli bir tür boşa geçen öğleden sonrayı kurtarır. "Bileşen paletimde yok" çoğu zaman bir kurulum sorusu değil, bir sürüm türü sorusudur ve beceri bunu siz sormadan yanıtlar.
.NET konusunda dürüst olmak
Yayımlanan .NET derlemesi, Delphi kitaplığının kaydettiği 222 bileşenin 70'ini sunar. Bir ajanın tahmin yürütmesine izin vermek yerine, .NET eklentisi yalnızca Delphi'de bulunan 152 bileşeni ve her birinin yer aldığı birimi adlandıran, üretilmiş bir kapsam sayfasıyla gelir. Aksi hâlde makul görünen bir C# API'si uyduracak olan ajanın artık bakabileceği bir yer vardır ve "bunu C# ile yapabilir miyim" sorusunun dürüst yanıtı bir sayfa uzaktadır.
Gizlilik
Bir beceri belgeden ibarettir. Hiçbir şey çalıştırılmaz, hiçbir yere hiçbir şey gönderilmez ve hiçbir telemetri toplanmaz. Beceriler yalnızca genel ve yayımlanan API'yi taşır, yöntem gövdeleri, özel alanlar ve korumalı üyeler bilinçli olarak dışarıda bırakılmıştır. Bunları kurmak, kitaplığın kaynak kodunu ne sizin ne de bir başkasının diskine koyar.
Güncel tutmak
Beceriler her sürümde kitaplığın kaynak kodundan yeniden üretilir, böylece geride kalmak yerine ürünü takip ederler. Yeni bir sürümü almak için kurulum komutunu yeniden çalıştırın. Kodunuzdaki bir API ajanın anlattığıyla uyuşmuyorsa becerinin içindeki reference/history.md dosyasına bakın, çünkü olağan açıklama ikinizin farklı yapılar üzerinde olmanızdır.
Tüm ayrıntılar ve elle kurulum yolları yapay zeka ajan becerileri sayfasında yer alır.
Beceriler kuruluyken bir ajan yine de bir konuda yanılıyorsa, bu bir belge hatasıdır ve bunu duymak isteriz. GitHub üzerinde bir konu açın ya da bizimle iletişime geçin — yanıtı kodu yazan kişilerden alacaksınız.