Genel Bakış
Yapay Zeka Sağlayıcı Ayarları ekranı, sistemde kullanılacak yapay zeka servislerinin tanımlandığı alandır. Bu ekran üzerinden OpenAI, OpenRouter veya kurum içi LLM servisleri gibi yapay zeka sağlayıcıları sisteme eklenebilir.
Yapay zeka sağlayıcısı tanımlandığında sistem, girilen bağlantı bilgileri ve token aracılığıyla ilgili yapay zeka servisine bağlanır. Böylece sistem içerisinde yapay zeka destekli yanıt üretme, metin analizi yapma, destek süreçlerine yardımcı olma veya belirlenen modele göre içerik oluşturma işlemleri gerçekleştirilebilir.
Yapay Zeka Sağlayıcı Ekranına Erişim
Yapay zeka sağlayıcı ayarlarına ulaşmak için aşağıdaki adımlar izlenir:
Ayarlar > Sağlayıcılar > Yapay Zeka > + Ekle
Sol altta bulunan Ayarlar alanına tıklanır.
Açılan ekranda Sağlayıcılar alanı seçilir.
Sol taraftaki sağlayıcı listesinde Yapay Zeka seçeneğine tıklanır.
Yeni bir yapay zeka sağlayıcısı eklemek için sağ üstte bulunan + Ekle butonuna tıklanır.
Yeni Yapay Zeka Sağlayıcısı Ekleme
Yeni bir yapay zeka sağlayıcısı eklemek için + Ekle butonuna tıklanır.
Butona tıklandığında sağlayıcı ekleme penceresi açılır. Bu pencerede yapay zeka sağlayıcısına ait bağlantı bilgileri girilir.
Açılan formda aşağıdaki alanlar yer alır:
Alan | Açıklama |
Tipi | Kullanılacak yapay zeka sağlayıcısının seçildiği alandır. |
Görünen Ad | Sağlayıcının sistemde görünecek adıdır. |
Base URL | Yapay zeka sağlayıcısının API bağlantı adresidir. |
Token | Sağlayıcıdan alınan API anahtarıdır. |
Model | Kullanılacak yapay zeka modelinin adıdır. |
Prompt | Modele verilecek varsayılan sistem talimatıdır. |
Tipi Alanı
Tipi alanında sisteme bağlanacak yapay zeka sağlayıcısı seçilir.
Bu alan, sistemin hangi yapay zeka sağlayıcısı ile çalışacağını belirler.
Örnek sağlayıcı tipleri:
OpenAI
OpenRouter
Voyce LLM
Seçilen sağlayıcı tipine göre sistem, ilgili sağlayıcıya ait API yapısı üzerinden bağlantı kurar.
Görünen Ad Alanı
Görünen Ad alanı, sağlayıcının sistem içerisinde hangi isimle görüntüleneceğini belirler.
Bu alan, özellikle birden fazla yapay zeka sağlayıcısı tanımlandığında kullanıcıların sağlayıcıları kolayca ayırt edebilmesi için kullanılır.
Örnek görünen adlar:
ChatGPT
DeepSeek
OpenAI Destek Asistanı
Voyce LLM
Aynı sağlayıcı farklı amaçlarla birden fazla kez eklenecekse daha açıklayıcı isimler kullanılabilir.
Örnek:
OpenAI - Müşteri Destek
OpenRouter - DeepSeek
Voyce LLM - Test Ortamı
Base URL Alanı
Base URL, yapay zeka sağlayıcısının API servis adresidir. Sistem, yapay zeka modeline istek gönderirken bu adres üzerinden bağlantı kurar.
Her sağlayıcının kendine ait bir Base URL bilgisi bulunur.
OpenAI için örnek Base URL:
OpenRouter için örnek Base URL:
Kurum içi veya özel bir LLM servisi kullanılacaksa, ilgili servise ait özel Base URL girilir.
Base URL yanlış girilirse sistem ilgili sağlayıcıya bağlanamaz. Bu nedenle Base URL bilgisinin sağlayıcı tarafından belirtilen API adresiyle aynı şekilde yazılması gerekir.
Token Alanı
Token alanı, yapay zeka sağlayıcısından alınan API anahtarının girildiği alandır. Sistem, sağlayıcıya bağlanırken bu token bilgisini kullanır.
Token, sistemin ilgili yapay zeka sağlayıcısına erişebilmesini sağlar. Bu nedenle bağlantının kurulabilmesi için token bilgisinin doğru girilmesi gerekir.
Bu alan zorunludur. Token alanı boş bırakıldığında sistem aşağıdaki uyarıyı verir:
Token bilgisi gizli tutulmalıdır. Bu bilgi, ilgili yapay zeka sağlayıcısına erişim yetkisi verdiği için yetkisiz kişilerle paylaşılmamalıdır.
Model Alanı
Model alanı, sistemin hangi yapay zeka modeli üzerinden yanıt üreteceğini belirler. Bu alana, seçilen sağlayıcının desteklediği model adı yazılır.
Model adı, sağlayıcının model listesinde yer alan ad ile birebir aynı olmalıdır. Model adı hatalı yazılırsa token doğru olsa bile sistem modelden yanıt alamayabilir.
Bu alan zorunludur. Model alanı boş bırakıldığında sistem aşağıdaki uyarıyı verir:
Model zorunludur.
Model Örneği | Sağlayıcı | Kullanım Amacı |
gpt-4o-mini | OpenAI | Hızlı, düşük maliyetli destek yanıtları ve kısa metin üretimi için kullanılabilir. |
gpt-4o | OpenAI | Daha kaliteli yanıtlar, analiz ve daha kapsamlı destek senaryoları için tercih edilebilir. |
openai/gpt-4o-mini | OpenRouter | OpenAI modelini OpenRouter üzerinden kullanmak için tercih edilebilir. |
Token kullanımı, modele gönderilen metin ve modelin ürettiği yanıta göre değişir. Uzun promptlar, uzun kullanıcı mesajları ve detaylı cevaplar daha fazla token tüketir. Bu nedenle model seçilirken yanıt kalitesi alınmalıdır.
Dökümantasyonun içerisinde tokenin nasıl oluşturulacağı ve sistem bağlantısı kısmı ilerleyen kısımlarda bulunmaktadır.
Prompt Alanı
Prompt alanı, yapay zekaya verilecek varsayılan sistem talimatının yazıldığı alandır.Bu alan üzerinden modelin nasıl davranması gerektiği belirlenebilir. Örneğin modelin kısa cevap vermesi, müşteri destek asistanı gibi davranması veya belirli bir dilde yanıt üretmesi istenebilir.
Örnek prompt:
Sen müşteri destek süreçlerinde yardımcı olan bir yapay zeka asistanısın. Kullanıcı sorularına kısa, net ve anlaşılır cevaplar ver.
Başka bir örnek:
Sen çağrı merkezi temsilcilerine yardımcı olan bir asistansın. Gelen müşteri taleplerini analiz et, uygun cevap önerileri sun ve gereksiz uzun açıklamalardan kaçın.
Prompt alanı isteğe bağlı olarak kullanım amacına göre özelleştirilebilir.
OpenAI Token ile Bağlantı Kurma
OpenAI sağlayıcısını sisteme bağlamak için OpenAI hesabı üzerinden API key oluşturulmalı ve bu token sistemdeki sağlayıcı formuna girilmelidir.
OpenAI API Key Oluşturma Adımları
OpenAI Platform hesabına giriş yapılır.(https://platform.openai.com/login)
API Keys alanına gidilir.
3.API Keys ekranında sağ üstte bulunan + New Key butonuna tıklanır.
4.Açılan API key oluşturma penceresinde key bilgileri girilir.
Bu pencerede aşağıdaki alanlar bulunur:
Alan | Açıklama |
Name | Oluşturulacak API key için isim girilen alandır. Örneğin Chatbot Key, Voyce AI Key veya OpenRouter Test Key yazılabilir. |
Credit limit | API key için kredi limiti belirlenen alandır. Boş bırakılırsa limitsiz olarak kullanılabilir. |
Reset limit every | Belirlenen kredi limitinin hangi aralıklarla sıfırlanacağını belirtir. Limit kullanılmayacaksa N/A olarak kalabilir. |
Expiration | API key’in geçerlilik süresini belirler. Süre sınırı istenmiyorsa No expiration seçili bırakılabilir. |
OpenRouter üzerinde açılan API key oluşturma penceresi buraya eklenir.
Gerekli bilgiler doldurulduktan sonra Create butonuna tıklanır.
Oluşturulan API key ekranda görüntülenir ve kopyalanır.
Kopyalanan API key, sistemdeki yapay zeka sağlayıcı ekleme formunda bulunan Token alanına yapıştırılır.
OpenRouter Sağlayıcısını Sisteme Ekleme
OpenRouter token alındıktan sonra sistem üzerinde aşağıdaki yol izlenir:
Ayarlar > Sağlayıcılar > Yapay Zeka > + Ekle
Açılan sağlayıcı ekleme formunda alanlar aşağıdaki şekilde doldurulur:
Alan | Örnek Değer |
Tipi | OpenRouter |
Görünen Ad | DeepSeek veya OpenRouter |
Base URL | |
Token | OpenRouter üzerinden oluşturulan API key |
Model | deepseek/deepseek-chat |
Prompt | Sen kullanıcı sorularına yardımcı olan bir yapay zeka asistanısın. |
OpenRouter’da model adı genellikle sağlayıcı/model formatında yazılır.
Örnek model adları:
deepseek/deepseek-chat
openai/gpt-4o-mini
openai/gpt-4o
Tüm bilgiler doldurulduktan sonra Ekle butonuna tıklanır.
Kayıt başarılı olduğunda OpenRouter sağlayıcısı Yapay Zeka sağlayıcı listesine eklenir ve sistem tarafından kullanılabilir hale gelir.
Dikkat Edilmesi Gerekenler
Token bilgisi gizli tutulmalı ve yetkisiz kişilerle paylaşılmamalıdır.
Görsel alınırken gerçek token bilgisi görünür bırakılmamalıdır.
Kullanılan token, seçilen sağlayıcıya ait olmalıdır.
OpenAI seçildiyse OpenAI API key kullanılmalıdır.
OpenRouter seçildiyse OpenRouter API key kullanılmalıdır.
Base URL, sağlayıcıya uygun API adresi olmalıdır.
Model adı, sağlayıcının desteklediği model adıyla aynı şekilde yazılmalıdır.
Token hatalı veya geçersizse sistem yapay zeka sağlayıcısından yanıt alamaz.
Model adı hatalı girilirse bağlantı kurulsa bile yapay zeka modeli çalışmayabilir.
Aynı sağlayıcı farklı modeller için birden fazla kez tanımlanabilir.
Kullanım Özeti
Yapay zeka sağlayıcısı eklemek için aşağıdaki yol izlenir:
Ayarlar > Sağlayıcılar > Yapay Zeka > + Ekle
Açılan formda sağlayıcı tipi seçilir, görünen ad girilir, Base URL bilgisi yazılır, sağlayıcıdan alınan token eklenir, kullanılacak model belirtilir ve gerekirse prompt alanı doldurulur.
Özellikle Token ve Model alanları zorunludur. Bu alanlar doldurulmadan sağlayıcı kaydı tamamlanamaz.