> ## Documentation Index > Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Yapay Zekâ Entegrasyonu > Yapay zekâ sohbetini, LaTeX hata önerilerini, kullanıcı erişimini, kotaları ve isteğe bağlı arama hizmetlerini yapılandırın. Bu özellik [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/overleaf-pro) tarafından sağlanır ve v6.3.0 sürümünden itibaren kullanılabilir. Herhangi bir sorunla karşılaşırsanız geri bildiriminizi bekliyoruz. ## Yapay zekâ asistanı ve LaTeX hata asistanı Ayakaleaf Pro, yapay zekâ özelliklerini düzenleyiciye 2 şekilde getirir. * AI Assistant, soruları yanıtlamak ve incelemeniz için düzenleme önerileri sunmak üzere proje belgelerinizi ve geçerli seçiminizi bağlam olarak kullanabilir. * Error Assistant, bir LaTeX derleme hatasını seçtiğinizde hedefe yönelik bir düzeltme önerir. ### Toolkit yapılandırması Toolkit dağıtımınızdaki `config/variables.env` dosyasına aşağıdakileri ekleyin; örnek URL'yi, anahtarı ve modeli sağlayıcınızdan aldığınız değerlerle değiştirin: ```dotenv theme={null} AI_ENABLED=true AI_BASE_URL=https://ai-gateway.example.com/v1 AI_API_KEY=REPLACE_WITH_YOUR_GATEWAY_API_KEY AI_MODEL=YOUR_TEXT_MODEL_ID ``` Gerçek API anahtarlarını dağıtım ortamı dosyanızda tutun ve sürüm denetiminin dışında bırakın. Yukarıdaki değerler yer tutucudur, çalışan kimlik bilgileri değildir. Yapay zekâ önerilerinin kalitesi seçtiğiniz modele bağlıdır. Zaten bir Codex veya ChatGPT aboneliğiniz varsa, bunu [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)'nin OpenAI uyumlu uç noktası üzerinden bağlayabilirsiniz. `AI_BASE_URL`, gerektiğinde sağlayıcının sürüm önekini de içeren OpenAI uyumlu API temel URL'sidir. Bunu dahili olarak biz eklediğimiz için `/chat/completions` eklemeyin. Ağ geçidi ve model, akışlı (streaming) sohbet tamamlamalarını ve fonksiyon araçlarını desteklemelidir. Her iki özellik de belge bağlamını bu ağ geçidine gönderir; görsel destekli bir model kullanıldığında sohbet, yüklenen görselleri de gönderebilir. Toolkit, `config/variables.env` dosyasını uygulama konteynerine iletir. Burada gösterilen değişken adlarını koruyun; `OVERLEAF_` öneki eklemeyin. Bu değişkenleri değiştirdikten sonra Toolkit dizininden uygulama konteynerini yeniden oluşturun: ```sh theme={null} bin/up -d ``` ### Ağ geçidi ayarları | Değişken | Varsayılan | Amaç | | - | - | - | | `AI_ENABLED` | `false` | Örnek için sohbeti ve hata önerilerini etkinleştirmek üzere tam olarak `true` olarak ayarlayın. Ayarlanmamışsa veya başka bir değer verilmişse devre dışı kalırlar. Ayrıca çalışan bir ağ geçidi yapılandırması da gereklidir. | | `AI_BASE_URL` | Yok; zorunlu | OpenAI uyumlu API temel URL'si. | | `AI_API_KEY` | Yok; zorunlu | Sunucu tarafından kullanılan, ilgili ağ geçidine ait API anahtarı. | | `AI_MODEL` | Yok; zorunlu | Varsayılan sohbet yapılandırması ve LaTeX hata önerileri tarafından kullanılan metin modeli. | | `AI_IMAGE_MODEL` | Ayarlanmamış | Aynı ağ geçidinde, aynı API anahtarını kullanan isteğe bağlı görsel destekli model. | | `AI_MAX_STEPS` | `20` | Otomatik devamlar dahil, yapay zekâ sohbetinde kullanıcı mesajı başına en fazla araç çağrısı sayısı. Pozitif bir tam sayı kullanın. | | `AI_PROXY_URL` | Ayarlanmamış | Yapay zekâ ağ geçidine yapılan çağrılar için isteğe bağlı HTTP proxy URL'si. Web veya belge arama istemcilerini yapılandırmaz. | | `AI_TOKEN_QUOTA` | `0` | Her dönem için sohbet ve hata önerileri tarafından paylaşılan, kullanıcı başına token sınırı. Ayarlanmamış veya `0` sınırsız anlamına gelir; sınır için pozitif bir tam sayı kullanın. | | `AI_TOKEN_QUOTA_PERIOD` | `month` | `month` her ayın ilk günü 00:00 UTC'de sıfırlanır; `week` her pazartesi 00:00 UTC'de sıfırlanır. Diğer değerler `month` olarak kullanılır. | Görsel yüklemeleri için `AI_IMAGE_MODEL` değerini, görsel girdisi kabul eden ve sohbetin kullandığı araçları destekleyen bir modele ayarlayın. Geçmişinde görsel eki bulunan her sohbet isteği, o konuşmadaki sonraki mesajlar da dahil olmak üzere bu modeli kullanır. Bu ayar olmadan görsel istekleri, kendisinin görselleri desteklemesi gereken normal sohbet modelini kullanır. LaTeX hata önerileri `AI_MODEL` kullanmaya devam eder. Örneğin bir görsel modelini ve haftalık bir yapay zekâ kullanım hakkını etkinleştirmek için: ```dotenv theme={null} AI_IMAGE_MODEL=YOUR_IMAGE_CAPABLE_MODEL_ID AI_TOKEN_QUOTA=100000 AI_TOKEN_QUOTA_PERIOD=week ``` ### Kullanıcı erişimi ve onay Örnek düzeyindeki kullanılabilirlik ile kullanıcı izni birbirinden ayrıdır. `AI_ENABLED` ve ağ geçidi yapılandırması örnek düzeyindeki kullanılabilirliği denetler. Oturum açmış bir kullanıcının ayrıca mevcut hesap denetimlerinden de geçmesi gerekir: * `aiFeatures.enabled` değeri `false` olmamalıdır. Bu mevcut veritabanı alanı hem sohbeti hem de LaTeX hata önerilerini denetler. * Kullanıcının geçerli `features.aiUsageQuota` değeri yapılandırılmış sınırsız katmanla (varsayılan olarak `unlimited`) eşleşmeli ya da mevcut eski `features.aiErrorAssistant` izni etkin olmalıdır. Geçerli özellikler, uygulanabilir hesap özelliği geçersiz kılmalarını da içerir. Onay kutusunu tek başına etkinleştirmek kullanıcının planını değiştirmez. `aiUsageQuota` alanı sayısal bir token hakkı değil, bir izin katmanıdır. `AI_TOKEN_QUOTA`, izin verilen her kullanıcıya eşit olarak uygulanan ayrı bir sınırdır; mevcut modül hesap başına ayrı bir sayısal sınır sağlamaz. Yönetici kullanıcı listesinde bir kullanıcı seçin ve **Update account info → AI features** öğesini açın. **Enable AI features**, hesap değişiklikleri kaydedildiğinde `aiFeatures.enabled` değerini günceller. Sunucu, zaten açık olan bir düzenleyiciden gelen istekler de dahil olmak üzere yeni yapay zekâ isteklerinde geçerli izinleri denetler. Bir izin değişikliğinden sonra görünür denetimlerin güncellenmesi için düzenleyiciyi yenileyin. ### Kullanım ve sıfırlama Yöneticinin AI features sekmesi, geçerli dönemin **Usage**, **Limit** ve **Reset** düğmesini tek bir satırda gösterir. Kullanım, sekme açıldığında okunur; sürekli olarak yenilenmez. En güncel sayıyı görmek için bir sohbet veya hata önerisi tamamlandıktan sonra sekmeyi yeniden açın. Sıfırlama hemen etkili olur ve yalnızca o kullanıcının geçerli dönem sayacını temizler, ardından görüntülenen kullanımı yeniden yükler. Hesap formunun geri kalanının kaydedilmesini gerektirmez. Sohbet ve hata önerisi kullanımı tek bir Redis sayacını paylaşır; bu sayaç, bir istek tamamlandıktan sonra model sağlayıcısının bildirdiği toplam token sayısına göre güncellenir. Buna model adımları boyunca girdi ve çıktı token'ları dahildir. Girdi; konuşma geçmişini, belge bağlamını ve araç sonuçlarını içerebilir, bu nedenle bir takip mesajı yalnızca yeni mesajın kendisinden daha fazla token tüketebilir. Sınır **Unlimited** olduğunda bile kullanım kaydedilir. Token toplamı bildirilmeyen istekler sayaca eklenmez; geçmişte kaydedilmemiş kullanım modül tarafından yeniden oluşturulamaz. Kota denetimleri akış başlamadan önce yapılır. Bir istek veya birkaç eşzamanlı istek, sonraki istekler engellenmeden önce kalan hakkı aşabilir. Bu, katı bir sağlayıcı harcama sınırı değil, bir kullanım hakkıdır. Kota sorgusu başarısız olursa isteğe izin verilir ve hata günlüğe kaydedilir. Her iki özellik de `AI_TOKEN_QUOTA` kullanır; hata önerilerinin ayrı bir istek sayısı sınırı yoktur. Sayacı sıfırlamak izni, onayı, yapılandırılmış sınırı veya sağlayıcının kendi faturalandırma kayıtlarını değiştirmez. Sayaçlar UTC dönem anahtarlarını kullanır ve 40 gün sonra sona erer; Redis verilerini korumak, uygulama yeniden başlatmalarında geçerli kullanımı korur. ### İsteğe bağlı arama hizmetleri Web araması, Tavily uyumlu bir API kullanır. Bir arama API anahtarı yapılandırıldığında kullanılabilir. Bu ayarlar yapay zekâ ağ geçidinden bağımsızdır: | Değişken | Varsayılan | Amaç | | - | - | - | | `TAVILY_API_KEY` | Ayarlanmamış | Arama API anahtarı. `WEB_SEARCH_API_KEY` değerine göre önceliklidir. | | `WEB_SEARCH_API_KEY` | Ayarlanmamış | Arama API anahtarı için alternatif ad. | | `WEB_SEARCH_URL` | `https://api.tavily.com/search` | Arama uç noktası; özel uç noktalar Tavily istek ve yanıt biçimini kabul etmelidir. | | `WEB_SEARCH_MAX_RESULTS` | `5` | Arama başına istenen sonuç sayısı; hizmetin desteklediği pozitif bir tam sayı kullanın. | | `WEB_SEARCH_DEPTH` | `basic` | Arama derinliği; normalde `basic` veya `advanced`. | | `WEB_SEARCH_PROVIDER` | `tavily` | Mevcut uygulama yalnızca Tavily uyumlu protokolü destekler; bu değeri değiştirmek başka bir bağdaştırıcı seçmez. | | `DOCS_MCP_URL` | `https://docs.overleaf.com/~gitbook/mcp` | Belge arama uç noktası. Belge aramasını devre dışı bırakmak için boş bir dize olarak ayarlayın. | Örneğin: ```dotenv theme={null} TAVILY_API_KEY=REPLACE_WITH_YOUR_SEARCH_API_KEY WEB_SEARCH_MAX_RESULTS=5 WEB_SEARCH_DEPTH=basic DOCS_MCP_URL=https://docs.overleaf.com/~gitbook/mcp ``` Belge araması, yapılandırılmış GitBook MCP uç noktasının `searchDocumentation` aracını çağırır ve JSON veya SSE yanıtlarını kabul eder. Bu, belge araması için bir MCP istemcisidir; bu modüller proje dosyalarını bir MCP sunucusu olarak sunmaz veya genel amaçlı bir MCP sunucu kaydı sağlamaz. Arama sorguları yapılandırılmış arama hizmetine gider. Arama sonuçları daha sonra yapay zekâ ağ geçidine yapılan isteklere dahil edilebilir. Sohbetin **Tools** menüsü, kullanıcıların istekleri için **Web** ve **Documentation** seçeneklerini etkinleştirmesine veya devre dışı bırakmasına olanak tanır; bir aracın modelin kullanımına sunulabilmesi için sunucuda da yapılandırılmış olması gerekir. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.