# Revit API Agent Skill nasıl oluşturulur? dll2llm rehberi

Kaynak: https://3dsinifi.com/haber/revit-api-agent-skill-nasil-olusturulur-dll2llm-rehberi · Kategori: Eğitimler · Yayın: 22 Kasım 2026

> Autodesk’in APS rehberi, Revit API bilgisini yapay zekâ ajanlarına aktarmak için dll2llm aracından yararlanan bir Agent Skill iş akışı anlatıyor. Bu rehber, gerekli dosyaları ve uygulama adımlarını açıklıyor.

## Kısaca
- dll2llm, .NET derlemelerini inceleyerek Agent Skill klasörü oluşturabilen bir komut satırı aracıdır.
- Araca RevitAPI.dll verilebilir; kullanıcı arayüzü katmanı da isteniyorsa RevitAPIUI.dll eklenebilir.
- Üretilen klasörde SKILL.md, INDEX.md ve ad alanlarına göre düzenlenmiş konu dosyaları bulunur.
- Revit işlemlerindeki değişiklikler için Transaction gerekir; SubTransaction ise açık bir Transaction içinde kullanılabilir.

## Bu rehberde ne öğreneceksiniz?

Revit API ile çalışan bir yapay zekâ ajanı, yalnızca genel programlama bilgisine dayanarak her zaman doğru sınıf ve yöntemleri seçemeyebilir. Autodesk Platform Services (APS) rehberinde bu durum, API bağlamının eksik olmasıyla açıklanıyor: Ajan bazı yaygın türleri tanısa bile daha az sık kullanılan yöntemleri yanlış tahmin edebilir. Revit API’nin çok sayıda sınıfı ve ad alanı bulunduğundan, bütün bilgiyi tek bir metin dosyasında vermek de pratik bir çözüm olmayabilir.

Bu eğitimde, Revit API derlemelerinden bir Agent Skill klasörü oluşturma yaklaşımını ve bu klasörün ajan geliştirme sürecinde nasıl kullanılabileceğini ele alacağız. Buradaki amaç, Revit’te otomasyonu baştan sona kurmak değil; ajana API hakkında daha düzenli ve aranabilir bir bağlam sağlamaktır. Autodesk’in rehberi bu iş için dll2llm adlı komut satırı aracını örnek gösteriyor.

## Gereksinimler ve sınırlar

İş akışında Revit API derlemesine erişim gerekir. APS rehberi, aracın RevitAPI.dll dosyasına yöneltilmesini; kullanıcı arayüzü katmanına da ihtiyaç duyuluyorsa RevitAPIUI.dll dosyasının eklenmesini anlatıyor. Rehberde, kaynak dosyaların bir Revit kurulum dizininden alınarak beceri klasörü üretimine geçildiği bir gösterim de bulunuyor.

Araç, dll2llm adlı GitHub projesi olarak tanıtılıyor ve bir .NET derlemesini inceleyip Agent Skill dosyalarına dönüştürüyor. Kaynakta desteklenen işletim sistemi, gerekli .NET sürümü, Revit sürüm uyumluluk matrisi, kurulum komutları veya belirli bir ajan ürünü belirtilmiyor. Bu nedenle burada komut, menü yolu ya da sürüm varsayımı vermek doğru olmaz. Uygulamaya başlamadan önce dll2llm projesinin güncel açıklamasını ve kullanılan Revit kurulumundaki DLL dosyalarını kontrol edin.

Resmî rehberin oluşturulan klasör için saydığı temel dosyalar SKILL.md, INDEX.md ve konu Markdown dosyalarıdır. Konu dosyaları ad alanlarına göre düzenlenir; büyük ad alanları bağlam penceresini aşırı doldurmamak amacıyla alfabetik parçalara ayrılabilir. Kaynakta bir hesap gereksinimi belirtilmediği için bu eğitim böyle bir gereksinim olduğunu varsaymıyor.

## Adım adım Agent Skill oluşturma

1. **Hedefi belirleyin.** Önce ajanın hangi Revit API işlerinde destek vermesinin beklendiğini tanımlayın. Örneğin bir eklentide model verisini okuma, elemanları filtreleme veya model değişikliği yapma gibi işler farklı API bilgileri gerektirebilir. Autodesk, Agent Skill’i API bağlamını ajana sağlama yöntemi olarak sunuyor; aracın kendisi proje gereksinimlerini belirlemiyor.

2. **Gerekli derlemeleri seçin.** RevitAPI.dll, Revit API’nin veritabanı katmanını içeren temel girdidir. Ajanın arayüz katmanına ilişkin bilgiye de ihtiyacı varsa RevitAPIUI.dll dosyasını eklemeyi değerlendirin. APS yazısında ikinci dosyanın isteğe bağlı biçimde kullanılabileceği belirtiliyor. İki derlemeyi de kullanmak her görev için zorunluymuş gibi düşünmeyin; kapsamı projenin ihtiyacı belirlemeli.

3. **dll2llm projesini inceleyin.** Araç GitHub’daki dll2llm projesi olarak gösteriliyor. Kurulum ve çalıştırma ayrıntıları kaynak metinde yer almadığından, burada belirli bir terminal komutu paylaşmıyoruz. Projenin kendi yönergelerini izleyin ve aracın hangi derleme yolunu girdi olarak beklediğini doğrulayın.

4. **Derlemeyi araca verin.** APS rehberinin akışında dll2llm, Revit kurulum dizinindeki derlemeler hedef gösterilerek çalıştırılıyor. RevitAPI.dll’yi, gerekiyorsa RevitAPIUI.dll’yi seçin ve aracın çıktısını ayrı bir beceri klasöründe toplamasını sağlayın. Rehber, oluşan yapıda dosyaların ad alanlarına göre bölümlendiğini söylüyor; bu yüzden çıktı tek bir uzun API belgesinden ibaret olmayabilir.

5. **Üretilen dosyaları kontrol edin.** SKILL.md ve INDEX.md dosyalarının yanı sıra konu Markdown dosyalarının oluştuğunu doğrulayın. Konu dosyaları, ad alanlarına göre sınıflandırılmış API bilgisini içerir. Büyük ad alanlarının alfabetik olarak bölünebilmesi, ajan bağlamının tek bir büyük içerik yığınına dönüşmesini önlemeye yardımcı olur. Dosyaları yalnızca oluşturuldukları için doğrulanmış kod örnekleri gibi değerlendirmeyin; araç API bağlamı üretir, proje mantığını sizin yerinize test etmez.

6. **Beceriyi ajan iş akışına ekleyin.** Autodesk’in yaklaşımında beceri bir kez kurulduktan sonra ajan, Revit API referansını görev sırasında kullanabilir. Hedef, sohbet penceresinden tek tek kod parçaları kopyalayıp yapıştırma döngüsünü azaltmak ve ajanın daha geniş API bağlamına erişmesini sağlamaktır. Hangi ajanların beceri biçimini desteklediği veya kurulumun nasıl yapılacağı bu kaynakta açıklanmıyor; kullandığınız ortamın kendi yönergelerine başvurun.

7. **Kod önerilerini küçük görevlerle sınayın.** Ajanın ürettiği kodu doğrudan güvenilir kabul etmeyin. Önce sınıf ve yöntem adlarının oluşturulan referansla uyuşup uyuşmadığını, ardından işlemin hedef modelde beklenen sonucu verip vermediğini inceleyin. Model değişikliği yapan kodlarda işlem yönetimini özellikle kontrol edin: Revit’te modelde değişiklik yapabilmek için Transaction gerekir ve aynı anda yalnızca bir Transaction açık olabilir. İşlem başarıyla tamamlandığında değişiklikler Commit ile kaydedilir; RollBack ise değişiklikleri geri alır. Revit API belgeleri bu işlemlerin durumlarının kontrol edilebildiğini de açıklıyor.

## Sık yapılan hatalar

**API bağlamını proje doğrulamasıyla karıştırmak:** Skill, ajana API türleri ve ad alanları hakkında kaynak sağlar; üretilen kodun bir projede doğru çalıştığını kanıtlamaz. Kodun model üzerinde ne yaptığını ayrıca sınayın.

**Transaction düzenini göz ardı etmek:** Modeli değiştiren işlemler bir Transaction bağlamında yürütülmelidir. SubTransaction, daha büyük bir işi mantıksal parçalara ayırmaya yarayabilir; ancak açık bir Transaction içinde oluşturulmalı ve üst işlem kapanmadan önce kapatılmalıdır. TransactionGroup ise birden fazla bağımsız işlemi birlikte ele almak için kullanılabilir; açık bir Transaction varken başlatılamaz.

**Gereksiz dosyaları eklemek:** Rehber RevitAPIUI.dll dosyasını kullanıcı arayüzü katmanı da gerektiğinde kullanılabilecek ek bir girdi olarak tanımlıyor. İhtiyaç duyulmayan içeriği eklemek yerine becerinin kapsamını görevle eşleştirin.

**Sürüm ve kurulum ayrıntılarını varsaymak:** APS yazısında ayrıntılı uyumluluk tablosu veya kurulum komutu bulunmuyor. Bu yüzden kullanılan Revit derlemesinin kaynağını not edin, dll2llm yönergelerini izleyin ve başka sürümlerin aynı çıktıyı vereceğini varsaymayın.

## Sonraki adımlar: mimarlık ve görselleştirme iş akışları

Revit’te tekrar eden veri çıkarma veya model düzenleme görevleri yapan BIM ekipleri, eklenti geliştiricileri ve API öğrenen öğrenciler bu yöntemden yararlanabilir. Ajanın API sınıflarını daha iyi bulması, prototip yazarken hatalı yöntem tahminlerini azaltmaya yardımcı olabilir. Ancak bu, model kontrolünü, kod incelemesini veya iş akışının gerçek proje koşullarında sınanmasını ortadan kaldırmaz. Mimarlık ve iç mimarlık ofislerinde fayda, özellikle kurum içi otomasyonların geliştirilmesinde ve API’ye yeni başlayan ekip üyelerinin referans aramasında ortaya çıkabilir.

Revit API Agent Skill doğrudan render kalitesini artıran bir özellik değildir; model verisiyle çalışan yazılım ve otomasyon süreçlerine yöneliktir. Görselleştirme ekibi açısından kullanım alanı, Revit’ten bilgi alma veya model değişikliklerini otomatikleştiren araçların geliştirilmesi olabilir. Donanım, lisans veya ajan abonelik maliyetleri kaynaklarda açıklanmıyor. Uygulamaya geçmeden önce mevcut yazılım koşullarını ve kullanılan ajan ortamının beceri desteğini ayrıca değerlendirin.

## Kaynak ve lisans

Bu eğitim, Autodesk Platform Services’in “Let AI Write Your Revit Code” rehberindeki dll2llm ve Agent Skill açıklamaları ile Autodesk’in Revit API belgelerindeki Transaction, SubTransaction ve TransactionGroup tanımlarından uyarlanmıştır. Kaynaklar lisans=serbest olarak verilmiştir; metin ve adımlar özgün biçimde yeniden anlatılmıştır. Autodesk University’nin Revit API’ye yeni başlayanlar için sunduğu ders açıklaması, API, filtreleme ve Transaction konularının öğrenme kapsamını desteklemek için kullanılmıştır.

## Pro ipucu
Ajanın yazdığı model değişikliği kodunu uygulamadan önce Transaction başlangıcını, Commit/RollBack yolunu ve işlem durumunu kontrol edin.

## 3dsınıfı yorumu
Türkiye’de Revit kullanan ofisler ve öğrenciler için Agent Skill yaklaşımının pratik değeri, API hakkında daha sistematik bir referansı ajan iş akışına taşıması. Özellikle tekrarlanan model verisi görevleri veya eklenti prototipleri üzerinde çalışan ekipler, kod önerilerini daha hızlı inceleyebilir.

Bununla birlikte beceri klasörü tek başına çalışan bir otomasyon ya da doğrulanmış eklenti değildir. DLL erişimi, ajan ortamının beceri desteği ve kullanılan yazılım koşulları önceden kontrol edilmeli. Kaynaklar donanım veya lisans maliyeti açıklamadığı için yatırım hesabı yapılırken bu kalemler ayrıca netleştirilmeli.

## Kaynaklar
- [help.autodesk.com](https://help.autodesk.com/view/RVT/2013/ENU/caas.html?url=caas/vhelp/help-dev-autodesk-com/v/Revit/enu/2013/Help/00006-API-Developer-s-Guide/0135-Advanced135/0142-Transact142/0143-Transact143.html) (özet)
- [aps.autodesk.com](https://aps.autodesk.com/blog/let-ai-write-your-revit-code) (özet)
- [autodesk.com](https://www.autodesk.com/autodesk-university/de/class/Revit-Programming-Beginners-Easily-Access-Revit-API-Using-Free-Tools-2018) (özet)

_Yapay zekâ ile yazıldı, kaynaklarla doğrulandı. © 3dsınıfı_
