Cabang AI: Perubahan Proyek yang Lebih Aman dengan Agen AI

Ini adalah seri 10 bagian yang menceritakan bagaimana Apidog mengembangkan Apidog CLI, sebuah alat baris perintah untuk pengujian API dan manajemen siklus hidup API. Bacalah secara berurutan atau lompat ke postingan mana pun yang menarik minat Anda:

Ketika Agen memodifikasi sumber daya proyek, keamanan dan kemampuan tinjauan menjadi penting. Cabang AI menyediakan lingkungan pengeditan yang terisolasi—perubahan masuk ke cabang target hanya setelah konfirmasi manusia.

Tantangan Keamanan

Ketika Agen AI berpartisipasi dalam pengembangan dan pengujian API, mereka dapat membuat, memperbarui, dan menghapus sumber daya proyek melalui perintah CLI.

Kekuatan ini datang dengan risiko.

Bagaimana Anda membiarkan Agen bekerja pada proyek nyata tanpa mempertaruhkan cabang utama?

Cabang AI: Lapisan Keamanan

Cabang AI adalah jenis khusus dari Cabang Sprint yang dirancang khusus untuk operasi AI dan CLI eksternal.

Konsep utama:

Semua operasi pengeditan yang dimulai dari Apidog CLI diperlakukan sebagai diinisiasi oleh AI / Agen AI secara default.

Cabang AI menyediakan Agen AI dengan cabang pengeditan yang terisolasi. Perubahan tetap berada di Cabang AI sampai manusia meninjau dan menggabungkannya.

Agen membuat perubahan via CLI
        ↓
Perubahan disimpan di Cabang AI (terisolasi)
        ↓
Pengguna meninjau perbedaan
        ↓
Pengguna mengonfirmasi cakupan sumber daya
        ↓
Gabungkan ke cabang target (langsung atau permintaan gabungan)

Cabang utama tetap tidak tersentuh sampai Anda menyetujuinya.

Mengapa Cabang AI Dibutuhkan

Pengeditan yang diinisiasi oleh AI bisa tidak terduga. Apidog CLI menyediakan berbagai kemampuan pengeditan—titik akhir, skema, skenario pengujian, suite pengujian, dan lainnya.

Cabang AI dirancang untuk operasi pengeditan yang diinisiasi AI dengan risiko lebih tinggi ini.

Ini memungkinkan Agen AI untuk mengedit sumber daya proyek dalam cakupan yang terkontrol:

Apa Itu Cabang AI?

Cabang AI adalah cabang sprint khusus dengan karakteristik spesifik:

Karakteristik Utama

Cara Kerjanya

Pengeditan normal di klien oleh pengguna masih mengikuti izin anggota proyek dan aturan perlindungan cabang.

Kasus Penggunaan

Cabang AI cocok ketika AI perlu berpartisipasi dalam pemeliharaan proyek sambil mempertahankan isolasi cabang dan konfirmasi manusia.

Alur Kerja Dasar

Alur kerja Cabang AI yang khas:

┌─────────────────────────────────────────────────────────────────┐
│                     ALUR KERJA CABANG AI                         │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  Langkah 1: Buat Cabang AI                                       │
│  ┌───────────────────────────────────────────┐                  │
│  │ apidog branch create --type ai             │                  │
│  │ --name "ai/20260312-from-main-feature"     │                  │
│  │ --from main                                │                  │
│  └───────────────────────────────────────────┘                  │
│                    ↓                                             │
│  Langkah 2: Impor atau Buat Sumber Daya                          │
│  ┌───────────────────────────────────────────┐                  │
│  │ apidog branch pick-to (impor yang sudah ada) │                  │
│  │ ATAU                                         │                  │
│  │ apidog endpoint create (buat yang baru)      │                  │
│  └───────────────────────────────────────────┘                  │
│                    ↓                                             │
│  Langkah 3: AI Memodifikasi Sumber Daya                          │
│  ┌───────────────────────────────────────────┐                  │
│  │ Agen menggunakan CLI untuk memperbarui titik akhir,│                  │
│  │ skema, skenario pengujian, dll.            │                  │
│  │ (--parameter --branch menentukan Cabang AI) │                  │
│  └───────────────────────────────────────────┘                  │
│                    ↓                                             │
│  Langkah 4: Pengguna Meninjau Perbedaan                          │
│  ┌───────────────────────────────────────────┐                  │
│  │ apidog merge-request preview              │                  │
│  │ ATAU                                         │                  │
│  │ Lihat di klien Apidog                     │                  │
│  └───────────────────────────────────────────┘                  │
│                    ↓                                             │
│  Langkah 5: Gabungkan ke Cabang Target                           │
│  ┌───────────────────────────────────────────┐                  │
│  │ Penggabungan langsung (cabang tidak terlindungi)│                  │
│  │ ATAU                                         │                  │
│  │ Permintaan penggabungan (cabang terlindungi) │                  │
│  └───────────────────────────────────────────┘                  │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

Buat Cabang AI

Gunakan branch create --type ai:

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

Rekomendasi penamaan: ai/YYYYMMDD-from-sourceBranch-featureOrModule

Edit Sumber Daya di Cabang AI

Ketika CLI menulis sumber daya proyek, gunakan parameter --branch untuk menulis ke Cabang AI:

Alur kerja yang direkomendasikan:

# 1. Dapatkan skema
apidog cli-schema get endpoint-create

# 2. Validasi sebelum menulis
apidog cli-schema validate endpoint-create --file ./endpoint.json

# 3. Tulis ke Cabang AI (bukan utama)
apidog endpoint create \
  --project 123456 \
  --branch "ai/20260312-from-main-userRegister" \
  --file ./endpoint.json

Impor Sumber Daya yang Ada

Untuk memodifikasi sumber daya yang ada, impor terlebih dahulu dari cabang sumber:

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

Ini memastikan AI bekerja dengan versi dasar yang benar.

Tinjau Perubahan Sebelum Menggabungkan

Sebelum menggabungkan, pratinjau perbedaannya:

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

Atau lihat perbedaan lengkap di klien Apidog.

Gabungkan Cabang AI

Setelah ditinjau, gabungkan perubahan:

Penggabungan Langsung (Cabang Tidak Terlindungi)

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

Permintaan Penggabungan (Cabang Terlindungi)

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

Penting: Perintah penggabungan hanya memproses daftar sumber daya yang disediakan secara eksplisit. Konfirmasikan dependensi (direktori, model, komponen respons, pengujian) sebelum menggabungkan.

Arsip dan Hapus

Setelah perubahan digabungkan atau tidak lagi diperlukan:

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

# Hapus (setelah mengarsipkan)
apidog branch delete "ai/20260312-from-main-userRegister" \
  --project 123456 --type ai

Izin Edit AI Eksternal

Secara default, CLI menulis ke Cabang AI. Ini menjaga perubahan yang dihasilkan AI terisolasi sampai konfirmasi pengguna.

Untuk mengaktifkan pengeditan langsung cabang utama:

Pengaturan Proyek → Pengaturan Fitur → Pengaturan Fitur AI → Izin Edit AI Eksternal

Rekomendasi: Jaga isolasi Cabang AI tetap aktif. Aktifkan edit langsung hanya ketika alur kerja otomatisasi jelas membutuhkannya.

Praktik Terbaik

Cabang AI dalam Alur Kerja CLI + SKILL

Cabang AI terintegrasi secara alami dengan CLI + SKILL:

Setiap penulisan melewati Cabang AI → tinjauan manusia → penggabungan.

Ringkasan Keamanan

Bersama-sama, lapisan-lapisan ini menciptakan siklus yang lebih aman untuk perubahan proyek yang digerakkan oleh Agen.

Apa Selanjutnya

Dengan Cabang AI yang menyediakan lapisan keamanan, semua bagian sudah tersedia:

• MCP untuk koneksi alat (Bagian 1)
• CLI + SKILL untuk eksekusi alur kerja (Bagian 2-5)
• Hasil validasi (Bagian 6)
• Alur kerja praktis (Bagian 7)
• Dasar CI/CD (Bagian 8)
• Cabang AI untuk keamanan (Bagian 9)

Sekarang saatnya untuk visi.

Pada Bagian 10, Spec-First Adalah Kemarin. Selamat Datang di Skill-First., kami akan menguraikan bagaimana pengembangan API berkembang dengan Agen AI—dan apa yang harus dilakukan tim selanjutnya.

Poin-Poin Penting

• Cabang AI menyediakan pengeditan terisolasi untuk operasi AI/CLI
• Perubahan tidak memengaruhi cabang utama sampai konfirmasi manusia
• Buat dengan branch create --type ai, tulis dengan parameter --branch
• Impor sumber daya yang ada dengan branch pick-to sebelum mengedit
• Pratinjau dengan merge-request preview, lalu gabungkan atau buat permintaan penggabungan
• Izin edit langsung dapat memintas Cabang AI—gunakan dengan hati-hati
• Praktik terbaik: satu Cabang AI per tugas, validasi sebelum menulis, tinjau sebelum menggabungkan

Unduh Apidog untuk mendesain, membuat mock, menguji, dan mendokumentasikan API dalam satu ruang kerja. Pelajari lebih lanjut tentang Apidog CLI untuk pengujian API baris perintah, otomatisasi CI, dan alur kerja Agen AI.