# AI kurulumu

Bir API sağlayıcısı, yerel bir model ya da kurulu bir CLI ajanı bağlayın.

Nasıl çalışmak istediğinizi seçin. Oleafly, yerleşik asistanını bir model API'sine karşı çalıştırabilir, yerel bir modele bağlanabilir ya da kurulu bir CLI ajanı kullanabilir.

| Elinizde olan… | Seçeceğiniz… |
| --- | --- |
| Bir model API anahtarı | **Sağlayıcılar ve anahtarlar** |
| Yerel bir model sunucusu | **Ollama** ya da özel bir OpenAI uyumlu sağlayıcı |
| Kurulu bir kodlama ajanı | [**CLI ajanları**](/docs/cli-agents/) |
| Dış bir MCP istemcisi | [**MCP**](/docs/mcp/) |

İstediğiniz yolu yapılandırmak için **Ayarlar → Yapay Zeka Asistanı**'nı açın. Birkaç sağlayıcıyı bağlı tutabilir ve sohbette modeller arasında geçiş yapabilirsiniz.

API anahtarınız yok mu? Oturum açtığınız bir CLI ajanı onun yerini alabilir. Onu Araçlar için model olarak seçin; Araçlar ve Oleafly'nin diğer yapay zeka özellikleri onu kullanır. Bkz. [API anahtarı yerine bir ajan kullanın](/docs/cli-agents/#use-an-agent-instead-of-an-api-key).

![Ayarlar → Yapay Zeka Asistanı → Sağlayıcılar ve anahtarlar. Yapılandırmak için sağlayıcınızı genişletin. Ollama, listenin alt sıralarındadır.](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-providers-dark-window-v2.png#view=519,89,883,902)

![Asistan ayarlarındaki sağlayıcı anahtarları, komut satırı ajanları ve beceriler.](https://cdn.oleafly.com/images/gifs/desktop/settings-ai-agents.gif?v=2)

## Bir sağlayıcı bağlayın

1. **Sağlayıcılar ve anahtarlar**'ı açın ve bir sağlayıcıyı genişletin.
2. API anahtarını girin ve kaydedin.
3. Oleafly bağlantıyı denetler ve model listesini yeniler.
4. Asistanda bir model seçin ya da **Yönergeler**'de bir varsayılan belirleyin.

OpenAI

Anthropic

Google Gemini

Perplexity

Z.AI

Groq

OpenRouter

DeepSeek

Mistral

xAI

Ollama

Ayarlar'daki her sağlayıcı kartı, kendi anahtar kurulumuna bağlanır. Ollama, yerel bir model sunucusuna bağlanır.

## Bir model seçin

Model satırları, varsa yetenek bilgilerini gösterir: bağlam boyutu, görü, araçlar ve akıl yürütme. Proje işleri için araç destekli bir model, görsel incelemesi için görü destekli bir model kullanın.

**Doğrulanmış**, bir araç çağrısı denetiminin başarılı olduğu anlamına gelir. **Denenmemiş**, asistanın o modeli henüz doğrulamadığı anlamına gelir; **Engellenmiş**, neden seçilemediğine dair bir gerekçe içerir. Bu rozetler araç uyumluluğunu anlatır. Bir modelin araştırma ya da yazma kalitesini puanlamaz.

Araç çağıramayan bir model düz sohbet için yine de çalışır. Seçiliyken ileti alanı **Yalnızca sohbet, bu model araç kullanamaz** der.

Kullanılabilir modeller değiştiğinde sağlayıcı kartındaki **Yenile**'yi seçin. Her sağlayıcı 30 saniyede bir yenilenebilir; ne kadar kaldığını görmek için düğmenin üzerine gelin. Ayrıca bir modeli kimliğiyle ekleyebilirsiniz.

**Tümünü aç** ve **Tümünü kapat**, bir sağlayıcının listesindeki her modeli açar ya da kapatır. Uzun bir listeyi tek tıklamayla kapatın, ardından kullandığınız birkaç modeli yeniden açın.

## Yerel bir model bağlayın

[Ollama](https://ollama.com/)'yı kurup başlatın, sonra Ollama'da bir model indirin. Oleafly'de Ollama kartını açın ve **Ollama'yı denetle** seçeneğini belirleyin. Sunucu bulunduğunda kurulu bir model seçin.

Yerel bir model, model isteklerini makinenizde tutar. Çevrimiçi araştırma araçları kullanıldığında yine kendi kaynak hizmetleriyle iletişim kurar.

## Özel bir uç nokta ekleyin

OpenAI uyumlu bir hizmet, yerel sunucu ya da ağ geçidi için **Özel sağlayıcı ekle**'yi seçin. Bir ad, temel URL ve gerekiyorsa bir anahtar girin. Kaydedin ve bir model seçin.

OpenCode Zen ve OpenCode Go özel sağlayıcı olarak çalışır. Oturum kimliği olmayan istekleri reddederler; bu yüzden Oleafly onlara her sohbetin kimliğini gönderir ve başka hiçbir sağlayıcıya göndermez. Yerel bir Lemonade sunucusu da burada çalışır. Cevap vermeden önce düşünen modelleri için [Düşünme adımını atlama](/docs/ollama/#skip-the-thinking-step) bölümüne bakın.

Kaydedilmiş bir sağlayıcıyı düzenlemek adresini değiştirmenize izin verir. Kayıtlı bir anahtar, o sağlayıcı kullanıldığında yeni adrese gönderilir; bu yüzden kaydetmeden önce hedefi denetleyin.

## Yazım tercihlerini belirleyin

**Yönergeler**, kalıcı tercihleri ve varsayılan sohbet modelini barındırır. Somut yönergeler kullanın:

> İngiliz İngilizcesi yazımını kullan. Atıf anahtarlarını koru. Denklem değişikliklerini uygulamadan önce açıkla.

**Personalar**, adlandırılmış yönerge hazır ayarlarını saklar. **Beceriler**, yinelenen araştırma işleri için yordamlar sağlar. [Becerileri keşfedin →](/docs/skills/)

## Anahtarlar ve maliyetler

Sağlayıcı anahtarları yerel uygulama deposunda şifrelenir ve proje kaynak dosyalarının dışında tutulur. Barındırılan istekler, verilen bağlamla birlikte seçili sağlayıcıya gider. Model API ücretleri ve CLI abonelikleri kendi sağlayıcıları tarafından faturalandırılır.

[Kullanımı ve bütçeleri gözden geçirin →](/docs/ai-usage/)
