Ajan yapılandırması

Ajanı kullanım senaryonuza göre uyarlamak için kullanabileceğiniz farklı araçlar vardır.

Daha fazla ayrıntı için bir ajanın nasıl oluşturulacağını anlatan ayrıntılı ajan oluşturma rehberimizi okuyabilirsiniz.

Aşağıdaki seçenekleri elle ayarlamak yerine ajanınızı Agent Builder sohbetinde anlatabilir ve bunların sizin için yapılandırılmasını sağlayabilirsiniz. Her iki yaklaşım da aynı yapılandırma üzerinde çalışır; bu yüzden istediğiniz zaman aralarında geçiş yapabilirsiniz.

Ajanınızı özelleştirmek için aşağıdaki yapılandırma seçeneklerine sahipsiniz:

İkon, ad ve açıklama

Ajanı tanımlamak ve diğer kullanıcılara nasıl çalıştığını anlatmak için kısa açıklayıcı bilgiler. Workspace yöneticileri ayrıca bireysel oluşturucu yerine gösterilen bir oluşturucu görünen adı ayarlayabilir; örneğin bir ekip adı.

Girdi türü

Ajanlar, bilgiyi nasıl aldıklarını ve işlediklerini belirleyen farklı girdi türlerini destekler.

Prompt (varsayılan)

Normal sohbetten bildiğiniz sohbet girdi alanı. Bu, ajana herhangi bir mesaj göndermenize ve yanıt almanıza olanak tanır.

Kullanıcıların ilk mesajı yazmak yerine tıklayabileceği kayıtlı prompt'lar olan sohbet başlangıçları ayarlayabilirsiniz. Bunlar kullanıcıları yönlendirmeye ve başlamak için gereken çabayı azaltmaya yardımcı olur.

Form

Formlar, bir anket aracına benzer şekilde bilgileri yapılandırılmış biçimde toplar. Bu, kaliteli bir yanıt için ne kadar bağlamın gerekli olduğunu anlamaları için kullanıcıları yönlendirmeye yardımcı olur ve modeli daha kolay işleyebileceği standart bir biçimde toplar.

Talimatlar

Bu ajanla neyi başarmak istediğinizi anlatın ve net talimatlar tanımlayın. Mümkün olduğunca çok ilgili ayrıntı ve arka plan bilgisi ekleyin. Bu, ajanın daha iyi ve beklentilerinize daha yakın yanıt vermesini sağlar. Daha fazla ayrıntı için ajan oluşturma rehberimize ve prompting rehberimize bakın.

Bilgi

Dosyalar satırından bilgisayarınızdan veya entegrasyonlardan ajanınıza dosya ekleyin. SharePoint, Google Drive, OneDrive veya Confluence Cloud'dan klasörleri senkronize etmek için Folder Sync de kullanabilirsiniz. Klasörler satırında Klasör ekle'yi seçerek Bilgi tabanları, Library Klasörleri ve senkronize klasörler ekleyin. Bir ajan en fazla 50 dosya, 5 Library Klasörü ve 5 senkronize klasör ekleyebilir.

Library Klasörleri, birini çalışma klasörü olarak işaretleyene kadar salt okunur kalır. Kurulum için Klasörler sayfasına bakın.

Kaynak erişim kısıtlaması

Varsayılan olarak ajanınız yanıtlarında kaynaklara atıfta bulunduğunda kullanıcılar bu referanslara tıklayıp orijinal belgeleri açabilir ve görüntüleyebilir. Ajanın bunlara atıfta bulunmasına izin verirken hassas kaynak içeriğini korumanız gerekiyorsa kaynak erişim kısıtlamasını etkinleştirebilirsiniz.

Etkinleştirildiğinde kullanıcılar yanıtlarda kaynak referanslarını görür ancak onları açmak için tıklayamaz. Bu şu durumlarda yararlıdır:

• Ajanın doğru yanıtlar vermek için gizli belgelere erişmesi gerektiğinde
• Kullanıcıların temel dosyalara doğrudan erişmeden kaynaklardan bilgi alması gerektiğinde
• Bilgiden yararlanırken belge dağıtımını kontrol etmek istediğinizde

Bu ayarın ajan yapılandırmasında kullanılabilir olması için önce bir yönetici tarafından Workspace düzeyinde etkinleştirilmesi gerekir. Bu seçeneği görmüyorsanız Workspace yöneticinizle iletişime geçin.

Entegrasyonlar

Ajanınızı harici araçlara ve hizmetlere bağlayın. Entegrasyonlar satırında Entegrasyon ekle'ye tıklayın. Ajanınız ardından şunlar gibi eylemler gerçekleştirebilir:

• E-posta taslakları oluşturma
• CRM kayıtlarını güncelleme
• Destek ticket'ları oluşturma
• Slack'e mesaj gönderme

Tam liste için entegrasyon rehberlerimize bakın.

Skill'ler

Skill'ler satırında Skill ekle ile Skill'ler ekleyin. Ekli Skill'ler her sohbette ajanı yönlendirir. Satır, Workspace için Skill'ler etkinleştirildiğinde görünür.

Alt ajanlar

Alt ajanlar satırında Alt ajan ekle ile diğer ajanları ekleyin. Ajanınız belirli alt görevleri işlemek için uzmanlaşmış ajanları çağırabilir.

İş akışları

Ajanınızın sohbet sırasında çok adımlı otomasyonları tetikleyebilmesi için İş akışları satırında İş akışı ekle ile iş akışları ekleyin. Ayrıntılar için ajanlar üzerinden iş akışları kullanma.

Dosya şablonları

Ajanınızın belgeleri ve sunumları tutarlı bir biçim ve stilde üretmesi için Dosya şablonları satırında Şablon ekle ile dosya şablonları ekleyin.

Gelişmiş

Ajanın web'de arama yapabilmesi için Gelişmiş altında Web erişimi'ni açın. Görsel üretimi Workspace varsayılanını izler. Workspace ayarlarında etkinleştirildiğinde ajanlar dosya oluşturabilir, dosya içeriğini düzenleyebilir ve tablo verilerini analiz edebilir.

Deep Research yalnızca normal sohbetlerde kullanılabilir; ajanlarla kullanılırken değil. Deep Research kullanmak için normal bir sohbet oturumuna geçin.

Model

Bu ajanın hangi modeli kullanacağını seçin. Doğru modeli seçme hakkında ayrıntılar için model rehberimize bakın.

Yaratıcılık

Yanıtların ne kadar deterministik veya yaratıcı olduğunu etkileyen modelin temperature parametresini kontrol eder. Kaydırıcı 0 (deterministik) ile 1 (yaratıcı) arasında değişir:

• Düşük değerler (0–0,3): Daha odaklı, tutarlı ve öngörülebilir yanıtlar. Olgusal görevler, kodlama veya güvenilir çıktılar gerektiğinde en iyisidir.
• Orta değerler (0,4–0,7): Dengeli yaratıcılık ve tutarlılık. Genel kullanım senaryoları için iyidir. Yeni ajanlar 0,7'de başlar ve ilk bilgi kaynağı veya aracı eklediğinizde 0,3'e değişir.
• Yüksek değerler (0,8–1,0): Daha çeşitli ve yaratıcı yanıtlar. Beyin fırtınası, yaratıcı yazım veya çeşitli çıktılar istediğinizde daha iyidir.

Limitlere ulaşıldığında

Bir kullanıcı, Workspace veya ajan limitine ulaşıldığında ne olacağını seçin. Kullanıcı limiti için, yedek modelden önce kullanılabilir Ek Kullanım kullanılır. BYOK ve Dedicated Deployments'ta Workspace limitleri dahil kullanıma göre önceliklidir. Model değiştir (varsayılan) ajanın yedek modelle yanıt vermesine izin verir; Kullanımı engelle limit sıfırlanana kadar ajanı kullanılamaz hale getirir.

Zamanlama

Kayıtlı, şablon olmayan bir Ajan için, Ajan önceden seçili bir zamanlanmış görev oluşturmak üzere üst çubukta Zamanla'ya tıklayın. Düğme, Zamanlanmış etkinleştirildiğinde ve Ajanın henüz bir zamanlanmış görevi olmadığında görünür. 10 zamanlanmış görev limitinize ulaştığınızda devre dışı kalır.

Paylaşım

Sağ üst köşede ajanı paylaşmak ve kullanmak için seçenekler bulursunuz. Workspace'teki herkesle paylaşabilir veya belirli gruplara ya da kişilere düzenleme ve kullanım izinleri atayabilirsiniz. Ajanı kullan, ajan aktif olduktan sonra ve taslak değişikliğiniz yokken görünür. Paylaş ilgili Workspace iznini gerektirir. Ajana alt ajanlar ekliyse ajan, paylaştığınız kişilerin bu alt ajanlara da erişip erişemediğini kontrol eder ve eksik erişimi vermeyi teklif eder.

Yayınlama

Bir ajanın yapılandırmasındaki değişiklikler bir taslak olarak kaydedilir ve siz yayınlayana kadar kullanıcıları etkilemez. İlk aktif sürümü oluşturmak için üst çubukta Oluştur'u seçin. Bundan sonra sonraki bir taslağı aktif sürüm yapmak için Güncelle'yi seçin.

Ajan oluşturma ve güncelleme uç noktaları taslak üzerinde çalışır. Yayınlama uç noktası o taslağı aktif hale getirir. Ajan getirme ve sohbet tamamlama uç noktaları aktif sürümü kullanır; henüz sürüm yayınlanmamışsa taslağı kullanır.

Yeni bir sürüm yayınlarken neyin değiştiğini anlatan isteğe bağlı bir güncelleme mesajı ekleyebilirsiniz. Kullanıcılar ardından ajanla yeni bir sohbet başlattıklarında Yeni sürüm bildirimi görür. Bildirim yayınlamadan 7 gün sonra veya bir kullanıcı sürümden bu yana ajanla 3 sohbet başlattığında daha erken kaybolur. Kendiniz yayınladığınız sürümler için bildirimi görmezsiniz ve ilk yayınlanan sürüm asla bildirim göstermez.

Analitikler

Ajan performansını ve kullanıcı geri bildirimini incelemek için Analitikler ve Geri bildirim sekmelerini kullanın. Tam Analitikler ve Geri bildirim başvurusu için Ajan analitikleri sayfasına bakın.

İzleme ve günlükleme

Ajanınızın davranışı ve performansı hakkında daha derin içgörüler için Langfuse üzerinden izlemeyi etkinleştirebilirsiniz.

Nasıl çalışır:

1. Workspace yöneticileri önce Workspace ayarlarında ajan günlüklemeyi etkinleştirir. Bu, özelliği Workspace'inizdeki ajanlar için kullanılabilir hale getirir.
2. Ajan editörleri ardından bireysel ajanlar için günlüklemeyi yapılandırabilir:
   • Ajan yapılandırmasında Ajan günlüklerine izin ver geçişini etkinleştirin
   • İzleme bulut URL'sini ayarlayın (varsayılan: https://cloud.langfuse.com)

Yapılandırıldıktan sonra ajanınızın etkileşimleri hakkında ayrıntılı günlükler Langfuse'a gönderilir ve şunlara görünürlük sağlar:

• Bireysel sohbet izleri
• Model girdi ve çıktıları
• Performans metrikleri ve gecikme
• Etkileşim başına token kullanımı

Ajan günlükleme, kullanılmadan önce Workspace yöneticisi onayı gerektirir. Günlükleme seçeneklerini görmüyorsanız Workspace ayarlarında ajan günlüklerini etkinleştirmek için Workspace yöneticinizle iletişime geçin.

Langfuse hem bulut sürümü hem de self-hosted seçenekler sunar. Kuruluşunuz self-hosted bir Langfuse örneği kullanıyorsa İzleme bulut URL'sini dahili dağıtımınıza işaret edecek şekilde güncelleyin.

Etiketler, sabitleme, çoğaltma ve sahip aktarımı gibi ek ajan yönetimi özellikleri için Gelişmiş özellikler sayfasına bakın.

SSS

Bir ajanın bağlamı kullanıcının mesajını, önceki sohbeti, ajan talimatlarını, ekli dosyaları, alınan bilgiyi, kullanılabilir araçları, araç sonuçlarını ve sistem talimatlarını içerebilir. Karmaşık ajanlar bu nedenle basit bir sohbetten daha hızlı bağlam doldurabilir.

Ajanın belirli işi için ihtiyaç duyduğu bilgi ve araçları yalnızca ekleyin. Birçok kaynağa ve araca sahip geniş ajanların kontrolü daha zordur ve ilgisiz bilgi alabilir. Karmaşık işler için sorumlulukları odaklı ajanlara veya alt ajanlara bölün.

Bir ajan, prompt ihtiyacı netleştirmiyorsa, izinler eksikse, retrieval ilgili içerik bulmuyorsa veya başka bir talimat daha yüksek önceliğe sahipse bir aracı veya kaynağı atlayabilir. Beklenen iş akışını ajan talimatlarında açık hale getirin ve temsilî örneklerle test edin.

Ekli bilgi, ajana sohbet sırasında almak üzere yeniden kullanılabilir bilgi verir. Ajan genellikle ilgili alıntıları alır; ekli her belgenin tamamını zorunlu olarak almaz. Yanıtın kalitesi retrieval'a, izinlere, talimatlara ve kullanıcının sorusuna bağlıdır.

Aynı belgeler tekrarlayan sohbetleri veya birçok kullanıcıyı desteklemeliyse ajana özgü bir Bilgi tabanı kullanın. Bilgi geçiciyse, mevcut görev için yeterince küçükse veya yalnızca bir sohbette gerekiyorsa doğrudan dosyalar kullanın.

Bir ajanın talimatları doğrudan sohbette yanıt vermeyi gerektiriyorsa veya dosya oluşturmayı yasaklıyorsa Document Editor otomatik açılmaz. Workspace dosya araçları kullanılabilirse ajanın bir belge oluşturmasını isteyin. Normal ajan sohbetleri Araçlar menüsünü veya Belge oluştur denetimini göstermez.