Asistan, soruları yanıtlayarak, içerik üreterek ve doğrudan Stüdyo'da eylemler gerçekleştirerek oyunları daha hızlı inşa etmenize yardımcı olan bir AI yardımcıdır. Şunları yapabilir ve daha fazlasını gerçekleştirebilir:
- Roblox gelişimi hakkında soruları yanıtlayabilir
- Yerinizin veri modelinde nesneleri ve scriptleri oluşturup değiştirebilir
- Yaratıcı Mağaza'dan varlıklar ekleyebilir
- Script Editörü'nde seçilen kodu açıklayabilir
- Nesnelerinizi yeniden tarzlandırmak için malzemeler üretebilir
- Sahnenizi doldurmak için 3D mesh'ler ve prosedürel modeller üretebilir
Stüdyo'da, Asistan büyük bir dil modeli (LLM) ile doğrudan veri modeliniz üzerinde hareket edebilen bir çalıştırma komut sistemi kombinasyonu sunar. Nesneleri ekleyip değiştirebilir, scriptler oluşturabilir ve toplu olarak özellikleri güncelleme gibi tekrar eden görevleri otomatikleştirebilir.
Asistan'ın neler yapabileceğine dair daha derin bir bakış için ve nasıl kullanılacağı hakkında bilgi almak için İstek kılavuzu ve örnekler ile aşağıdaki Roblox Çalışanları canlı yayınına göz atın; ipuçları, püf noktaları ve ilham için.
Stüdyo'dan Asistan'a Erişim
Stüdyo'dan Asistan'a erişmek için:
Mezzanin çubuğunun sağ tarafında Asistan'a tıklayın.

Asistan penceresine bir istek girin.
- Yeni bir yanıt oluşturmak için, yeniden yapma simgesine tıklayın.
- Yanıtı derecelendirmek ve gelecekteki sonuçları iyileştirmek için, parmak yukarı ya da parmak aşağıya tıklayın.

Sohbetler ve sohbet geçmişi
Asistan, her yer için birden fazla sohbet dizisini destekler ve sohbet geçmişiniz bulutta saklanır, böylece Stüdyo oturumları, makine yeniden başlatmaları ve cihazlar arasında konuşmalar devam eder.
- Yeni bir sohbete başlamak için, sohbet listesi butonuna tıklayın ve listenin en üstünde Yeni Sohbet'i seçin. Her sohbetin kendi bağlam penceresi vardır, bu nedenle bir chat'teki uzun bir konuşma diğerinde mevcut olan alanı tüketmez. Girdi kutusundaki taslaklar sohbet bazında korunur.
- Herhangi bir Asistan yanıtının altındaki dal simgesine tıklayarak o mesajdan yeni bir sohbet başlatabilirsiniz. Orijinal sohbet olduğu gibi kalır, böylece mevcut yerinizi kaybetmeden farklı bir yönü keşfedebilirsiniz.
- Sohbetler, çalıştığınız yere göre oluşturulur, deneyime göre değil. Her yerin kendi sohbet seti vardır ve her yer için sohbet sayısında katı bir sınır yoktur.
- Silinen sohbetler kalıcı olarak kaldırılır ve geri getirilemez.
Eğer Stüdyo'yu birden fazla cihazda açtıysanız, tarih senkronizasyonu bulut üzerinden gerçekleştiğinden çakışmaları önlemek için aynı anda bir sohbet üzerinde çalışmanızı öneririz.
Ekran yakalama alt ajanı
Asistan, 3D görünüm alanınızdaki mevcut görünümü (hem Düzenleme hem de Oynama modlarında) yakalayabilen bir ekran yakalama alt ajanı içerir ve bunu Asistan'a geri anlatır. Bu işlev, Asistan'ın sahneniz hakkında düşünmesini sağlar; sizin tarif etmenize gerek kalmadan. "Bu doğru görünüyor mu?" veya "Aydınlatma gece için ayarlanmış mı?" gibi sorular sorabilirsiniz ve Asistan, görünüm alanının bir ekran görüntüsünü alır ve gördüklerine dayanarak yanıt verir.
Üçüncü taraf bir istemci kullanıyorsanız MCP veya kendi API anahtarınızla, temel ekran görüntüsü aracınıza doğrudan erişim sağlamaya devam edersiniz.
Sorular Sorun ve Kodu Açıklayın
Oyun yaratırken genel bilgiye veya yardıma ihtiyacınız varsa, Asistan'a bir takım sistemi nasıl yapılır, bir oyun döngüsü nasıl tasarlanır, belirli Stüdyo araçları nasıl kullanılır gibi sorular sorabilirsiniz ve çok daha fazlası. Hatta, Asistan'ın oluşturduğu veya sizin yazdığınız kodu açıklayabilir.

Yerinizi Düzenleyin
Scriptler
Asistan yeni scriptler ekleyebilir, mevcut olanları değiştirebilir ve gerektiğinde birden fazla nesne üzerinde bu eylemleri gerçekleştirebilir. Örneğin, bir uzak olay yaratmasını isterseniz, hem bir yerel script, hem bir sunucu scripti hem de olayı hepsini bir arada oluşturabilir.
"Bu parçaya dokunduklarında oyuncunun karakterinin zıplamasını sağla" gibi bir script oluşturma isteği girerseniz, Asistan scriptin içeriğini gösterir ve yeni script örneğini veri modelindeki seçili nesneye ekler. Eğer hiçbir şey seçili değilse, Asistan, istemlerinize göre nereye yerleştireceğine karar verir.

Oluşturulan script mükemmel çalışmayabilir. Bu durumlarda, ya daha fazla düzenleme yapmak için Script Editörü'nde değişiklik yapabilir ya da Asistan'dan az önce oluşturduğu scripti düzenlemesini isteyebilirsiniz. Kendi yazdığınız kodla ilgili yardım gerekiyorsa, Asistan daha önce oluşturmadığı mevcut scriptler üzerinde de işlem yapabilir.
Nesneler ve Yaratıcı Mağaza varlıkları
Asistan, veri modelinizdeki örnekleri oluşturabilir, düzenleyebilir, silebilir ve üzerinde ilerleyebilir, ayrıca Yaratıcı Mağaza'dan öğeler ekleyebilir.

Kodu incelediğinizde, Asistan'ın bir tekerlekli çöp modelini Yaratıcı Mağaza'dan sorgulamak için InsertService:GetFreeModels() çağrısını yaptığını ve bunu bir ağaca yakın yerleştirmek için Model:PivotTo() kullandığını görebilirsiniz.
İçerik Üretin
Malzemeler
Bir malzeme oluşturma isteği verildiğinde, Stüdyo'daki Asistan, mevcut parçaları hızlı bir şekilde stilize edebilir ve bu esnada hafif bir Malzeme Üreticisi versiyonu kullanır.

Mesh'ler
Dokulu bir 3D mesh oluşturmak için:
- /generate komutunu ardından istek cümlenizi yazın. Örneğin, /generate_mesh bir kırmızı buggy ile çamurlu lastik yazabilirsiniz.
- Asistan'a doğrudan bir mesh oluşturmasını isteyin. Örneğin, "Gelecekçi bir kutu yap."
- Yazılı bir referans görüntüsü ile yönlendirme yapın. /generate_mesh hem bir yazılı istek hem de bir görüntü kabul eder, ancak aynı istekte her ikisini birden kabul etmez.
Workspace'inizde bir Parçayı sınır kutusu olarak kullanabilirsiniz. Bir istek girmeden önce bir Parça seçerseniz, Asistan Parça'nın boyutunu ve konumunu girdi olarak kullanır ve üretilen mesh'in tanımlanan alan içerisine sığmasını sağlar.
Ayrıca, döndürülen model için maksimum üçgen sayısı tanımlayabilirsiniz. Daha düşük değerler daha fazla yüzeyli ve düşük poli üretimler sonucunu verir. Bu istekteki bir giriştir ve varsayılan değeri 10.000'dir.

Prosedürel Modeller
Prosedürel modelleri ölçeklendirmek ve otomatik olarak uyum sağlamak için /generate_procedural_model komutunu kullanarak prosedürel modeller oluşturabilirsiniz.
Prosedürel modeller sayesinde:
- Minimum girdi ile esnek 3D modeller oluşturabilir ve parametreleri yeniden inşa etmeden ayarlayabilirsiniz.
- Geri alma/yeniden yapma, Team Create, ağ çoğaltma, ölçeklendirme ve sürükleme araçları gibi motor özellikleriyle otomatik olarak entegre olabilirsiniz.
- Yüksek performansı koruyarak, modeller standart nesneler gibi davranır, parametreleri değişmediği sürece. Bu, bu modellerin oyununuza neredeyse hiç yük getirmediği anlamına gelir.
- Oluşturulan içeriği, kaynak ve çıktı ayırarak özel bir GeneratedFolder içinde düzenli tutabilirsiniz.
Bir prosedürel model oluşturmak için, /generate_procedural_model bir kitap yığını gibi bir komut yazın veya isteminize bir referans görüntüsü ekleyin. Asistan daha sonra prosedürel modeli oluşturur ve mevcut alanınıza doğrudan ekleyerek daha fazla özelleştirme için hazır hale getirir.

Segmentasyon
Segmentasyon, üretilmiş bir varlığı bireysel parçalara ayırarak özelleştirme üzerinde daha fazla kontrol sağlar. Farklı malzemeler uygulamanıza, scriptler eklemenize veya tüm modeli yeniden oluşturmadan bireysel bileşenleri değiştirmenize olanak tanır.
/generate_mesh veya /generate_procedural_model komutunu çalıştırdığınızda, Asistan modelin nasıl bölüneceğini tanımlayan bir segmentasyon planı önerir. Oluşturma işleminden önce Parça İsimleri altında önerilen parça listesini düzenleyebilir, girişleri ekleyip kaldırabilir veya önerilen segmentasyonu yeniden oluşturabilirsiniz. Her oluşturulan varlığın en fazla sekiz parçası olabilir.
Konfigürasyon hazır olduğunda, oluşturmayı başlatmak için Oluştur'a tıklayın veya isteği iptal etmek için İptal'e tıklayın.
Örneğin, bir kaykay oluşturduğunuzda ve beş parça tanımladığınızda (gövde, sol arka tekerlek, sağ arka tekerlek, sol ön tekerlek, ve sağ ön tekerlek), Asistan modeli bu bileşenlere segmentler, her birini bağımsız olarak değiştirebilmenizi sağlar.



Önerilen parça isimleri
Herhangi bir üretilmiş varlık segmentasyon alabilir, ancak aşağıdaki önerilen parça isimleri, karşılık gelen nesne türleri için en güvenilir sonuçları şu anda üretmektedir.
Kendi segmentasyonunuzu tanımlarken, bu parça isimlerini bir başlangıç noktası olarak kullanın ve gerektiğinde özelleştirin.
| Nesne türü | Önerilen parça isimleri |
|---|---|
| araba | gövde, sol ön tekerlek, sağ ön tekerlek, sol arka tekerlek, sağ arka tekerlek |
| ambulans / polis arabası | gövde, sol ön tekerlek, sağ ön tekerlek, sol arka tekerlek, sağ arka tekerlek, siren ışık çubuğu |
| savaş arabası | gövde, sol ön tekerlek, sağ ön tekerlek, sol arka tekerlek, sağ arka tekerlek, silah |
| çekici | gövde, sol ön tekerlek, sağ ön tekerlek, sol arka tekerlek, sağ arka tekerlek, çekme halkası |
| treyler | gövde, sol tekerlek, sağ tekerlek, bağlantı yeri |
| motosiklet | çerçeve, gidon, ön fork, ön tekerlek, arka tekerlek |
| kaykay | gövde, sol ön tekerlek, sağ ön tekerlek, sol arka tekerlek, sağ arka tekerlek |
| prop uçağı | gövde, pervâne |
| savaş prop uçağı | gövde, pervâne, silah |
| jet uçağı | gövde, itici |
| helikopter | gövde, ana rotor kanadı |
| savaş helikopteri | gövde, ana rotor kanadı, silah |
| drone | gövde, sol ön pervane, sağ ön pervane, sol arka pervane, sağ arka pervane |
| jetpack | paket, itici |
| motorlu tekne | gövde, motor |
| savaş motorlu tekne | gövde, motor, toplar |
| denizaltı | gövde, pervâne |
| el feneri | tutacak gövdesi, baş, mercek |
| hazine sandığı | gövde, kapak |
| balta | tutacak, baş |
| silah | tutacak, ana gövde, namlu |
| keskin nişancı tüfeği | tutacak, ana gövde, namlu, dürbün |
| hafif top | tripod tabanı, döner montaj, silah gövdesi, namlu, koruma plakası |
| top | arabacı tabanı, namlu, sol tekerlek, sağ tekerlek |
| sopa | tutacak, uç |
| kılıç | tutacak, el koruması, bıçak, topuz |
| beyzbol sopası | tutacak, gövde |
| el bombası | el bombası gövdesi, emniyet mandalı, çekme pimi |
Segmentasyonlu modeller ile çalışmaya dair daha fazla örnek için Davranışlar Referansı oyunu .rbxl dosyasına bakın.
Planlama Modu
Planlama Modu, Asistan'ın bir isteği gerçekleştirmeden önce bir önizlemesini yapmanıza olanak tanır. Karmaşık bir istek oluşturduğunuzda, Asistan gözden geçirebileceğiniz ve ayarlayabileceğiniz bir plan üretir.
Planlama Modu'nu etkinleştirmek için:
- Asistan girdi panelindeki açılır menüye tıklayarak Plan'ı seçin.
- Asistan'a /plan komutunu girin.

Beceriler
Stüdyo'da, Asistan, görevleri daha tutarlı ve kapsamlı bir şekilde yerine getirmek için çeşitli beceriler kullanıyor. Asistan, isteğinize göre uygun becerileri otomatik olarak seçer.
Beceriler, SKILL.md dosyası ve herhangi bir destekleyici kaynak (scriptler, yan dosyalarla birlikte commands dizini vb.) olan klasörlerdir. Asistan becerilerinin tam listesini açık kaynak deposunda görebilirsiniz.