<!-- Canonical URL: https://ask.atlascloud.ai/tr/build-sanitized-request-replay-set-llm-api-migration -->

# LLM API geçişi için temizlenmiş istek replay kümesi nasıl oluşturulur?

> Kapsama göre örnek seçerek, gereksiz alanları silerek, hassas değerleri yapıyı koruyan tutarlı sentetik verilerle değiştirerek, dış araçları yalıtarak ve son ürünü yeniden tarayarak küçük ve sürümlü bir replay corpus oluşturun.

Temsilî üretim isteklerini seçin, sırları ve kişisel verileri bulup değiştirin, model davranışını etkileyen yapıyı koruyun ve hassas içerik kalmadığını doğrulayın. Ham günlük dışa aktarımı değil, assertion içeren sürümlü test ürünü olarak saklayın.

Amaç üretim riskini yeni veri kümesine kopyalamadan davranışı kapsamaktır.

## Replay'in neyi kanıtlayacağını tanımlayın

Örneklemeden önce riskleri listeleyin: uzunluk, diller, araç schema, yapılandırılmış çıktı, çok modlu parçalar, streaming, güvenlik reddi, büyük bağlam ve parametreler.

Kapsam kategorileri oluşturup bilinçli seçin. Rastgele örnek nadir biçimleri kaçırabilir; yalnızca hata toplamak normal trafiği bozar.

## Toplama sırasında azaltın

Yalnız gerekli alanları dışa aktarın. Yetkilendirme başlıklarını, cookie, IP, hesap meta verisi, faturalama ve ilgisiz günlükleri test alanından önce kaldırın.

Şöyle bir allowlist kullanın:

```json
{
  "fixture_id": "fx_0042",
  "request": {
    "model_alias": "support_default",
    "messages": [],
    "tools": [],
    "temperature": 0.2
  },
  "assertions": {
    "valid_json": true,
    "required_keys": ["category", "confidence"]
  }
}
```

Yeni `fixture_id` üretin ve kullanıcı veya sağlayıcı ID'sini genel anahtar yapmayın.

## Hassas veriyi katmanlı bulun

Deterministic tarayıcılar, kurum sözlükleri ve bağlam incelemesini birleştirin. API anahtarı, token, özel anahtar, bağlantı dizesi, e-posta, telefon, hesap, iç host, kod sırrı ve düzenlenen kimlikleri arayın.

Hiçbir tarayıcı eksiksiz değildir. Birkaç geçiş yapın ve belirsiz eşleşmeleri yetkili inceleyiciye verin. Görüntü ve belge meta verisi ile pikseller de hassas olabilir.

## Davranışı koruyarak değiştirin

`<EMAIL_1>` ve `<ORDER_ID_2>` gibi tutarlı tür belirtilmiş yer tutucular kullanın. Aynı değer bir örnekte aynı şekilde değişsin, ancak geçici kontrollü süreç dışında tersine çevrilemesin.

Yaklaşık uzunluğu, Unicode sınıfını, JSON türünü, liste boyutunu, ayırıcıları ve alan ilişkilerini koruyun. Hata token uzunluğuna bağlıysa benzer boyutta güvenli sentetik metin kullanın.

Telefon gibi düşük entropili değerleri yalnızca hash etmeyin. Tersinirlik gerekmiyorsa silin veya sentetikleştirin.

## Etkin ve tehlikeli içeriği kaldırın

Örnekler prompt injection, komut, URL veya yan etkili kod içerebilir. Dış araçları varsayılan kapatın ve yazan araçları deterministic stub ile değiştirin.

Ağı yalnızca kontrollü test endpoint'lerine açın. Üretim kimlik bilgileri, imzalı URL, yıkıcı komut veya müşteri webhook'u replay etmeyin.

## Kesin yanıt yerine assertion ekleyin

LLM çıktısı değişebilir. schema geçerliliği, gerekli alanlar, araç seçimi, ret kategorisi, dil, en yüksek gecikme, token sınırı ve anlamsal değerlendirme saklayın. Kesin eşleşmeyi yalnızca deterministic dönüşümlerde kullanın.

Her çalışmada kaynak ve hedef model, adaptör sürümü, şablon ve tarihi kaydedin.

## Temizlenmiş ürünü doğrulayın

Onaydan önce sır ve PII taraması, dosya türü incelemesi ve elle örnek kontrolü yapın. Her kategorinin kaldığını doğrulayın. Güvenli ama davranışı artık tetiklemeyen örneği sentetik eşdeğerle değiştirin.

Kümeyi genel belge değil test verisi olarak koruyun. Erişim, saklama, denetim ve silme uygulayın. Geçici özgün eşlemeyi ayırın ve politika izin verirse doğrulamadan sonra yok edin.

## Geçiş kapısı olarak kullanın

Aynı örnekleri kaynak ve hedef adaptörlerden geçirin. Normalleştirilmiş çıktı, hata, gecikme, kullanım ve maliyeti karşılaştırın. Farkları kategoriyle inceleyip yeni uyumsuzluklar için regresyon örneği ekleyin.

Veri kümesi ve temizleme kurallarını birlikte sürümleyin.

## Özet

Güvenli replay kümesi üretim günlüklerinin kopyası değil, tasarlanmış en küçük test corpus'udur. Katmanlı algılama, yapıyı koruyan sentetik veri, yan etki yalıtımı ve davranış assertion'ları kullanın. Geçiş kapısı yapmadan önce yeniden tarayın.

## FAQ

### Neden üretim günlüklerinin rastgele dışa aktarımını replay etmemeliyim?

Ham günlükler sırları ve kişisel verileri açabilir, rastgele örnek ise nadir istek biçimlerini kaçırabilir. Açık risk kategorilerine göre en küçük kümeyi oluşturun.

### Hassas değerler nasıl değiştirilmelidir?

İlgili uzunluk, tür, ayırıcı, Unicode sınıfı ve ilişkileri koruyan ama tersine çevrilemeyen tutarlı tür belirtilmiş yer tutucular veya sentetik veriler kullanın.

### Hash işlemi kullanıcı verisini anonimleştirmeye yeter mi?

Telefon gibi tahmin edilebilir düşük entropili değerlerde yetmez. Tersinirlik gerekmiyorsa silin veya sentetikleştirin.

### Araç çağrıları güvenle nasıl replay edilir?

Dış araçları varsayılan kapatın ve deterministic stub ile değiştirin. Üretim kimlik bilgilerini, müşteri webhook'larını veya gerçek yazma etkilerini kullanmayın.

### Beklenen çıktı tam olarak eşleşmeli mi?

Genellikle hayır. schema, gerekli alanlar, araç seçimi, ret, dil, gecikme, kullanım ve değerlendirme için assertion kullanın; tam eşleşmeyi deterministic işlerle sınırlayın.

### Son replay kümesi nasıl onaylanır?

Sır ve PII taraması yapın, dosyaları inceleyin, bir örneği elle gözden geçirin, kapsamı doğrulayın ve erişim, saklama ve silme kuralları uygulayın.
