Ollama ve Qdrant ile C# tarafında yerel RAG'den AI Agent'a – Bölüm 3
Serinin üçüncü bölümü, yerel C# agent'ını serbest tool çağrısından Microsoft Agent Framework'teki deterministik Agent Workflows'a taşıyor. Workflow; deployment durumunu, hataları ve Qdrant dokümanlarını sabit bir sırada topluyor, sonra kanıtı analiz için tool'u olmayan bir agent'a veriyor ve hassas işlemler öncesinde insan onayı istiyor.
Kilit noktalar
- Adımların sırası garanti edilmeli ise modelin tool seçimini sabit bir C# akışıyla değiştirin.
- Akış WorkflowBuilder, Executor, AddEdge ve WithOutputFrom ile tanımlanıyor; Build() çalıştırılabilir workflow'u üretiyor.
- CollectDiagnosticsExecutor deployment durumu, son hatalar ve Qdrant doküman aramasını zincirliyor; üçü de her zaman çalışıyor.
- Analiz adımı, tool'u olmayan bir AIAgent ve gözlemlenenleri varsayımlardan ayıran bir prompt kullanıyor.
- RequestPort, deployment restart gibi hassas işlemler öncesinde insan onayı kapısı sağlıyor.
- InProcessExecution.RunAsync ile yerelde çalıştırın, ExecutorCompletedEvent'i okuyun ve konsoldan /diagnose ile tetikleyin.
Serinin son bölümünde Ottorino Bruni, Ollama ve Qdrant üzerinde çalışan yerel C# agent'ına iki Microsoft Agent Framework özelliği ekliyor. İlki Agent Workflows: llama3.2'nin doğru tool'ları doğru sırada seçmesine güvenmek yerine, uygulama akışı kodda WorkflowBuilder, Executor sınıfları ve bunları birbirine bağlayan edge'ler ile tanımlıyor.
CollectDiagnosticsExecutor deployment, log ve doküman servislerini sırayla çağırıyor; AnalyzeDiagnosticsExecutor ise toplanan kanıtı tool kullanmayan bir agent'a verip raporu yazdırıyor. Restart gibi hassas işlemlerden önce insan onayı istemek için RequestPort adımı kullanılıyor; yani AI öneriyor, uygulama kontrolü elinde tutuyor. Kod, .NET 10 üzerinde Microsoft.Agents.AI.Workflows 1.23.0 ile çalışıyor ve konsoldan /diagnose komutuyla in-process tetikleniyor.
Gerçek dünyada kullanımı
- Log, deployment durumu ve dokümanların insan tanıyı görmeden önce mutlaka kontrol edilmesi gereken bir olay inceleme aracı.
- Restart önerisini hazırlayan ancak hiçbir şeyi çalıştırmadan önce operatör onayı bekleyen bir iç operasyon asistanı.
- Qdrant bilgi tabanı üzerinde çalışan ve kanıt toplaması modelin tool seçimine bırakılmak yerine tekrarlanabilir olması gereken bir destek botu.
Neden önemli
Agent'ınız yalnızca cevap vermiyor, aksiyon da alıyorsa adımları modelin seçmesine izin vermek güvenilirlik ve güvenlik riskidir; workflow edge'leri ve onay adımı kontrolü uygulamaya geri verir.