Pack Wizard ve Sinyal Agent'ını Dashboard'dan Değil, Claude'dan Çalıştırmak

HuMetric dashboard'unun arkasındaki iki ajan — Pack Wizard ve Sinyal Agent — şimdiye kadar hep tarayıcıda yaşadı. Packs sekmesini açar, "New pack"e tıklar, birkaç soruyu cevaplarsınız; bir ajan araştırıp sizin için bir Metrik Paketi taslağı çıkarır. İyi çalışıyor, ama fikir aklınıza geldiğinde dashboard'da oturuyor olmanızı varsayıyor. Gününüzün büyük kısmını zaten Claude Code, Cursor ya da başka bir MCP-bağlantılı araçta geçiriyorsanız, bu gereksiz bir bağlam değişimi.

Bunu kaldırdık. Yeni bir uzak MCP sunucusu, her iki ajanı da çalıştığınız yerden tek bir tool çağrısı uzağa getiriyor.

Bu, diğer HuMetric MCP sunucusu değil

HuMetric zaten yerel bir MCP sunucusu sunuyor (mcp_server.py, bu dokümanlarda anlatılıyor) — bir LLM'e ham entity ve sinyalleriniz üzerinde üç okuma/yazma aracı veriyor: sorgula, oku, kaydet. Sadece bir metriğe bakabilen ya da bir sinyal kaydedebilen bir asistan istiyorsanız o daha basit — lokalde çalıştırdığınız, motor API anahtarınıza karşı çalışan tek bir Python dosyası.

Bu, farklı, ikinci bir sunucu. Entity ya da sinyallere doğrudan dokunmuyor — ajanların kendisini açıyor: bir açıklamadan Metrik Paketi tasarlayan ajan, ve yapıştırılan metni bir sinyal-yükleme planına çevirip çalıştıran ajan. Yerel sunucu ince bir okuma/yazma vekiliyken, bu sunucu agentic — araştırıyor, gerektiğinde netleştirici sorular soruyor ve elinize bitmiş bir sonuç veriyor.

BYOK: ajanı sizin anahtarınız çalıştırır, bizimki değil

Bu iki ajandan hiçbiri HuMetric'in işlettiği bir modelde çalışmıyor. Dashboard'un BYOK panelinde bağladığınız hangi LLM sağlayıcısıysa — Anthropic, OpenAI, DeepSeek ya da Google — asıl akıl yürütmeyi o yapıyor, kendi sağlayıcınızın fiyatından, doğrudan onlar tarafından size faturalanarak.

Sinyal Agent'ın buna ek olarak oturumlar arası kalıcı bir hafızası var; bu hafıza bizim kendi tarafımızda tutuluyor — ek bir anahtar ya da üçüncü taraf servis gerektirmeden her hesapta çalışıyor. Ajan, kalıcı olmaya değer şeyleri remember_context ile yazıyor: entity id isimlendirme kuralınız, tekrar eden bir kaynak tuhaflığı, doldurulamayan bir alanı nasıl ele almasını istediğiniz. Bir sonraki oturum bunları ilk turdan önce okuyor, yeniden anlatmanıza gerek kalmıyor.

Bu yüzden MCP sunucusunun BYOK sağlayıcı anahtarlarınızdan ayrı, kendi bir anahtarı var: dashboard'un yeni MCP panelinden üretilen bir hms_live_... token'ı — bu sunucuya sizi tanıtıyor, herhangi bir LLM'i değil.

Fiyatlandırma: sabit, ölçülü değil

BYOK sayesinde gerçek LLM maliyeti zaten kendi sağlayıcı faturanızdan çıktığı için, bu sunucunun ücretinin token'larla hiçbir ilgisi yok. Ayrı bir MCP kredi bakiyesinden düşülen, sabit, işlem başına bir platform ücreti:

Bir oturuma göz atmak hiçbir şeye mal olmuyor — sadece ajanı gerçekten çalıştıran turlar ücretlendiriliyor.

Bağlamak

1. Bir BYOK anahtarı ekleyin. Dashboard → sağlayıcı anahtarları. Yoksa her tool çağrısı anında llm_key_required ile başarısız olur — bu başarısızlık için hiçbir ücret alınmaz.

2. Bir MCP anahtarı üretin. Dashboard'un yeni MCP panelinden, "Yeni anahtar." Token bir kere gösterilir.

3. İstemcinize ekleyin. Claude Code için:

   claude mcp add --transport http humetric-site https://gethumetric.com/mcp \
     --header "Authorization: Bearer hms_live_your_key_here"
   

   Cursor ve uzak HTTP MCP sunucularını destekleyen diğer istemciler aynı URL'i ve aynı Authorization: Bearer header'ını kullanır — tam yapılandırma örnekleri için bağlantı rehberine bakın.

Terminali hiç bırakmadan bir pack tasarlamak

Bağlandıktan sonra humetric_pack_wizard_start, dashboard formunun aldığı aynı girdileri alır — serbest metin, isteğe bağlı bir DB şeması, örnek data — ve hemen bir session_id döner; ajan çağrı döndükten sonra da çalışmaya devam eder.

humetric_pack_wizard_start(text: "Çağrı merkezi temsilcisi kalitesini
  transkriptlerden puanla: nezaket, çözüm hızı, sorunun gerçekten
  çözülüp çözülmediği.")
→ { session_id: "..." }

humetric_pack_wizard_status(session_id: "...")
→ { status: "awaiting_input", pending_question: { question: "..." } }

humetric_pack_wizard_answer(session_id: "...", answer: "...")
→ { status: "completed", result: { pack_yaml: "entity_type: call...\n..." } }

Buradan sonra, motorun kendi MCP aracı bunu doğrudan yayınlar — humetric_create_pack(pack_yaml) — iki sohbet penceresi arasında kopyala- yapıştır yok.

Yapıştırılan metni gerçek metriklere çevirmek

humetric_signal_chat_start, dashboard'un "Canlı deneyin" panelinin arkasındaki aynı ajan — ama onu hiç açmadan, var olan bir pack'e karşı çağrılabiliyor. Bir yığın yorum, transkript ya da destek talebi metnini bir pack_key'e karşı yapıştırın; ajan bir yükleme planı taslağı çıkarır: hangi entity, hangi metin parçaları hangi sinyale dönüşüyor, dolduramadığı bir alanda ne yapılacak.

humetric_signal_chat_start(pack_key: "call-center-quality", text: "<yapıştırılan
  transkriptler>")
→ { session_id: "..." }

humetric_signal_chat_status(session_id: "...")
→ { status: "awaiting_input", result: { plan: { entity: {...}, signals: [...] } } }

Plandan memnun değil misiniz? humetric_signal_chat_answer geri bildirim gönderir, ajan yeniden taslak çıkarır. Doğru göründüğünde humetric_signal_chat_run_plan onu gerçekten uygular — entity'yi yazar, her sinyali gönderir, çıkarımı bekler ve motorun hesapladığı gerçek metrik değerlerini döner. Canlı veriye dokunan tek adım bu — öncesindeki her şey sadece planlama.

Dashboard'dan zaten tanıdığınız iki ajan, artık gerçekten kod yazdığınız yerden erişilebilir.