Paperclip Agents ile Web Sitesi Nasıl Oluşturulur ve Yayınlanır14 min read

Paperclip, bir yapay zeka web sitesi ekibini koordine ediyor; web sitesinin genel ana bilgisayarı değildir. Brifingi parçalara ayırmak, sorumlu işleri atamak, kalite güvence kanıtlarını toplamak ve onayı yönlendirmek için bunu kullanın. Ardından incelenen kodu bir barındırma sağlayıcısı aracılığıyla dağıtın veya uygun bir uygulama yapısını AgentGrid.io aracılığıyla açıkça yayınlayın. Bitti durumuna taşınan bir görev genel dağıtım değildir.

Ana sayfası, özellik sayfası ve iletişim yolu bulunan üç sayfalık bir ürün lansman sitesini düşünün. Tasarımcı, kodlayıcı, QA temsilcisi ve pazarlama incelemecisi yalnızca kabul kriterlerini paylaştıklarında ve hangi revizyonun incelenmekte olduğunu bildiklerinde paralel olarak çalışabilirler. Bu kılavuz, aracı orkestrasyonunu sihirli bir tek tıklamayla site oluşturucu olarak ele almadan bu aktarımın nasıl yapılandırılacağını gösterir.

Paperclip ve AgentGrid.io ile bir web sitesi nasıl yayınlanır

Paperclip, aracı çalışmalarını atamalar halinde düzenleyebilir ve çıktıları yapay olarak izleyebilir. AgentGrid.io, ortaya çıkan web sayfasının veya belgenin incelendiği ve onaylanması halinde yayınlandığı ayrı yer olabilir. Bu rolleri daraltmayın: Bir Ataç görevi veya onun yapıt kaydı, otomatik olarak bir AgentGrid yapıtı değildir ve bu ürünler, doğrulanmış bir entegrasyon olmadan yerel bir bağlantıya sahip olarak tanımlanmamalıdır.

1. Önce hedef çalışma alanını oluşturun

AgentGrid’te çıktıyı inceleyecek ekip için bir çalışma alanı oluşturun veya seçin. Herhangi birini davet etmeden önce ekip üyeliğini kontrol edin. Paperclip’in aracısını mevcut yürütme yolunda tutabilir ve bir kişinin teslimatı aktarmasına izin verebilirsiniz. AgentGrid’in temsilci daveti, uyumlu, kasıtlı olarak yapılandırılmış bir yardımcı için isteğe bağlı bir yoldur; Paperclip’in temsilci listesinin veya onay zincirinin AgentGrid’te görüneceğinin kanıtı değildir. Bir aracıyı davet ederseniz, tek seferlik bağlantıyı göndermeden önce AgentGrid davet talimatlarını kullanın ve gereksiz Paylaşma ve Yayınlama özelliklerinin işaretini kaldırın.

Ataç’ta ödeve sıkı bir kabul özeti verin: bir açılış sayfası konsepti, gerekli bölümler, gerçek iddialar için kaynak bağlantıları ve adlı bir gerçek incelemeci. Ödevin dahili durumunu yayınlama izninden farklı tutun. Tamamlandı olarak işaretlenen bir görev, talep edilen çalışmanın inceleme için teslim edildiği anlamına gelir, kamuya açıklanmaya izin verildiği anlamına gelmez.

2. Gerçek çıktıyı aktarın

Aracı işini bitirdiğinde, oluşturduğu dosyaları veya yazılı yapıyı inceleyin. Küçük bir site için ilgili dosyaları ZIP olarak paketleyin ve AgentGrid’in ZIP içe aktarma özelliğini kullanın. Bir metin raporu için desteklenen belgeyi içe aktarın veya yeni bir belge oluşturun. Gözden geçirenlerin onu Ataç ödevine bağlayabilmesi için ona bir ad verin ve neyin hazır, neyin geçici olduğu ve kaynak materyallerin nerede bulunduğu hakkında kısa bir not ekleyin. Dosyaların tam olarak aracı ortamında olduğu gibi oluşturulduğunu varsaymak yerine AgentGrid önizlemesini doğrulayın.

3. Görev incelemesini sürüm incelemesinden ayırın

Ödevi ve durumunu takip etmek için Ataç’ı kullanın. Paydaştan AgentGrid yapısının kendisini incelemesini ve içerik, bağlantılar, erişilebilirlik ve dışarıya yönelik iddialar hakkında yorum bırakmasını isteyin. AgentGrid yapay yorumları destekler, böylece eyleme dönüştürülebilir geri bildirimler yayınlanacak olan şeylere atıfta bulunabilir. Düzeltmeleri ekleyin ve yeni önizlemeyi kontrol edin. Görev kapsamı değişirse, Ataç atamasını da güncelleyin, ancak her iki araçtaki onayı diğeriyle sihirli bir senkronizasyon olarak değerlendirmeyin.

4. Kontrol edilen sürümü yayınlayın

Yalnızca bir insan sahibi halka açık yayına izin verdikten sonra AgentGrid’in yayınlama akışını kullanın. Ortaya çıkan sayfayı ziyaretçi olarak açın ve onaylanan yapıyla karşılaştırın. AgentGrid, düzenlenebilir çalışma alanı yapıtını genel dağıtımdan ayırır; sonraki değişiklikler başka bir yayınlama eylemi gerektirir. Süreciniz gerektiriyorsa, otomatik entegrasyon veya gizli onay köprüsü talep etmeden, genel URL’yi Ataç görevine bir devir notu olarak geri kaydedin.

Ekibe belirsiz bir talimat değil, bir web sitesi hedefi verin

Dar bir özet ile başlayın: hedef kitle, dönüşüm hedefi, gerekli sayfalar, görsel referanslar, içerik sahibi, erişilebilirlik beklentileri ve alan adı veya barındırma hedefi. İlk sürüm için duyarlı düzenleri, meta verileri, çalışan bir iletişim rotasını ve neyin kapsam dışı olduğunu belirtin.

Paperclip’te bir proje ve hedef oluşturun, ardından işi sahip olunan görevlere bölün. Görev modeli, sorumlu tek bir sahibi destekler; ilişkileri, ileti dizilerini ve inceleme aşamalarını engeller. Planlaması için bir strateji uzmanı veya PM temsilcisi, görsel yönlendirmeyi yapması için bir tasarımcı, uygulaması için bir kodlama temsilcisi, test etmesi için bir QA temsilcisi ve lansmanı onaylaması için bir insan atayın. Bunlar önceden paketlenmiş bir web sitesi oluşturucusu değil, yapılandırdığınız rollerdir. Ataç’ın kendisi web sitesi ekibi örneği özellik sayfalarını, uygulama tarafından engellenen QA’yı ve inceleme boyunca ilerleyen bir önizleme dağıtımını gösterir.

Planlama istemi: “Ziyaretçilere (hedef) yardımcı olacak, [hedef kitle] için üç sayfalık bir web sitesi planlayın. Bir site haritası, sayfa düzeyinde kabul kriterleri, içerik boşlukları, görüntü gereksinimleri ve görev bağımlılık haritası oluşturun. Hiçbir şeyi dağıtmayın. Her teslimata bir sahip atayın ve bir insanın alması gereken kararları belirleyin.”

Temsilcileri atamadan önce ibra sözleşmesini tanımlayın

Kitleyi, birincil dönüşümü, onaylı kopyayı, sayfa envanterini, görsel öğeleri, gerekli kesme noktalarını, hedef ana bilgisayarı ve lansman sahibini ayarlayın. Birinci sürümde ödeme yapılmaması veya hesap oluşturulmaması gibi açık hedef olmayan amaçlara yer verin. Her sayfaya ölçülebilir bir kabul kriteri verin: Özellik sayfası teklifi açıklar, iletişim bağlantısı çalışan bir hedefe ulaşır ve her rotanın anlamlı bir başlığı vardır.

Kaynağı, tasarımı ve kanıtları bir arada tutun

İnşaatçıya bir depo veya paylaşılan proje konumu verin. Tasarımcı bir düzen spesifikasyonu ve varlıkları sağlar; kodlayıcı aynı brifing karşısında uygulama yapar. Bir görev yorumu şubeye, çekme isteğine, önizlemeye ve test sonuçlarına bağlantı vermelidir. Ataç, göreve bağlı çıktıları toplayabilir ve kanıtları inceleyebilir, ancak görev eki otomatik olarak canlı web sitesi veya kanonik kaynak deposu değildir.

Erişim izni vermeden önce sınırları belirleyin. Bir aracı, kabuğundaki bir GitHub kimliği aracılığıyla kod iletebiliyorsa, Paperclip’in araç başına Sor ilk kontrolleri, bu kabuk Git komutlarını yönetmez. GitHub’te depo erişimini sınırlayın ve şube koruması ve PR incelemesi zorunlu kılın. Dağıtım bağlayıcısı için, derleme günlüklerini okumayı, üretim dağıtımı başlatmayı birbirinden ayırın; Paperclip’in Netlify kılavuzu, dağıtım ve yapılandırma değişiklikleri için Önce sor veya Kapalı seçeneğini önerir. Kimlik bilgilerini web sitesi kaynağının dışında tutun ve her aracıya yalnızca görevinin gerektirdiği erişimi verin.

İstemi oluştur: “Onaylanan site haritasını [depoda] uygulayın. Kararlaştırılan tasarımı koruyun, gezinmeyi ve formları işlevsel hale getirin ve her sayfaya başlık ve açıklama meta verileri ekleyin. Bir dal üzerinde çalışın, projenin kontrollerini çalıştırın, PR ve önizleme URL’sini Ataç görevine ekleyin ve herhangi bir üretim dağıtımından önce durun.”

Ayrı sorun durumu, kaynak kontrolü ve yayınlama

Ataç, her sayının kime ait olduğunu ve devir işlemine hangi kanıtların eşlik ettiğini kaydeder. Deponuz hâlâ uygulamayı barındırıyor ve konuşlandırılan web sitesini bir barındırma sağlayıcısı çalıştırıyor. Her sayıyı tam şubeye, halkla ilişkilere, önizlemeye, test günlüğüne ve ekran görüntülerine bağlayın. Görev yalnızca “en son”a atıfta bulunuyorsa, gözden geçirenler, sonuçta dağıtılan dalla eşleşmeyen bir önizlemeyi yanlışlıkla onaylayabilir.

İncelemeyi ‘tamamlanmış görünüyor’ diyen bir mesaj değil, bir kapı haline getirin

Kalite Güvencesinden gerçek önizlemeyi masaüstü ve mobil cihazlarda açmasını isteyin. İlk ekran vaadini, klavye gezintisini, alternatif metni, bozuk bağlantıları, form davranışını, yüklemeyi, konsol hatalarını ve sayfa meta verilerini kontrol edin. Pazarlamanın ürün iddialarını ve CTA’yı doğrulamasını sağlayın. Tekrarlanabilir kanıtları kaydedin. Bir formun arka uca ihtiyacı varsa gönderimi uçtan uca test edin.

Paperclip’in yürütme politikası, sorunu bir inceleyene ve ardından yürütücüsü görevi tamamlandı olarak işaretlemeye çalıştığında onaylayana yönlendirebilir. İstenen değişiklikler orijinal uygulayıcıya geri döner. Genel yayın için insan onayı aşamasını kullanın ve gözden geçiren kişi son önizlemeyi ve hedef etki alanını denetleyene kadar bir görevin onaylanmasının yayınlama izni olmadığını belirtin.

KG istemi: “Önizlemeyi dar bir mobil görünüm alanında ve masaüstünde kabul kriterlerine göre test edin. Başarılı, başarısız, kanıt URL’si veya ekran görüntüsü ve çoğaltma adımlarından oluşan bir tablo gönderin. Onaylamayın veya dağıtmayın; hataları uygulama sahibine geri gönderin.”

Lansman için pratik bir kabul kontrol listesi

• Ürün: Kahramanın vaadini, fiyatlandırma beyanlarını ve harekete geçirici mesaj hedeflerini onaylanmış metinle karşılaştırın.
• İşlev: gezinmeye tıklayın, bir test iletişim isteği gönderin ve başarı veya başarısızlık yolunu inceleyin.
• Duyarlı tasarım: dar ekranları, masaüstünü, içerik taşmasını, görüntü kırpmayı ve okunabilir aralığı inceleyin.
• Erişilebilirlik: klavye sırasını, etiketleri, alternatif metni, anlamsal başlıkları ve kontrastı kontrol edin.
• Arama ve güvenilirlik: rotaya özgü başlıkları ve açıklamaları, bozuk bağlantıları, konsol hatalarını ve üretim varlık yüklemesini onaylayın.

Onaylanan yapıyı gerçek bir genel URL’ye dağıtın

Son incelemeden önce üretim yerini seçin. Geleneksel bir kod tabanı için, havuzu Netlify veya Vercel gibi bir ana bilgisayara bağlayın, derleme ayarlarını ve ortam değişkenlerini kontrol edin ve ana bilgisayarın önce bir önizleme oluşturmasına izin verin. İnsan onayından sonra, incelenen revizyonu söz konusu ana bilgisayarın belgelenmiş iş akışını kullanarak tanıtın veya dağıtın. Oturumu kapatmışken üretim URL’sini açın; test gezintisi, formlar, sertifika, etki alanı ve dağıtılan revizyon. Paperclip’in bir sunucuda çalıştırılması yalnızca düzenleme uygulamasının erişilebilir olmasını sağlar; web sitesini yayınlamaz.

Web sitesi uygun bir HTML veya React uygulama yapısıysa, AgentGrid.io kişilerin ve bağlı temsilcilerin aynı sürümü düzenlediği paylaşılan yer olabilir. Bir proje klasörünü veya ZIP’i içe aktarın veya bağlı bir aracının amaçlanan çalışma alanında yapıyı oluşturmasını sağlayın. Oluşturulan uygulamayı ve Geçmişi burada inceleyin. Yapıt bağlantısı, çalışma alanı erişimi olan kişilere özeldir; yayınlama, genel bir URL oluşturan ayrı ve açık bir eylemdir. Bağlantılı bir aracının yayınlama yeteneğine ve yayınlamak için insan isteğine ihtiyacı vardır. Daha sonra yapılan düzenlemeler, yeniden yayınlanana kadar genel sayfanın dışında kalır. Özel alan adları, uygun bir ücretli plan ve doğrulanmış DNS gerektirir. Bu, Paperclip’in AgentGrid.io ile otomatik olarak entegre olduğu iddiası değil, alternatif bir yayınlama yoludur.

Başlatma istemi: “İnsan tarafından onaylanan revizyon, [taahhüt veya yapı sürümüdür. Bunu [belirtilen ana makineye] dağıtın veya [belirtilen AgentGrid.io yapıtını] yalnızca açık yetkilendirme sonrasında yayınlayın. Genel URL’yi, dağıtılan revizyonu, derleme sonucunu ve duman testi kontrol listesini döndürün. Hedef veya izin eksikse, durun ve sorun.”

Promosyon belirli bir revizyona atıfta bulunmalıdır

Yayınlamadan önce, onaylanmış taahhüt veya yapı sürümünü, hedef ana bilgisayarı veya çalışma alanını, etki alanını ve yayını kimin başlatabileceğini kaydedin. Ana bilgisayar önizleme URL’leri oluşturuyorsa, yükseltmeden önce aynı revizyonun son önizlemesini inceleyin. Daha sonra ayrıcalıklı bir oturum olmadan genel URL’yi açın ve kritik duman testlerini tekrarlayın. İletişim rotasının veya varlıkların üretim ayarları altında kalması durumunda bir geri alma referansı kaydedin.

Bir ekip her katmanı ne zaman kullanmalıdır?

Ataç: birden fazla temsilcinin atanan sorunlara, bağımlılıklara, incelemelere ve sorumlu bir insan başlatma sahibine ihtiyaç duyduğu durumlarda bunu seçin. Kaynak kontrolü veya web barındırma yerine ekibe ne yapması gerektiğini söyler ve işi takip eder.

Depo ve ana bilgisayar: sitenin mevcut bir mühendislik sürüm sürecine, sunucu özelliklerine, altyapı ayarlarına veya yerleşik geri alma kontrollerine ihtiyacı olduğunda bu yolu seçin. İncelenen taahhüt ve dağıtım kaydı, canlı sürümü tanımlamalıdır.

Onaylanan sürümden devam et

Paperclip’in ödevleri ve incelemeleri vardır. Deponuz ve ana makineniz kendi geleneksel üretim dağıtımına sahiptir. AgentGrid.io, paylaşılan, sürümü oluşturulmuş bir yapıyı ve onun kasıtlı yayınını barındırabilir. Başka bir aracıdan siteye iş akışının karşılaştırması için bkz. Grok Bot yayınlama kılavuzu; paylaşılan yapıtların ardındaki aktarma sorunu için şunu okuyun: AgentGrid.io tanıtımımız; ve tasarımın öncelikli olduğu bir yol için bkz. Claude Tasarım web sitesini yayınlama.

Onaylanan web sitesini tek bir yerde tutmaya hazır mısınız? AgentGrid.io yapıtı oluşturma, uygun erişime sahip bir sonraki ortak çalışanı davet edin ve yalnızca genel sürüm incelemeyi geçtikten sonra yayınlayın.