İşlere dön
Mühendislik · Ajanik Sistemler

Ajanik Yetenekler

Çoğu ajanik demo bir kez çalışır. Bunları üretimde — gerçek kullanıcılar, uç durumlar ve araç hataları boyunca — güvenilir kılmak bir mühendislik disiplinidir. LMXAI ajanik sistemleri böyle tasarlar; işlettikleri gerçek araç ekosistemi de budur.

Orkestrasyon
LangGraph · LangChain
Araç protokolü
MCP entegrasyonu
Araç güvenilirliği
LoRA ince ayar · BFCL-v3
Dağıtıldığı yer
Savion · mdGPT

Yaklaşım

LMXAI ajanik sistemleri LangGraph ve LangChain üzerinde kurar; dış yetenekler Model Context Protocol (MCP) üzerinden entegre edilir. Ancak orkestrasyon sorunun yalnızca yarısıdır — daha zor olan yarı, alttaki modeli bu araçları çağırmada güvenilir kılmaktır.

Bu güvenilirlik varsayılmaz, mühendislikle üretilir. Temel model araç kullanımı için ince ayarlanır (LoRA / QLoRA) ve bir ajan döngüsüne girmeden önce evalscope ile BFCL-v3, HumanEval ve GSM8K üzerinde doğrulanır — mdAgent-Hermes-32B’yi dahili BFCL-v3 tek tur eval’inde %82,3’e taşıyan aynı süreç. Üretim sertleştirmesi ardından yapılandırılmış yeniden denemeler, insan-döngüde kontrol noktaları ve OpenTelemetry ve Phoenix ile uçtan uca izleme ekler.

Karşı tasarladığımız hata kipleri

  • Araç kullanımı halüsinasyonu — model gerçek bir aracı yanlış veya uydurulmuş argümanlarla çağırır.
  • Kurtarılamaz durum — başarısız bir adımın yeniden deneme mantığı veya yedek yolu yoktur.
  • Sessiz hatalar — ajan, hatayı kullanıcıya veya ize yansıtmadan devam eder.
  • Kontrolsüz döngüler — sonlandırma koşulu yok, adım veya token bütçesi yok.

Tasarım kalıpları

LMXAI’nin üretim ajanik sistemlerinde tutarlı uygulanan altı kalıp.

Kalıp 01

Graf tabanlı orkestrasyon

Ajanlar serbest döngüler yerine LangGraph’ta yönlü graflar olarak modellenir. Her durum geçişi açıktır, koşulludur ve her adımda incelenebilir.

Neden: Bir graf izini hata ayıklamak bir diff’tir; serbest bir döngüyü hata ayıklamak arkeolojidir.
Kalıp 02

İnce ayar ile araç güvenilirliği

Raftan alınan modeller üretim için işlev çağırmada yeterince güvenilir değildir. Temel model küratörlenmiş tool-use verisi üzerinde ince ayarlanır ve dağıtımdan önce BFCL-v3 ile doğrulanır.

Neden: mdAgent-Hermes-32B, dahili BFCL-v3 tek tur eval’inde tam bu süreçle %82,3’e ulaştı.
Kalıp 03

MCP araç entegrasyonu

Dış yetenekler Model Context Protocol üzerinden sunulur — modelin sabit yapıştırma kodu olmadan araçları keşfedip çağırmasını sağlayan tutarlı, şema doğrulamalı bir arayüz.

Neden: Bir araç eklemek veya değiştirmek kod değişikliği değil, şema değişikliği olur.
Kalıp 04

İnsan-döngüde kontrol noktaları

Yüksek riskli iş akışları, sonuç doğuran eylemlerden önce açık onay kapıları gösterir; LangGraph’ın interrupt/resume’u ile yürütme grafı kırılmadan insan kontrolde kalır.

Neden: Sağlık ve finansta durdurulamayan bir ajan yükümlülüktür.
Kalıp 05

Yapılandırılmış yeniden deneme ve yedek

Her araç çağırma düğümünün backoff’lu bir yeniden deneme bütçesi, çıktı şeması doğrulaması ve bozuk durumu yaymak yerine zarifçe düşen bir yedek dalı vardır.

Neden: Geçici bir API zaman aşımı, 10 adımlık bir klinik iş akışını iptal etmemelidir.
Kalıp 06

Uçtan uca gözlemlenebilirlik

Her adım OpenTelemetry ve Phoenix üzerinden yapılandırılmış bir iz üretir: hangi düğüm çalıştı, model giriş/çıkışı, hangi araç hangi argümanlarla çağrıldı ve adım gecikmesi.

Neden: Göremediğinizi iyileştiremezsiniz — ve düzenleyiciler giderek denetim izi ister.

Araç ekosistemi

Somut bir örnek: mdGPT ajanlarına MCP üzerinden açılan çalışma alanı araç seti sohbetten çok daha fazlasını kapsar — modelin belgeler, veri, bilgi sistemleri ve web üzerinde eylem almasını sağlar.

Belge işleme

  • PDF / DOCX / PPTX okuma
  • OCR hattı (PyMuPDF + RapidOCR)
  • Belge oluşturma ve düzenleme
  • DOCX / XLSX’e dışa aktarma

Tablo veri analizi

  • Şema, önizleme ve özet (Excel/CSV)
  • SQL benzeri filtreleme ve group-by
  • Değer dağılımları
  • Korelasyon analizi

Arama ve retrieval

  • Anlamsal / vektör arama
  • Bilgi tabanı sorgulama
  • Çalışma alanı genelinde grep
  • Dosya içi arama

Bilgi ve notlar

  • Notion sayfaları ve veritabanları
  • Sayfa oluşturma / ekleme
  • Not yönetimi
  • Sohbet geçmişi araması

Takvim ve görevler

  • Etkinlik arama / oluşturma
  • Etkinlik güncelleme ve silme
  • Yapılacaklar listeleri
  • Zamanlanmış otomasyonlar

Veritabanı (Snowflake)

  • Tabloları listeleme
  • Tablo şemasını inceleme
  • SQL sorguları çalıştırma
  • Yapılandırılmış sonuç işleme

Finansal hesaplayıcılar

  • ROI, KDV, indirimler
  • Kredi ve bileşik faiz
  • Yüzdeler
  • Döviz çevirimi

Web

  • URL içeriği getirme
  • Web araması
  • Kaynağa dayalı yanıtlar
  • Canlı bilgi retrieval

Dosya ve çalışma alanı yönetimi

  • Çalışma alanını gezme / listeleme
  • Taşıma, kopyalama, yeniden adlandırma
  • Dizin oluşturma
  • İndirme bağlantıları

Üretimde uygulandı

Klinik AI

Savion

Klinik plan tesliminden önce insan onayı olan LangGraph diyet planlama ajanı — klinisyen idari yükünü kesmek için tasarlandı; yayımlanmış bir verimlilik çalışması değil.

Vaka çalışması
LLM Gateway

mdGPT Gateway

Tam çalışma alanı araç seti üzerinde SSE-streaming çok adımlı ajan; her adımda kullanıcı başına izolasyon ve OTel izleme.

Vaka çalışması
Model · İnce ayar

mdAgent-Hermes-32B

Dahili BFCL-v3 tek tur eval’inde %82,3 LoRA ince ayarı — her ajanın altındaki güvenilir temel.

Vaka çalışması

Yığın

LangGraphLangChainMCPFastAPILoRA / QLoRABFCL-v3HumanEvalGSM8KevalscopeOpenTelemetryPhoenix
Tüm işler Sonraki: Savion