Yapay Zeka Alanı: Ajan Destekli Güvenli Proje Değişiklikleri

Bu, Apidog'un API testi ve API yaşam döngüsü yönetimi için bir komut satırı aracı olan Apidog CLI'yı nasıl geliştirdiğini paylaşan 10 bölümlük bir seridir. Sırayla okuyun veya ilginizi çeken herhangi bir gönderiye atlayın:

Bir Ajan proje kaynaklarını değiştirdiğinde, güvenlik ve gözden geçirilebilirlik önemlidir. AI Branch, izole bir düzenleme ortamı sağlar; değişiklikler hedef dalına ancak insan onayıyla girer.

Güvenlik Zorluğu

Yapay Zeka Ajanları API geliştirme ve test etme süreçlerine katıldığında, CLI komutları aracılığıyla proje kaynakları oluşturabilir, güncelleyebilir ve silebilirler.

Bu güç riskle birlikte gelir.

Ajanların ana dalı riske atmadan gerçek projeler üzerinde çalışmasına nasıl izin verirsiniz?

AI Branch: Güvenlik Katmanı

AI Branch, özellikle harici yapay zeka ve CLI operasyonları için tasarlanmış özel bir Sprint Dalı türüdür.

Anahtar kavram:

Apidog CLI'dan başlatılan tüm düzenleme operasyonları, varsayılan olarak Yapay Zeka / Yapay Zeka Ajanları tarafından başlatılmış olarak kabul edilir.

AI Branch, Yapay Zeka Ajanlarına izole bir düzenleme dalı sağlar. Değişiklikler, bir insan tarafından gözden geçirilip birleştirilene kadar AI Branch'ta kalır.

Ajan CLI aracılığıyla değişiklikler yapar
        ↓
Değişiklikler AI Branch'ta saklanır (izole)
        ↓
Kullanıcı farklılıkları inceler
        ↓
Kullanıcı kaynak kapsamını onaylar
        ↓
Hedef dala birleştir (doğrudan veya birleştirme isteği)

Onaylayana kadar ana dal dokunulmadan kalır.

AI Branch Neden Gerekli?

Yapay zeka tarafından başlatılan düzenlemeler tahmin edilemez olabilir. Apidog CLI, geniş bir düzenleme yeteneği yelpazesi sunar: uç noktalar, şemalar, test senaryoları, test paketleri ve daha fazlası.

AI Branch, bu yüksek riskli yapay zeka tarafından başlatılan düzenleme operasyonları için tasarlanmıştır.

Yapay Zeka Ajanlarının kontrol edilebilir bir kapsamda proje kaynaklarını düzenlemesine olanak tanır:

AI Branch Nedir?

AI Branch, belirli özelliklere sahip özel bir sprint dalıdır:

Temel Özellikler

Nasıl Çalışır

Kullanıcılar tarafından istemci içi normal düzenleme, yine proje üyesi izinlerini ve dal koruma kurallarını takip eder.

Kullanım Durumları

AI Branch, yapay zekanın dal izolasyonu ve insan onayını koruyarak proje bakımına katılması gerektiğinde uygundur.

Temel İş Akışı

Tipik bir AI Branch iş akışı:

┌─────────────────────────────────────────────────────────────────┐
│                     YAPAY ZEKA DALI İŞ AKIŞI                     │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  Adım 1: Yapay Zeka Dalı Oluşturma                               │
│  ┌───────────────────────────────────────────┐                  │
│  │ apidog branch create --type ai             │                  │
│  │ --name "ai/20260312-from-main-feature"     │                  │
│  │ --from main                                │                  │
│  └───────────────────────────────────────────┘                  │
│                    ↓                                             │
│  Adım 2: Kaynakları İçe Aktarma veya Oluşturma                   │
│  ┌───────────────────────────────────────────┐                  │
│  │ apidog branch pick-to (mevcut olanı içe aktar) │                  │
│  │ VEYA                                         │                  │
│  │ apidog endpoint create (yeni oluştur)        │                  │
│  └───────────────────────────────────────────┘                  │
│                    ↓                                             │
│  Adım 3: Yapay Zeka Kaynakları Değiştirir                        │
│  ┌───────────────────────────────────────────┐                  │
│  │ Ajan, CLI'yı kullanarak uç noktaları,       │                  │
│  │ şemaları, test senaryolarını vb. günceller.│                  │
│  │ (--branch parametresi AI Dalı'nı belirtir)  │                  │
│  └───────────────────────────────────────────┘                  │
│                    ↓                                             │
│  Adım 4: Kullanıcı Farklılıkları İnceler                         │
│  ┌───────────────────────────────────────────┐                  │
│  │ apidog merge-request preview              │                  │
│  │ VEYA                                         │                  │
│  │ Apidog istemcisinde görüntüle             │                  │
│  └───────────────────────────────────────────┘                  │
│                    ↓                                             │
│  Adım 5: Hedef Dala Birleştirme                                  │
│  ┌───────────────────────────────────────────┐                  │
│  │ Doğrudan birleştirme (korunmasız dal)         │                  │
│  │ VEYA                                         │                  │
│  │ Birleştirme isteği (korumalı dal)          │                  │
│  └───────────────────────────────────────────┘                  │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

AI Branch Oluşturma

branch create --type ai kullanın:

apidog branch create \
  --project 123456 \
  --type ai \
  --name "ai/20260312-from-main-userRegister" \
  --from main

Adlandırma tavsiyesi: ai/YYYYAAAGGG-kaynakDaldan-özellikVeyaModül

AI Branch'ta Kaynakları Düzenleme

CLI proje kaynakları yazdığında, AI Branch'a yazmak için --branch parametresini kullanın:

Önerilen iş akışı:

# 1. Şemayı al
apidog cli-schema get endpoint-create

# 2. Yazmadan önce doğrula
apidog cli-schema validate endpoint-create --file ./endpoint.json

# 3. AI Branch'a yaz (ana dala değil)
apidog endpoint create \
  --project 123456 \
  --branch "ai/20260312-from-main-userRegister" \
  --file ./endpoint.json

Mevcut Kaynakları İçe Aktarma

Mevcut kaynakları değiştirmek için, önce onları kaynak daldan içe aktarın:

apidog branch pick-to \
  --project 123456 \
  --from main \
  --to "ai/20260312-from-main-userRegister" \
  --endpoint-ids 1001,1002

Bu, yapay zekanın doğru temel sürümle çalışmasını sağlar.

Birleştirmeden Önce Değişiklikleri Gözden Geçirme

Birleştirmeden önce farklılıkları önizleyin:

apidog merge-request preview \
  --project 123456 \
  --from "ai/20260312-from-main-userRegister" \
  --to main

Veya Apidog istemcisinde tam farkı görüntüleyin.

AI Branch'ı Birleştirme

İncelemeden sonra değişiklikleri birleştirin:

Doğrudan Birleştirme (Korunmasız Dal)

apidog branch merge \
  --project 123456 \
  --from "ai/20260312-from-main-userRegister" \
  --to main \
  --endpoint-ids 1001,1002

Birleştirme İsteği (Korumalı Dal)

apidog merge-request create \
  --project 123456 \
  --from "ai/20260312-from-main-userRegister" \
  --to main \
  --reviewer-ids 20001,20002 \
  --endpoint-ids 1001,1002

Önemli: Birleştirme komutları yalnızca açıkça sağlanan kaynak listesini işler. Birleştirmeden önce bağımlılıkları (dizinler, modeller, yanıt bileşenleri, testler) onaylayın.

Arşivle ve Sil

Değişiklikler birleştirildikten veya artık gerekmedikten sonra:

# Arşivle
apidog branch archive "ai/20260312-from-main-userRegister" \
  --project 123456 --type ai

# Sil (arşivledikten sonra)
apidog branch delete "ai/20260312-from-main-userRegister" \
  --project 123456 --type ai

Harici Yapay Zeka Düzenleme İzinleri

Varsayılan olarak, CLI AI Branch'a yazar. Bu, yapay zeka tarafından oluşturulan değişiklikleri kullanıcı onayına kadar izole tutar.

Ana dalın doğrudan düzenlenmesini etkinleştirmek için:

Proje Ayarları → Özellik Ayarları → Yapay Zeka Özellik Ayarları → Harici Yapay Zeka Düzenleme İzinleri

Tavsiye: AI Branch izolasyonunu etkin tutun. Doğrudan düzenlemeyi yalnızca otomasyon iş akışları açıkça gerektirdiğinde etkinleştirin.

En İyi Uygulamalar

CLI + SKILL İş Akışında AI Branch

AI Branch, CLI + SKILL ile doğal olarak entegre olur:

Her yazma işlemi AI Branch → insan incelemesi → birleştirme yoluyla gerçekleşir.

Güvenlik Özeti

Bu katmanlar birlikte, Ajan odaklı proje değişiklikleri için daha güvenli bir döngü oluşturur.

Sıradaki Ne?

AI Branch'ın güvenlik katmanını sağlamasıyla tüm parçalar yerine oturdu:

• Araç bağlantısı için MCP (Bölüm 1)
• İş akışı yürütme için CLI + SKILL (Bölüm 2-5)
• Doğrulama sonuçları (Bölüm 6)
• Pratik iş akışları (Bölüm 7)
• CI/CD temeli (Bölüm 8)
• Güvenlik için AI Branch (Bölüm 9)

Şimdi vizyon zamanı.

Bölüm 10'da, Önce Belirtim Dündü. Önce Yetenek'e Hoş Geldiniz., API geliştirmenin Yapay Zeka Ajanları ile nasıl evrildiğini ve ekiplerin bundan sonra ne yapması gerektiğini özetleyeceğiz.

Temel Çıkarımlar

• AI Branch, yapay zeka/CLI operasyonları için izole düzenleme sağlar
• Değişiklikler, insan onayı olana kadar ana dalı etkilemez
• branch create --type ai ile oluşturun, --branch parametresiyle yazın
• Düzenlemeden önce mevcut kaynakları branch pick-to ile içe aktarın
• merge-request preview ile önizleyin, ardından birleştirin veya birleştirme isteği oluşturun
• Doğrudan düzenleme izinleri AI Branch'ı atlayabilir—dikkatli kullanın
• En iyi uygulama: görev başına bir AI Branch, yazmadan önce doğrula, birleştirmeden önce incele

Tek bir çalışma alanında API'ları tasarlamak, sahte verilerini oluşturmak, test etmek ve belgelendirmek için Apidog'u indirin. Komut satırı API testi, CI otomasyonu ve yapay zeka ajan iş akışları için Apidog CLI hakkında daha fazla bilgi edinin.