YouMind
Oturum aç

LLM uygulamaları için izleme (tracing) rehberi

@lotte_verheyden
İNGILIZCE15 May 2026
319K
42
5
2
110

TL;DR

Bu rehber, izlemenin yapay zeka mühendisliği döngüsü için nasıl bir temel oluşturduğunu açıklamakta; gözlem yapısını, hiyerarşik izleri ve izler ile oturumlar arasındaki farkı detaylandırmaktadır.

Bu, Langfuse Academy'nin bir parçası olarak yayınladığımız bir serinin bir bölümüdür. Seride AI mühendisliği yaşam döngüsünün tamamını ele alıyoruz. Seriye yeni başlıyorsanız, başlamak için en iyi yer AI Mühendislik Döngüsü sayfasıdır.

AI Mühendislik Döngüsü'nün Kısa Bir Özeti

AI Mühendislik Döngüsü, ekiplerin AI sistemlerini sürekli olarak iyileştirme yöntemidir. Üretimde olup bitenleri (izleme, gözlemleme) geliştirme sırasındaki yapılandırılmış yinelemelere (veri kümeleri, deneyler, değerlendirme) bağlar. Gönderilen her iyileştirme yeni veri üretir ve ekipler bu süreçte sürekli olarak döngü yapar.

Lotte - inline image

Bu konuda daha fazla bilgiyi burada okuyabilirsiniz.

İzleme döngüye nasıl uyuyor

Geleneksel yazılım büyük ölçüde deterministiktir, yürütmeler önceden tanımlanmış bir formatı izler. LLM uygulamaları için durum böyle değildir. Ajan yürütmeleri karmaşık olabilir; zengin ve beklenmedik girdi ve çıktılar ile yürütme sırası gibi ortaya çıkan davranışlarla uğraşırız. Ajanınızın davranışını takip etmek için başka bir şeye ihtiyacınız vardır: izler.

İzleme, tüm iyileştirme döngüsünün merkezinde yer alır. Diğer her adım (inceleme, veri kümeleri oluşturma, deneyler çalıştırma, değerlendirme) izler üzerinde çalışır.

Geleneksel gözlemlenebilirlik kavramlarına zaten aşina iseniz, aşağıdakilerin bir kısmı size tekrara gelebilir. İsterseniz göz atabilir veya atlayabilirsiniz.

Bir izin anatomisi

Bir iz, uygulamanızın gerektirdiği kadar karmaşık veya basit olabilir, ancak tüm izler aynı temel yapıyı paylaşır. Ajanınızın izlediği yolu haritalayan bir dizi gözlemden oluşur.

Bir gözlem, süreçteki tek bir adımdır. Bir girdisi, bir çıktısı, başlangıç/bitiş zamanı ve o adım sırasında ne olduğuna dair meta verileri vardır.

Hiyerarşi

Bir iz, hiyerarşik bir ağaç yapısına sahiptir. İç içe geçmiş, başka gözlemler içerebilen gözlemler bulunur ve bu, AI uygulamanızın gerçek yürütmesini yansıtan bir üst-alt yapısı oluşturur.

Lotte - inline image

Hangi sırayla ne olduğunu ve hangi adımların hangi büyük adımın parçası olduğunu görebilirsiniz.

Gözlem verileri

Girdi ve çıktı. Her gözlemin bir girdisi ve bir çıktısı olabilir. Çoğu zaman ikisi de olur; bazı özel durumlarda sadece birine sahip olabilir. Yorumlanabilirlik için, o gözlemde gerçekleşen eylem türüne uygun bir girdi ve/veya çıktı belirlemeniz önemlidir.

Gözlem türleri. İşlemleri ayırt etmeyi kolaylaştırmak için farklı gözlem türleri görürsünüz. Her gözlem türü, bir ajanın farklı etkileşim türlerini yakalamak için kullanılır.

Lotte - inline image

Gözlem türleri, izleri okumayı ve filtrelemeyi kolaylaştırır. 20 gözlemli bir izde, LLM çağrılarını hızlıca tespit edebilmek zaman kazandırır.

Maliyet, gecikme, token kullanımı

Girdi ve çıktının ötesinde, herhangi bir LLM uygulamasında temel gereksinimler olan birkaç gözlem özelliği vardır: maliyet, gecikme ve token kullanımı. Bunlar gözlem başına kaydedilir ve iz düzeyinde toplanır.

İzler ve oturumlar

Çoğu zaman bir ajanın tüm yaşam döngüsü yürütmesini tek bir izde görmezsiniz. İzler oturumlar halinde gruplanabilir. Peki iz ile oturum arasındaki çizgiyi nerede çekersiniz?

Lotte - inline image

Genel bir kural olarak: bir iz, sisteminizin bir çağrısına, tipik olarak bir API çağrısına veya bir ajan yürütmesine karşılık gelir. Bir oturum ise birden fazla izi bir araya getirir; örneğin çok turlu bir konuşmadaki tüm turlar gibi.

Nereden başlamalı

Yeni başlıyorsanız, mümkün olan her yolu kapsamaya çalışmadan önce gerçek bir iş akışını uçtan uca izlemeye odaklanın.

  1. Uygulamanızdaki önemli bir istek yolu için izleme kurulumu yapın.
  2. Her gözlemin, temsil ettiği adım için yararlı girdi, çıktı ve meta veri yakaladığından emin olun.
  3. Bir avuç gerçek izi manuel olarak inceleyerek yapının takip edilmesinin kolay ve hata ayıklama için yararlı olduğunu doğrulayın.

Sırada ne var

İzleri gördükten sonra bir sonraki adıma geçebilirsiniz: izleme. İzleme, izleri ajanınızı iyileştirme ve yineleme döngüsüne bağlayan şeydir.

Tek tıkla kaydet

YouMind ile viral makaleleri AI derin okumayla incele

Kaynağı kaydedin, odaklı sorular sorun, argümanı özetleyin ve viral bir makaleyi tek bir AI çalışma alanında yeniden kullanılabilir notlara dönüştürün.

YouMind'ı keşfet
Üreticiler için

Markdown'ınızı temiz bir 𝕏 makalesine dönüştürün

Kendi uzun yazılarınızı yayımlarken görselleri, tabloları ve kod bloklarını 𝕏 için biçimlendirmek zahmetlidir. YouMind, eksiksiz bir Markdown taslağını temiz ve hemen paylaşılabilir bir 𝕏 makalesine dönüştürür.

Markdown'dan 𝕏'e deneyin

Çözülecek daha fazla kalıp

Son viral makaleler

Daha fazla viral makale keşfet