Site Oluşturucu Orkestrasyon v2

Site Oluşturucu Orkestrasyon v2 (Gratis AI Agent v1.4.0 ile tanıtıldı), çok adımlı web sitesi oluşturma sürecini yöneten motordur. Ajana "bir restoran web sitesi oluştur" veya "bir blog içeren portfolyo oluştur" dediğinizde, orkestratör bu yüksek seviyeli hedefi yapılandırılmış bir plan haline getirir, bunu yerine getirmek için gereken plugin'leri keşfeder, her adımı sırayla yürütür, ilerlemeyi takip eder ve hatalardan özerk bir şekilde kurtulur.

---

Nasıl Çalışır

1. Plan Oluşturma

Ajan bir site oluşturma talimatı aldığında, bir JSON site planı üretmek için create_site_plan yeteneğini çağırır. Plan şunları tanımlar:

• Goal (Amaç) — bitmiş sitenin ne yapması gerektiği
• Phases (Aşamalar) — sıralı adım grupları (örneğin, Kurulum, İçerik Tipleri, Tasarım, İçerik)
• Steps (Adımlar) — her aşama içindeki bireysel yetenek çağrıları
• Plugin requirements (Plugin gereksinimleri) — belirli adımların çalışması için aktif olması gereken plugin'ler
• Fallbacks (Yedeklemeler) — birincil bir adım başarısız olursa alternatif adımlar

Örnek plan (kısaltılmış)

{
  "plan_id": "plan_restaurant_001",
  "goal": "Online menü, rezervasyon formu ve iletişim sayfası içeren bir restoran web sitesi oluştur",
  "phases": [
    {
      "id": "setup",
      "label": "Kurulum",
      "steps": [
        { "ability": "install_ability", "params": { "slug": "gratis-ai-agent-woocommerce" } },
        { "ability": "register_post_type", "params": { "slug": "menu-item", "singular_label": "Menü Öğesi", "plural_label": "Menü Öğeleri" } },
        { "ability": "register_taxonomy", "params": { "slug": "menu-section", "singular_label": "Menü Bölümü", "plural_label": "Menü Bölümleri", "post_types": ["menu-item"] } }
      ]
    },
    {
      "id": "design",
      "label": "Tasarım",
      "steps": [
        { "ability": "apply_theme_json_preset", "params": { "preset": "warm-editorial" } },
        { "ability": "inject_custom_css", "params": { "css": ".menu-item { border-radius: 8px; }", "label": "restaurant-ui" } }
      ]
    },
    {
      "id": "navigation",
      "label": "Gezinme",
      "steps": [
        { "ability": "create_menu", "params": { "name": "Ana Gezinme", "location": "primary" } },
        { "ability": "add_menu_item", "params": { "menu_id": "__ref:create_menu.menu_id", "type": "custom", "title": "Menü", "url": "/menu-items/" } },
        { "ability": "add_menu_item", "params": { "menu_id": "__ref:create_menu.menu_id", "type": "custom", "title": "Masa Ayırt", "url": "/book/" } }
      ]
    }
  ],
  "plugin_requirements": [
    { "slug": "contact-form-7", "reason": "Rezervasyon ve iletişim formları için gerekli" }
  ]
}

2. Plugin Keşfi

Yürütme başlamadan önce, orkestratör planın plugin_requirements bölümünü tarar ve hangi plugin'lerin zaten aktif olduğunu kontrol eder. Eksik plugin'ler için ise şunları yapar:

1. En iyi eşleşmeyi bulmak için recommend_plugin aracılığıyla kayıt defterini tarar.
2. Ajandan öneriyi onaylamasını ister.
3. Onaylanırsa (veya ayarlarda otomatik kurulum etkinse) kurulumu tetikler.

Plugin keşfi başarısız olursa bu kritik bir hata değildir — orkestratör etkilenen adımları skipped (atlandı) olarak işaretler ve planın geri kalan adımlarıyla devam eder.

3. Plan Yürütme

Orkestratör, plan kimliği ile execute_site_plan çağrısını yapar. Yürütme, aşama aşama, adım adım ilerler:

• Step references (Adım referansları) (__ref: ön eki) — adımlar önceki adımların çıktılarına referans verebilir. Yukarıdaki örnekte, __ref:create_menu.menu_id, create_menu adımından dönen menu_id değerine çözümlenir.
• Parallel steps (Paralel adımlar) — aynı aşama içindeki ve birbiriyle bağımlılığı olmayan adımlar, parallel bayrağı ayarlandığında eş zamanlı olarak gönderilir.
• Step timeout (Adım zaman aşımı) — her adımın bireysel bir zaman aşımı süresi vardır (varsayılan: Ability Timeout ayarı). Zaman aşımına uğrayan bir adım failed (başarısız) olarak işaretlenir ve plan devam eder.

4. İlerleme Takibi

Yürütme durumunu kontrol etmek için herhangi bir zamanda get_plan_progress çağrısını yapın:

{
  "plan_id": "plan_restaurant_001",
  "status": "in_progress",
  "phases_total": 4,
  "phases_complete": 2,
  "steps_total": 14,
  "steps_complete": 8,
  "steps_failed": 1,
  "steps_skipped": 0,
  "current_step": "add_menu_item",
  "elapsed_seconds": 42
}

WP-CLI kullanıcıları ilerlemeyi şu komutla izleyebilir:

wp gratis-ai-agent plan status plan_restaurant_001

5. Hata Kurtarma

Bir adım başarısız olduğunda, orkestratör planda tanımlanmış bir fallback (yedekleme) adımı arar:

• Fallback available (Yedekleme mevcut) — yedekleme adımı hemen denenir. Başarılı olursa, yürütme devam eder. Eğer bu da başarısız olursa, adım failed (başarısız) olarak işaretlenir ve yürütme bir sonraki adımla devam eder.
• No fallback (Yedekleme yok) — adım failed (başarısız) olarak işaretlenir. Kritik olmayan adımlar atlanır; kritik adımlar ( required: true olarak işaretlenmiş) mevcut aşamayı durdurur ve aşama düzeyinde bir kurtarma denemesi başlatır.

Ajan, tüm başarısızlıkları son plan özetinde raporlar ve kurtarılamayan hatalar için manuel düzeltme adımları önerebilir.

---

Site Plan Yetenekleri

create_site_plan

Doğal dil hedef açıklamasından yapılandırılmış bir site planı oluşturur.

Parametreler

Parameter	Type	Required	Description
goal	string	Yes	İstenen web sitesinin doğal dil açıklaması
style	string	No	Görsel stil tercihi: minimal, bold, professional, playful. Varsayılan: ajan, hedefe göre seçer
plugins	array	No	Plana dahil edilecek plugin slug'ları. Orkestratör gerekli plugin'leri otomatik olarak ekler.
dry_run	boolean	No	true ise, planı kaydetmeden veya çalıştırmadan JSON olarak döndürür. Varsayılan false

Returns { "plan_id": "plan_restaurant_001", "phases": 4, "steps": 14, "plugin_requirements": 1 }

---

execute_site_plan

Daha önce oluşturulmuş bir site planını çalıştırmaya başlar.

Parametreler

Parameter	Type	Required	Description
plan_id	string	Yes	Çalıştırılacak planın kimliği
auto_install_plugins	boolean	No	true ise, onay istemeden gerekli plugin'leri otomatik olarak kurar. Varsayılan false
max_retries	integer	No	Devam etmeden önce başarısız bir adımı deneme sayısı. Varsayılan 1

Returns { "execution_id": "exec_001", "status": "started" }

---

get_plan_progress

Bir site planının mevcut yürütme durumunu döndürür.

Parametreler

Parameter	Type	Required	Description
plan_id	string	Yes	Sorgulanacak Plan ID

Returns Yukarıdaki Progress Tracking bölümünde açıklanan ilerleme nesnesi.

---

handle_plan_error

Başarısız bir adımı manuel olarak çözer ve plan yürütmesini bir sonraki adımdan devam ettirir. Otomatik kurtarma mümkün olmadığında ve müdahale etmek istediğinizde bunu kullanın.

Parametreler

Parameter	Type	Required	Description
plan_id	string	Yes	Plan ID
step_id	string	Yes	Başarısız olan adımın ID'si
resolution	string	Yes	skip (atla ve devam et), retry (adıma hemen yeniden dene) veya mark_done (yeniden çalıştırmadan başarılı say)

Returns { "success": true, "plan_id": "plan_restaurant_001", "resumed_from": "add_menu_item" }

---

v1 ve v2 Karşılaştırması

Feature	v1	v2
Multi-phase plans (Çok aşamalı planlar)	No	Yes
Step output references (__ref:) (Adım çıktısı referansları)	No	Yes
Plugin discovery (Plugin keşfi)	Manual (Manuel)	Automatic (Otomatik)
Progress tracking API (İlerleme takibi API'si)	No	Yes
Error recovery (Hata kurtarma)	Fail-and-stop (Hata ver ve dur)	Fallback + continue (Yedekleme + devam et)
Parallel step execution (Paralel adım yürütme)	No	Yes (opt-in per phase) (Aşama bazında isteğe bağlı)
WP-CLI plan commands (WP-CLI plan komutları)	No	Yes
Benchmark integration (Kıyaslama entegrasyonu)	No	Yes (q-restaurant-website)

---

WP-CLI Plan Komutları

wp gratis-ai-agent plan create

Bir hedef açıklamasından site planı oluşturur.

wp gratis-ai-agent plan create "Build a restaurant website with an online menu, booking form, and contact page" [--dry-run] [--output=json]

wp gratis-ai-agent plan execute

Daha önce oluşturulmuş bir planı yürütür.

wp gratis-ai-agent plan execute plan_restaurant_001 [--auto-install-plugins]

wp gratis-ai-agent plan status

Yürütülmekte olan veya tamamlanmış bir planın mevcut ilerlemesini gösterir.

wp gratis-ai-agent plan status plan_restaurant_001

wp gratis-ai-agent plan list

Tüm site planlarını (beklemede, devam ediyor ve tamamlanmış) listeler.

wp gratis-ai-agent plan list [--status=<status>] [--format=table|json|csv]

wp gratis-ai-agent plan reset

Başarısız olan bir planı pending (beklemede) durumuna sıfırlar, böylece baştan yeniden yürütülebilir.

wp gratis-ai-agent plan reset plan_restaurant_001