Taşınma Kılavuzları

SmartRAG sürümleri arasında yükseltme için adım adım taşınma kılavuzları.

v2.x’ten v3.0.0’a Taşınma

Temel Değişiklikler

Birincil değişiklik, GenerateRagAnswerAsync'in QueryIntelligenceAsync olarak yeniden adlandırılmasıdır.

Bu taşınma kılavuzu, SmartRAG v2.x'ten v3.0.0'a yükseltme sırasında gerekli değişiklikleri kapsar.

Adım 1: Metod Çağrısını Güncelleyin

Service metod çağrınızı GenerateRagAnswerAsync'den QueryIntelligenceAsync'e güncelleyin:

// Önce (v2.x)
var response = await _searchService.GenerateRagAnswerAsync(query, maxResults);

// Sonra (v3.0.0)
var response = await _searchService.QueryIntelligenceAsync(query, maxResults);

Adım 2: API Endpoint’lerini Güncelleyin (Web API kullanıyorsanız)

Web API controller'ınız varsa, sadece service method çağrısını güncelleyin:

// Önce (v2.x)
[HttpPost("generate-answer")]
public async Task<IActionResult> GenerateAnswer([FromBody] QueryRequest request)
{
    var response = await _searchService.GenerateRagAnswerAsync(request.Query);
    return Ok(response);
}

// Sonra (v3.0.0) - Sadece method adı değişti
[HttpPost("generate-answer")]
public async Task<IActionResult> GenerateAnswer([FromBody] QueryRequest request)
{
    var response = await _searchService.QueryIntelligenceAsync(request.Query);
    return Ok(response);
}

Not

Mevcut endpoint yollarınızı ve controller method adlarınızı koruyabilirsiniz. Sadece service method çağrısını güncellemeniz yeterlidir.

Adım 3: İstemci Kodunu Güncelleyin (uygunsa)

API'yi çağıran istemci kodunuz varsa, endpoint'i güncelleyin:

// Önce
const response = await fetch('/api/intelligence/generate-answer', { ... });

// Sonra
const response = await fetch('/api/intelligence/query', { ... });

Acil Eylem Gerekmez

Eski GenerateRagAnswerAsync metodu hala çalışıyor (kullanımdan kaldırıldı olarak işaretli). v4.0.0 yayınlanmadan önce kademeli olarak taşınabilirsiniz.

v1.x’ten v2.0.0’a Taşınma

Framework Değişikliği

Sürüm 2.0.0, .NET 9.0'dan .NET Standard 2.1'e taşınmıştır

Bu taşınma kılavuzu, SmartRAG v1.x'ten v2.0.0'a yükseltme sırasında framework uyumluluk değişikliklerini kapsar.

Adım 1: Framework Uyumluluğunu Doğrulayın

Projeniz şu framework'lerden birini hedeflemelidir:

<TargetFramework>netstandard2.0</TargetFramework>
<TargetFramework>netstandard2.1</TargetFramework>
<TargetFramework>netcoreapp2.0</TargetFramework>
<TargetFramework>net461</TargetFramework>
<TargetFramework>net5.0</TargetFramework>
<TargetFramework>net6.0</TargetFramework>
<TargetFramework>net7.0</TargetFramework>
<TargetFramework>net8.0</TargetFramework>
<TargetFramework>net9.0</TargetFramework>

Adım 2: NuGet Paketini Güncelleyin

SmartRAG paketini 2.0.0 sürümüne güncelleyin:

dotnet add package SmartRAG --version 2.0.0

Adım 3: Kod Uyumluluğunu Doğrulayın

API değişikliği yok - tüm işlevsellik aynı kalır. Sadece projenizin uyumlu framework'ü hedeflediğinden emin olun.

Sonraki Adımlar

Sürüm Geçmişi

Tüm sürümler ve değişikliklerle birlikte tam sürüm geçmişi

Sürüm Geçmişi

Kullanımdan Kaldırma Bildirimleri

Kullanımdan kaldırılan özellikler ve planlanan kaldırmalar

Kullanımdan Kaldırma Bildirimleri