Knowentra logoKnowentra

Model / Ajan Oluşturma (Model Builder)

Platformdaki hazır dil modelleri her işi genel amaçlı yapar. Ama çoğu zaman ihtiyacınız olan şey, belirli bir işe göre ayarlanmış bir asistandır: kurumunuzun belgelerini bilen bir "İK Asistanı", yalnızca sözleşme dilinden konuşan bir "Hukuk Danışmanı", ya da belirli araçları kullanabilen bir "Rapor Botu".

Model Builder tam olarak bunu yapmanızı sağlar. Bir temel model seçer, ona bir kişilik (sistem promptu) verir, gerekiyorsa bilgi tabanı ve araçlar bağlar; ortaya kuruma özel bir ajan çıkar. Kod yazmaya gerek yoktur — hepsi tek bir formda.

Bu sayfa, bu formu baştan sona adım adım anlatır.

Ön koşul: Ajanınıza belge bağlayacaksanız önce bir bilgi tabanı oluşturmuş olun → Belge Yükleme ve Bilgi Tabanı.


Adım 1: Model listesini açın ve "Yeni Model"e tıklayın

Sol menüden Çalışma Alanı (Workspace) → Modeller (Models) bölümüne gidin. Üstteki "Yeni Model (New Model)" düğmesine tıklayın. Boş bir düzenleme formu açılır.

📷 Görsel: Modeller listesi ve sağ üstteki "Yeni Model" düğmesi işaretli.


Adım 2: Temel bilgiler

Formun en üstünde ajanınızın kimliğini tanımlarsınız:

  • Profil görseli — İsteğe bağlı; ajana bir avatar yükleyin. Sohbet ve listelerde görünür.
  • Model Adı (Model Name)Zorunlu. Kullanıcıların göreceği isim (ör. "İK Asistanı").
  • Model IDZorunlu. Benzersiz kimlik; oluştururken addan otomatik türetilir, genelde dokunmanıza gerek yoktur.
  • Erişim (Access) — Bu ajanı kimlerin görebileceğini belirler: yalnızca siz, belirli kişiler/gruplar, ya da herkese açık.
  • Açıklama (Description) — İsteğe bağlı; ajanın ne işe yaradığını anlatan kısa bir not.
  • Etiketler (Tags) — İsteğe bağlı; aramayı kolaylaştırır.

Temel Model (Base Model / From)

En önemli seçim budur: ajanınızın hangi dil modelinin üzerine kurulacağı. "Temel Model (Base Model / From)" listesinden altta yatan modeli seçin (ör. bir GPT, Claude veya yerel model). Ajanınız bu modelin yeteneklerini miras alır; siz üstüne kişilik ve kaynak eklersiniz.

📷 Görsel: Temel bilgiler bölümü — avatar, Ad, Model ID, Erişim ve "Temel Model" seçim kutusu.


Adım 3: Sistem & Parametreler

Bu bölüm ajanınıza kişiliğini ve davranışını verdiğiniz yerdir.

  • Sistem Promptu (System Prompt) — Ajanın rolünü, tonunu ve kurallarını tarif eden talimattır. Her sohbette modele sessizce iletilir. Örnek:

    "Sen bir İK asistanısın. Yalnızca şirket İK yönetmeliklerine dayanarak, resmî ve net bir dille yanıt ver. Emin olmadığın konularda İK departmanına yönlendir."

    İyi bir sistem promptu, iyi bir ajanın en belirleyici parçasıdır.

  • Gelişmiş Parametreler (Advanced Params) — Varsayılan olarak gizlidir; "Göster (Show)" ile açılır. Buradan yaratıcılık düzeyi (temperature), yanıt uzunluğu gibi ince ayarları yaparsınız. Çoğu senaryoda varsayılanlar yeterlidir.

📷 Görsel: Sistem Promptu kutusu ve altındaki "Gelişmiş Parametreler → Göster" bağlantısı.


Adım 4: Başlangıç önerileri (Prompts)

Bir ajanla ilk karşılaşan kullanıcıya, sohbet ekranında hazır öneri kartları gösterebilirsiniz ("Bana bir izin talebi dilekçesi hazırla" gibi). Prompts bölümünü Özel (Custom) yapıp her kart için bir Başlık, Alt Başlık ve Prompt metni girin. Bu adım isteğe bağlıdır ama ajanı "nasıl kullanılır" konusunda yönlendirir.


Adım 5: Bilgi & Araçlar

Ajanınıza kurum bilgisini ve yetenekleri burada bağlarsınız.

  • Bilgi (Knowledge)"Bilgi Seç (Select Knowledge)" ile bir veya birden çok bilgi tabanı ekleyin. Ajan, artık her sohbette bu belgelere dayanarak (RAG) yanıt verir. (Bir koleksiyonu buraya ekleyebilmek için önce onun bir departman bilgi tabanı olarak oluşturulmuş olması gerekir → Belge Yükleme ve Bilgi Tabanı.)
  • Araçlar (Tools) — Ajanın çağırabileceği araçları/API'leri seçersiniz (ör. bir veritabanı sorgusu, bir hesaplama servisi). Araçların önce Araçlar çalışma alanında tanımlı olması gerekir.
  • Yetenekler / Beceriler (Skills) — Ajanın kullanabileceği özel becerileri seçersiniz.

📷 Görsel: "Bilgi & Araçlar" bölümü — Bilgi Seç düğmesi ve seçili koleksiyon rozetleri.


Adım 6: Yetenekler (Capabilities)

Ajanın hangi ek yeteneklere sahip olacağını buradan açıp kapatırsınız. Öne çıkanlar:

YetenekNe sağlar
Görsel (Vision)Ajan görsel girdileri işleyebilir
Dosya Yükleme (File Upload)Kullanıcı sohbette dosya ekleyebilir
Web Arama (Web Search)Ajan bilgi için internette arama yapabilir
Görsel Üretimi (Image Generation)Metinden görsel üretebilir
Kod Yorumlayıcı (Code Interpreter)Kod çalıştırıp hesaplama yapabilir
Alıntılar (Citations)Yanıtta kaynak/atıf gösterir

Bir yeteneği açtığınızda ilgili ek seçenekler ortaya çıkabilir (örneğin web arama/görsel üretimi açıksa, bunların sohbette varsayılan olarak açık gelip gelmeyeceğini belirlediğiniz Varsayılan Özellikler (Default Features) bölümü görünür).

💡 Yalnızca gerçekten ihtiyaç duyduğunuz yetenekleri açın — az ve amaca uygun bir ajan, hem daha hızlı hem daha öngörülebilir olur.

📷 Görsel: Yetenekler bölümü — Görsel, Web Arama, Kod Yorumlayıcı vb. onay kutuları.


Adım 7: Kaydedin

Formun altındaki "Kaydet & Oluştur (Save & Create)" düğmesine basın. (Var olan bir ajanı düzenliyorsanız buton "Kaydet & Güncelle (Save & Update)" olur.)

Ajanınız artık model listesinde görünür ve yeni sohbet başlatırken model seçicide seçilebilir.

⚠️ Kaydetmeden önce Ad ve Model ID alanlarının dolu olduğundan emin olun; ayrıca yüklenen dosyalar varsa yüklemelerinin bitmesini bekleyin — sistem aksi halde uyarı verir.


İyi Bir Ajan İçin İpuçları

  • Tek bir işe odaklayın. "Her şeyi yapan" bir ajandansa, dar ve net görevli ajanlar daha isabetli çalışır.
  • Sistem promptunu net yazın. Ajanın neyi yapıp neyi yapmayacağını, hangi kaynağa dayanacağını açıkça söyleyin.
  • Doğru bilgi tabanını bağlayın. Ajan yalnızca bağladığınız koleksiyonları "bilir".
  • Erişimi bilinçli verin. Kuruma açacağınız bir ajanı paylaşmadan önce birkaç örnek soruyla test edin.

Sık Karşılaşılan Sorular

Ajan belgelerimi bilmiyor. Adım 5'te ilgili bilgi tabanını Bilgi (Knowledge) bölümünden bağladığınızdan emin olun. Bağlı değilse ajan o belgelere erişemez.

"Bu ID'ye sahip bir model zaten var" hatası alıyorum. Model ID benzersiz olmalıdır. Adı biraz değiştirin ya da ID'yi elle güncelleyin.

Temel Model listesinde istediğim modeli göremiyorum. İlgili model sağlayıcısının sistem yöneticiniz tarafından tanımlanmış ve etkin olması gerekir. Bkz. Desteklenen Entegrasyonlar.


İlgili: Belge Yükleme ve Bilgi Tabanı · Araç Bağlama (MCP / Tool Server) · RAG Nasıl Çalışır