İçeriğe geç

Rehberli kurulum: sizi herhangi bir web sitesinde adım adım yönlendiren bir agent

Agent paneli gezer; şifre, kod ve ödeme için sayfayı size devreder, aradığı API anahtarını da yerine koyar. Nasıl çalıştığını anlatıyoruz.

Yazan: SuperDevSpace

Yayın 6 dk okuma

Diğer diller: English Deutsch Français Español Português (Brasil) 日本語 简体中文

Uygulamanın yerleşik tarayıcı panelinde açık bir web sayfası ve yanında agent paneli

Her proje er ya da geç bir web sitesinden bir şeye ihtiyaç duyar. Bir ödeme sağlayıcısının API anahtarı. Bir webhook sırrı. Üç menü derindeki bir panelden alınacak bir client token. Bir agent entegrasyonu dakikalar içinde yazar, sonra durur ve paneli sizin gezmeniz gerektiğini söyler — çünkü o kısım bir tarayıcıda, sizin oturumunuzun arkasında olur.

Rehberli kurulum, SuperDevSpace'in bu boşluğu kapatma yolu. Agent siteyi uygulamanın kendi tarayıcısında açar, yapmasına izin verilen tıklamaları yapar ve sıradaki adım sizinse sayfayı bir işaret ve tek bir cümleyle tam o anda size devreder.

Uygulamanın yerleşik tarayıcı panelinde bir web sayfası; seçilen bir öğe ve dosya-satır bilgisiyle bileşen zinciri
Uygulamanın içindeki tarayıcı paneli — rehberli kurulumun kullandığı panelin ta kendisi; burada Inspector ile (gerçek uygulama).

"Bırakın agent yapsın" neden yanlış cevap

Bu özelliğin kolay versiyonu agent'a tarayıcının tamamını verirdi: her alanı okusun, her kutuya yazsın, her düğmeye bassın. Hızlı olurdu ve kötü bir fikir olurdu. Bir kurulum akışı, bir agent'ın asla dokunmaması gereken şeylerle doludur:

  • şifreniz ve telefonunuza gelen tek kullanımlık kod;
  • kart numaraları, banka bilgileri ve kimlik belgeleri;
  • kabul ettiğiniz koşullar ve onayladığınız ödeme.

Bu yüzden tasarım tersten başlıyor. Agent rutin işi yapar — gezinir, doğru sayfayı bulur, bir proje adı yazar, Oluştur'a basar — kişisel ya da bağlayıcı olan her şey sizde kalır.

Kurulum akışındaki adımAgentSiz
Paneli açıp doğru sayfayı bulmak✓
Proje adı, URL, listeden bir seçim girmek✓
Şifrenizi ya da telefonunuzdaki kodu yazmak✗✓
Kart, banka ya da kimlik bilgisi girmek✗✓
Koşulları işaretlemek, "Öde" ya da "Siparişi ver"e basmak✗✓
Yeni API anahtarını okuyup .env'e koymak✓

Rehberli kurulum nasıl ilerler

Döngü her sitede aynı — kimsenin talimat yazmadığı siteler dahil.

  1. Sayfayı açar. Agent uygulamanın içinde bir tarayıcı sekmesi açar. O tarayıcıdaki oturumlarınız yeniden başlatmalarda korunur; büyük ihtimalle zaten giriş yapmışsınızdır.
  2. Hareket etmeden önce bakar. Agent sayfanın bir özetini ister: her başlık, düğme, bağlantı, alan ve frame için bir satır. Hassas alanlar türüyle listelenir — şifre, kart, banka, tek kullanımlık kod, kimlik — yanında "dolu" ya da "boş" yazar, asla değeri değil.
  3. Kendi yarısını yapar. Tıklar, sıradan alanları doldurur, metin okur; sayfayı değiştiren her şeyden sonra sayfayı yeniden okur.
  4. Sizin yarınızı devreder. Sıradaki adım sizinse agent sayfada bir rehber kartı gösterir: kısa bir başlık, tek bir somut talimat ve kastettiği alan ya da düğmede bir vurgu. Adımı yapar, Bitti — devral'a basarsınız. Takılırsanız Yardım lazım'a basıp ne gördüğünüzü yazarsınız; agent sayfada yanıt verir.
  5. Aynı turda bekler. Rehber açıkken agent sizi bekler. Sayfayı geri verene kadar tıklamaları ve yazmaları reddedilir; dilediğiniz an Durdur / kontrolü al'a basabilirsiniz.
  6. Sonucu yerine koyar. Sayfa aradığınız şeyi gösterdiğinde — bir API anahtarı, bir token, bir webhook sırrı — agent onu sır olarak okur ve ait olduğu yere, örneğin projenin .env dosyasına koyar. Anahtarın kendisini değil, nerede olduğunu raporlar.
Bir rehberli kurulum, ilk sayfadan saklanan anahtara kadarBir rehberli kurulum, ilk sayfadan saklanan anahtara kadar
Bir rehberli kurulum, ilk sayfadan saklanan anahtara kadar
Diyagramın metni
sequenceDiagram
  participant A as Agent
  participant B as Tarayıcı paneli
  participant Y as Siz
  participant E as .env
  A->>B: paneli aç
  A->>B: sayfanın özeti
  A->>Y: rehber kartı - giriş yap, sonra devret
  Y->>B: şifre ve tek kullanımlık kod
  Y->>A: Bitti - devral
  A->>B: API anahtarını oluştur
  B-->>A: anahtar sır olarak okundu
  A->>E: PADDLE_API_KEY kaydedildi
  A->>Y: anahtar .env içinde

İş bitince sonucu, ekrana bir sır basmadan kontrol edebilirsiniz:

Terminal
$ grep -o '^PADDLE_[A-Z_]*=' .env
PADDLE_API_KEY=
PADDLE_CLIENT_TOKEN=
PADDLE_WEBHOOK_SECRET=
PADDLE_ENVIRONMENT=

Uygulamanın uyguladığı kurallar

Bunlar uygulamadaki kontroller ve agent bunları kapatamaz:

  • İçeri sır yok, dışarı sır yok. Agent şifre, kart, CVC, IBAN, tek kullanımlık kod ya da kimlik alanına yazamaz. Sayfayı okuduğunda ya da anlık görüntü aldığında bu değerler gizlenir ve okuduğu her metinden temizlenir.
  • Ekran görüntülerinin üstü örtülür. Hassas alanlar ve her cross-origin frame — bir kart widget'ı, bir "Google ile giriş yap" kutusu — agent bir görüntü görmeden önce kapatılır.
  • Hassas sayfalarda betik yok. Böyle bir alan gösteren her sayfada sayfa içinde JavaScript çalıştırmak reddedilir.
  • Onay ve ödeme sizindir. Bir koşullar kutucuğuna ya da "Öde" / "Siparişi ver" düğmesine tıklamak reddedilir.
  • Her şey görünür. Agent'ın tarayıcı panelinde yaptıkları, olurken panelin şeridinde size gösterilir.
  • Sırlar konuşmanın dışında kalır. Sır olarak okunan bir değer hassas diye işaretlenir ve agent'a onu sohbette, raporlarda, görev notlarında ya da bildirimlerde asla tekrarlamaması söylenir.

Bir entegrasyon listesi değil, her web sitesi

Rehberli kurulum bir döngüdür, bir betik kütüphanesi değil. Kimsenin ipucu yazmadığı bir sitede de çalışır, çünkü agent önündeki gerçek sayfayı okur. Birkaç servis için kısa ipucu dosyaları veriyoruz — örneğin Paddle'ın sandbox paneli ve RevenueCat — geliştirici ayarlarının genelde nerede olduğunu agent'a söyleyen dosyalar. Paneller menülerini sürekli değiştirir; bu yüzden ipuçları açıkça şunu söyler: sayfa ile ipucu çelişirse sayfaya güven.

Bu, kulağa geldiğinden daha önemli. Bir agent'ın yazdığı entegrasyon kodu bir özelliğin yalnızca yarısı; diğer yarısı başkasının sitesindeki hesap, anahtar ve webhook. Rehberli kurulumla iki yarı da aynı oturumda, aynı agent'la olur; siz de zamanınızı yalnızca sizin yapabileceğiniz adımlara harcarsınız.

Nereye oturuyor

Rehberli kurulum, SuperDevSpace'teki her şeyle aynı çalışma alanının parçası: ödeme entegrasyonunuzu yazan agent, onun anahtarlarını oluştururken size eşlik eden agent'ın ta kendisidir — terminalinin yanındaki bir tarayıcı panelinde. Yeniyseniz, SuperDevSpace'i neden yaptığımızı anlatan yazı etrafındaki ekibin geri kalanını açıklıyor.

Deneyin

Deneme süresi 14 gün Premium, kart gerekmez. SuperDevSpace'i indirin, bir agent'tan projeniz için bir ödeme ya da analitik sağlayıcısı kurmasını isteyin ve sıra size geldiğinde sayfayı size devretmesine izin verin.

SuperDevSpace

SuperDevSpace’i yapan ekip yazdı: zaten sahip olduğun CLI aboneliğiyle bir yapay zekâ kod ajanı ekibi çalıştıran masaüstü uygulaması.

Paylaş

Lansman e-postasını al

SuperDevSpace herkese açıldığında tek bir e-posta. Önce adresini gelen kutundan doğrularsın; tek tıkla ayrılabilirsin.

Kendi yapay zekâ ekibini çalıştır

SuperDevSpace zaten sahip olduğun CLI aboneliğiyle çalışır. 14 gün ücretsiz, kart gerekmez.

Ücretsiz denemeyi başlat

Okumaya devam et