İlk ajanınızı gönderin

Neler oluşturacaksınız

Bu öğreticinin sonunda şunlara sahip olacaksınız:

• Kendi oluşturup yapılandırdığınız bir ajan
• Sizinle o ajanın konuştuğu bir alan
• Yalıtılmış bir çalışma ağacında commit edilmiş işler ve ajanın çalıştırma günlüğünde bir satır içeren, tamamlanmış bir çalıştırma

Ön koşullar: Bu çalışma alanında kayıtlı bir depo ve bağlı en az bir model sağlayıcı bulunması için İlk çalışma alanınız tamamlanmış olmalı.

1. Adım: Bir ajan oluşturun

1. Ayarlar → Çalışma alanı → Ajanlar’a gidin
2. Yeni ajan’a tıklayın. Hemen “Adsız ajan” adlı bir ajan oluşturulur ve ajan listesinde seçili gelir — oluşturma iletişim kutusu yoktur ve onaylamanız gereken bir şey yoktur. Yapılandırmayı yerinde yaparsınız.
3. Ayarlar sekmesinde şunları doldurun:
   • Ad: alice gibi kısa ve akılda kalıcı bir şey. @ işaretinden sonra yazdığınız ad budur.
   • Başlık: ne yaptığı, ör. “Arka uç geliştiricisi”
   • Adaptör: Control Center (built-in). Bunu bilinçli olarak seçin — çalışırken yönlendirilebilen ve bir tur sınırında duraklatılabilen tek şey yerleşik harness’tır ve sunucu ana makinesinde kurulu bir CLI gerektirmez.
   • Model: bağlı sağlayıcının sunduğu listeden seçin
   • Beceriler: uygun olanları ekleyin, ör. testing veya architecture
4. Değişiklikleri kaydet’e basın

Adaptörü olmayan bir ajan yerleşik döngüde çalışır

Adaptör alanı boş bırakıldığında gönderim Control Center (built-in) seçeneğine geri döner — sunucunun içindeki ajan döngüsü, dolayısıyla ana makineye kurulacak bir şey yoktur. Yine de bir modele ihtiyaç duyar: hiçbiri ayarlanmadıysa Anthropic’ten varsayılanını ister; bu, bir Anthropic hesabı bağladıysanız çalışır, aksi halde No credential for provider "anthropic" hatasıyla başarısız olur. Yine de ikisini de açıkça ayarlayın, yoksa seçmediğiniz bir modelde çalışıyor olursunuz.

Kontrol noktası. Ajan listesi satırı, ajanınızın adını ve içi boş bir durum halkasını gösterir.

2. Adım: Bir alan başlatın

1. Kenar çubuğunda Alanlar bölümünü bulun ve + düğmesine tıklayın
2. Alana bir ad verin
3. Ajan ekle altında, az önce oluşturduğunuz ajanı seçin
4. Çalışma alanında herhangi bir depo varsa, bu alanın hangileri üzerinde çalışacağını seçin
5. Oluştur’a tıklayın

Alan açılır. Control Center arka planda bu konuşma için seçilen depoların copy-on-write çalışma ağacını kendi dalı üzerinde hazırlar. Kaynak checkout’unuz asla değiştirilmez.

3. Adım: Bir görev gönderin

Kaydettiğiniz depoya karşı somut ve küçük bir görev yazın. Kontrol edilebilir bir sonucu olan bir şey en iyi sonucu verir — bir test ekleyin, bir lint hatasını düzeltin, bir simgeyi yeniden adlandırın.

Enter’a basın. Kimseyi @ ile anmanız gerekmez: alanda tek bir ajan varsa düz bir mesaj onu uyandırır. Birkaç ajanın bulunduğu bir alanda @name birini seçer.

Control Center istemi ajanın talimatlarından, personasından, becerilerinden ve alanın bağlamından derler, ardından çalıştırmayı gönderir.

Kontrol noktası. Yazı alanının gönder düğmesi bir durdur düğmesine dönüşür — bu konuşmada bir ajan çalışıyor — ve metin gelmeye başlar.

4. Adım: Çalışmasını izleyin

Konuşma, çalıştırmayı gerçekleşirken işler:

• Akıl yürütme, ajan düşünürken satır içinde gösterilir
• Araç çağrıları: dosya okuma ve yazmaları, aramalar, shell komutları; her biri sonucuyla birlikte
• Metin: özetler, açıklamalar ve size yönelik sorular

Ajan bir şey sorarsa konuşmada yanıtlayın; kaldığı yerden devam eder.

Bir çalıştırmanın kendi metrikleri ile duraklatma, sürdürme ve durdurma denetimleri için çalışan ajanı alanın Genel panelindeki Ajanlar bölümünde bulun ve Etkinliği aç’ı seçin.

Etkinlik bölmesinde durum rozeti Çalışıyor, çalıştırma bittiğinde ise Başarılı yazar. Takılan veya döngüye giren bir çalıştırma Engellendi; hata veren bir çalıştırma Başarısız yazar. Ajan kaydında liste halkası ilk çalıştırmadan önce içi boş, ajan yeniden boşta kaldığındaysa doludur.

Çalıştırmayı sınırlayan şeyler şunlardır: kendi copy-on-write çalışma ağacı, başlatılırken onun için aracılık edilen ve kapatılırken iptal edilen kimlik bilgileri, arındırılmış bir ortam, modunun izin verdiği araç yüzeyi ve eylem korumaları. Bir dalı push etmek veya bir pull request açmak gibi etkiler ayrıca kapılanır — bkz. Korumalar.

5. Adım: Sonucu kontrol edin

1. Ayarlar → Çalışma alanı → Ajanlar’ı açın ve ajanınızı seçin
2. Loglar sekmesini açın

Kontrol noktası. Durumunu, süresini, başlangıç ve bitiş zamanlarını ve çalıştığı adaptörü gösteren tek bir çalıştırma satırı.

Ajanın değişiklikleri konuşmanın dalında, kendi çalışma ağacında commit edilir. Commit’ler ajan adına yazılır ve bir Co-Authored-By: trailer’ı ile siz de katkıda bulunan olarak belirtilirsiniz.

Pull request alma

Hiçbir şey kendiliğinden bir pull request açmaz. Bir tane istiyorsanız aynı konuşmada isteyin:

Bu dalı push edin ve varsayılan dala karşı bir pull request açın.

Push etme (gitPush) ve PR oluşturma (prCreate) varsayılan olarak onayınızı istemeye ayarlıdır, bu yüzden her birinden önce bir onay bekleyin. İstem gösterildiğinde bağlı bir onaylayıcı yoksa eylem izin verilmek yerine reddedilir — korumalar başarısız durumda kapalıdır.

PR, ajanın adı altında değil, çalıştırmanın kullandığı token’ın ait olduğu GitHub kimliği altında açılır — kişisel bir token kaydettiyseniz bu kimlik sizsinizdir. Ajanın yazarlığı commit’lerde görünür.

İsterseniz kendiniz de açabilirsiniz: alanın Kaynak denetimi panelinde, konuşmanın dalını oluşturma ekranına taşıyan bir Pull request oluştur düğmesi bulunur; Pull request’ler → Yeni PR ise aynı ekranı boş olarak açar. Bir sonraki öğretici buradan devam eder.

Özet

Bir ajan oluşturdunuz, adaptörünü ve modelini yapılandırdınız, ona bir alan ve bir görev verdiniz ve checkout’unuza dokunmadan yalıtılmış bir çalışma ağacında gerçek bir çalıştırmanın tamamlandığını izlediniz.

Sonraki: İnceleme iş akışını öğrenmek için İlk pull request’inizi inceleyin.

Ajanlar hakkında daha fazlası için: Ajan modeli. Gönderim ayrıntıları için: Ajan gönderim yaşam döngüsü.