Ana içeriğe geç

AI agent: Hızlı başlangıç

ONLYOFFICE AI ajanı, metin oluşturma, yeniden yazma, biçimlendirme, çeviri ve içerik analizi gibi günlük görevleri hızlandırmak için AI özelliklerini doğrudan ONLYOFFICE editörlerinde kullanmanızı sağlar.

not

AI araçları editörlere yerleşiktir, bu nedenle herhangi bir eklenti yüklemeniz gerekmez. Ancak güvenlik nedeniyle varsayılan olarak hiçbir AI modeli bağlı değildir. AI özelliklerini kullanmaya başlamak için aşağıda açıklandığı gibi seçtiğiniz bir modeli bağlayın.

Üst araç çubuğunda AI Tools sekmesi görüntülenmiyorsa, Eklentiler sekmesine gidin, Arka plan eklentileri düğmesine tıklayın ve AI Tools anahtarının açık olduğundan emin olun.

AI Tools tab

Hızlı kurulum​

1. Adım. Bir AI sağlayıcısı bağlayın​

  1. AI Tools sekmesine gidin ve Settings düğmesine tıklayın. AI Settings penceresi AI Models sekmesinde açılır.
  2. AI Models sekmesinde Add Model düğmesine tıklayın.
  3. Provider açılır listesinden bir AI sağlayıcısı seçin (örneğin OpenAI, Anthropic, Google Gemini veya OpenRouter). Listede olmayan bir sağlayıcıyı bağlamak için Import Custom Provider düğmesine tıklayın (bkz. Adding a custom AI provider).
  4. API key değerinizi girin. LM Studio veya Ollama gibi yerel bir sağlayıcı kullanıyorsanız, bunun yerine Base URL değerini girin.
  5. Bir Model seçin, bağlantıyı tanımlamak için bir Profile name girin ve Add Model düğmesine tıklayın.
  6. Model Assignment sekmesinde farklı modelleri belirli görevlere atayın: AI Chat, Code, Summarization, Translation, Text Analysis, Image generation, OCR ve Vision. Default model olarak bırakılan her görev, yukarıda seçilen modeli kullanır.
  7. MCP Servers sekmesinde (isteğe bağlı) Edit configuration düğmesine tıklayın, sunucu yapılandırmanızı mcpServers altına JSON biçiminde girin ve sunucunun araçlarını AI sohbetinde kullanılabilir hale getirmek için Save düğmesine tıklayın.
  8. Web search sekmesinde (isteğe bağlı) bir Web Search Engine seçin (örneğin Exa) ve AI ajanının web'den gerçek zamanlı bilgi almasını sağlamak için API anahtarını girin.

Sağlayıcıları, atanan modelleri, MCP sunucularını veya web arama ayarlarını istediğiniz zaman AI Tools → Settings bölümünden değiştirebilirsiniz.

API anahtarı geçersizse, API key alanının altında bir hata iletisi görünür ve Add Model düğmesi kullanılamaz durumda kalır. Anahtarı kontrol edin ve yeniden girin.

Adding an AI model in the AI Settings window

2. Adım. AI ajanını kullanın​

AI ajanı giriş panelini açmak için işletim sisteminize uygun klavye kısayolunu kullanın. Komut isteminizi yazın ve yanıtı almak için Enter tuşuna basın. Ek bir yapılandırma gerekmez.

Klavye kısayolları:

İşlemPlatformKısayol
AI ajanı panelini açWindows ve LinuxCtrl+/
AI ajanı panelini açmacOSCmd+/
AI ajanı panelini kapatTüm platformlarEsc

AI ajanıyla neler yapabilirsiniz​

Yapılandırıldıktan sonra AI ajanı şunlarda size yardımcı olabilir:

  • Metin oluşturma, yeniden yazma ve genişletme.
  • Belgeleri özetleme ve önemli bilgileri çıkarma.
  • İçeriği çevirme ve dil bilgisini iyileştirme.
  • Metni anlaşılırlık, yapı ve ton açısından analiz etme.
  • Basit dosya ve içerik iş akışlarını AI ajanlarıyla otomatikleştirme.

Sorun giderme​

AI Tools sekmesi görünmüyor

AI Tools eklentisinin Arka plan eklentileri bölümünde etkin olduğundan emin olun. Eklentiyi yeni yüklediyseniz veya güncellediyseniz editörü yeniden başlatın.

AI ajanı açılıyor ancak yanıt vermiyor

API anahtarınızın geçerli olduğunu ve seçilen AI sağlayıcısının kullanılabilir olduğunu kontrol edin. Ağ kısıtlamaları, güvenlik duvarı kuralları veya proxy ayarları editörün sağlayıcıya bağlanmasını engelleyebilir.

Yerel AI sağlayıcıları bağlanmıyor

LM Studio veya Ollama gibi yerel bir sağlayıcı kullanıyorsanız, yerel AI hizmetinin çalıştığından, yapılandırılan adresten erişilebildiğinden ve güvenlik duvarı kurallarıyla engellenmediğinden emin olun.

Yanıtlar yavaş veya eksik

Bu durum, AI sağlayıcısı yüksek yük altındayken veya komut istemi çok büyükken oluşabilir. İsteği sadeleştirmeyi veya daha küçük adımlara bölmeyi deneyin. Yerel sağlayıcılar için CPU, GPU ve bellek kullanılabilirliğini kontrol edin.

Beklenmeyen sonuçlar

AI yanıtları seçilen modele ve komut istemine bağlıdır. Çıktı beklentilerinizi karşılamıyorsa, komut istemini yeniden ifade etmeyi veya daha fazla bağlam sağlamayı deneyin.