Yapay zeka

Antimatter'ın yapay zekâ özellikleri seçtiğiniz modelleri kullanır: bir bulut sağlayıcısı veya kendi ağınızda bir sunucu. Bir model yapılandırmadan hiçbir şey hiçbir yere gönderilmez. Bu sayfa model bağlantılarını, her özelliği, gönderdiği verileri ve nasıl kapatılacağını kapsar.

Yapay zeka özellikleri

"OpenAI uyumlu", OpenAI ile aynı HTTP API sunan bir sunucu demektir. Kendi başınıza çalıştırabileceğiniz çoğu model sunucusu bunu yapar (örneğin Ollama, vLLM, llama.cpp'nin sunucusu veya Whisper ve metni sese dönüştürme sunucuları); LiteLLM veya OpenRouter gibi birçok bulut sağlayıcısı ve geçit de öyle. Bu özelliklerin hiçbiri için lisans gerekmez.

Yerleşik özellikler (yeniden yazma, özetler, çeviri ve sesli okuma) Ajanlar uygulamasını gerektirmez; Sistem Konsolu'nda eklediğiniz model bağlantılarını kullanırlar.

Model bağlantıları

Bir model bağlantısı, Antimatter'ın çağırabileceği bir yapay zekâ sağlayıcısıdır: adresi, anahtarı ve modelleri. Bir kez eklersiniz, ardından her özelliği için kullanmasını istediğinizi seçersiniz. İki tür vardır:

• Sunucu genelinde bağlantılar, sistem yöneticileri tarafından Sistem Konsolu › Yapay Zekâ › Model bağlantıları altında yönetilir. Sadece bunlar yerleşik özelliklere hizmet verebilir. Uygulamalar, izin verilen kişiler için bunları da kullanabilir.
• Topluluk bağlantıları, bir topluluğun yöneticileri tarafından kendi toplulukları için topluluk ayarlarında eklenir (bkz. aşağı). Uygulamalar bunları topluluğun üyeleri için kullanır. Asla yerleşik özelliklere hizmet vermezler.

Sistem Konsolu'nun Yapay Zekâ bölümü, sunucu genelinde bağlantıları yönetebilen kişilere gösterilir: varsayılan olarak sistem yöneticileri. Model bağlantıları sayfası, sunucu genelinde bağlantıları ve her topluluğun bağlantılarını listeler.

Bir bağlantı ekle

Sistem Konsolu › Yapay Zekâ › Model bağlantıları içinde Bir bağlantı ekle düğmesine tıklayın, ardından formu doldurun:

Bağlantıyı sına adresi ve anahtarı denetler: sunucu, uç noktadan modellerini ister veya tek jetonlu bir sohbet gönderir. Değiştirilen adres, yalnızca kaydettikten sonra veya anahtarı yeniden yazdığınızda kayıtlı anahtarla denetlenir. Kaydetmek için Bağlantı ekle düğmesine tıklayın.

Sunucu istekleri kendisi yapar, bu nedenle API'ye erişebilmelidir: aynı compose projesindeki bir model sunucusu, ağınızda veya İnternet'te. Giden istekler HTTP_PROXY ve HTTPS_PROXY değişkenlerine uyar.

Bir bağlantı silindiğinde anahtarı unutulur. Bu bağlantıyı kullanan özellikler, başka bir bağlantı seçene kadar yapay zekayı kullanmayı durdurur.

Sınırlar ve bütçeler

Her bağlantının dört sınırı vardır. Boş veya 0, sınırsız anlamına gelir.

• Dakikada istek ve Kişi başına, dakikada istek. Bunlar her sunucu tarafından ayrı ayrı sayılır: üç sunuculuk bir küme, oranın üç katına kadar istek geçirir.
• Ayda token ve Kişi başına, ayda token: takvim ayına (UTC) göre token bütçeleri, tüm küme için veritabanında sayılır. Aynı anda çalışan birden fazla istek, bütçeyi biraz aşabilir.

Kişi başına sınırlar, yeniden yazma ve özetlere de uygulanır: bunlar, yeniden yazan veya özetin sahibi olan kişiye karşı sayılır.

Kullanım

Liste, her bağlantının bu ayki kullanımını gösterir. Kullanım, ayrıntıları açar: giren ve çıkan tokenlar, istekler, aylık bütçe, güne (UTC) ve kullanıma göre (Yeniden yaz, Özetler, Otomatik çeviri, Metni sese dönüştür, Kişiler, uygulamalar aracılığıyla veya bir uygulama) kullanım.

Bir kişinin veya uygulamanın bir bağlantı aracılığıyla yaptığı her çağrı, bir denetim kaydı da yazar: kim, bağlantı, kullanım, model, token sayıları ve başarılı olup olmadığı; asla ne söylendiği. Yerleşik özellikler yalnızca kullanımda sayılır: çeviri tek başına, her iletide ve dilde bir çağrı yapar.

Topluluk bağlantıları

Topluluk yöneticileri, kendi topluluklarının bağlantılarını topluluk ayarlarında, Model bağlantıları sekmesinde ekler. Form aynıdır, Topluluklar alanı hariç: bir topluluğun bağlantısı yalnızca kendi kanallarında, kendi üyeleri için çalışır ve kitlesi yalnızca kendi takımlarını adlandırabilir. Model bağlantılarını yönet iznine sahip roller de bunları yönetebilir. Varsayılan olarak topluluk yöneticileri bu izne sahiptir.

Bir topluluğun bağlantısı, özel veya döngü adreslerine (örneğin ağınızda bir Ollama sunucusu) erişemez, Sistem Konsolu › Ortam › Geliştirici › Şuraya yapılan güvenilmemiş iç bağlantılara izin verilsin (ServiceSettings.AllowedUntrustedInternalConnections) bunları listelemedikçe. Sunucu genelindeki bağlantılar erişebilir.

Topluluk yöneticilerinin tarafı için Topluluk ayarları bölümüne bakın.

Şifreleme anahtarı

Model bağlantılarının anahtarları ve ek başlıkları, veritabanında (AES-256-GCM) tek bir şifreleme anahtarıyla şifrelenir. Sadece bir veritabanı yedeği bunları ifşa etmez. Sunucu anahtarı şu sırayla bulur:

1. AM_AI_ENCRYPTION_KEY değişkeni: base64 biçiminde 32 rastgele bayt. Bir tane oluşturmak için openssl rand -base64 32 komutunu kullanın.
2. Bunun dışında, sunucunun veri dizininin kökünde (FileSettings.Directory, varsayılan olarak ./data/) yer alan ai-encryption.key dosyası. Sunucu, bir bağlantı buna ihtiyaç duyduğunda ilk kez kendisi oluşturur ve yalnızca kendisinin okuyabileceği şekilde ayarlar. Uygulamalar, dışa aktarmalar ve dosya arşivleri bunu okuyamaz.

Değişkeni ne zaman ayarlamalı:

• Sitenin compose dosyasıyla. compose.yaml, AM_AI_ENCRYPTION_KEY değerini .env dosyasından alır ve değişken boşsa anahtar dosyasını data hacminde saklar. Değişkeni ayarlamak daha iyidir: bu durumda .env dosyasının yedeği, veritabanından ayrı olarak anahtarı barındırır. .env dosyasına ekleyin ve docker compose up -d komutunu çalıştırın:

  echo "AM_AI_ENCRYPTION_KEY=$(openssl rand -base64 32)" >> .env

  Eğer sunucu zaten anahtar dosyasını oluşturduysa, kaydedilmiş anahtarların okunabilir kalması için .env dosyasına bunun yerine elindeki anahtarı koyun: docker compose exec antimatter cat /antimatter/data/ai-encryption.key komutu bunu görüntüler.
• Dosyaları S3'te olan bir küme. Sunucuları bir dizin paylaşmadığı için sunucu dosyayı oluşturmaz: her sunucuda aynı değişkeni ayarlayın. Değişken ayarlanana kadar bağlantılar anahtarlarını kaydedemez.
• Sürüm arşivi veya paketlerle kullanımda dosya data/ dizininde (paketler için /var/lib/antimatter/data) bulunur. Orada bırakabilir veya ortam dosyanızda değişkeni ayarlayabilirsiniz.

Anahtarı değiştirmek için, yeni anahtarı AM_AI_ENCRYPTION_KEY ve eski anahtarı AM_AI_ENCRYPTION_PREVIOUS_KEYS (virgülle ayrılmış birden fazla anahtar) değişkenlerine ayarlayın: eski anahtarla kaydedilmiş anahtarlar hâlâ okunabilir. Bir bağlantının anahtarı, onu yeniden girdiğinizde yeni anahtarla şifrelenir. Her bağlantının anahtarı yeniden girilene kadar eski anahtarı listede tutun.

Yerleşik özellikler

Sistem Konsolu › Yapay Zeka › Yerleşik özellikler bölümünde, her özellik için sunucu genelinde bir bağlantı ve model seçin veya Kapalı olarak ayarlayın. Bağlantısı olmayan bir özellik yapay zeka kullanmaz. Modelleri yükle seçeneği, bağlantıya ait tüm modelleri listeler; varsayılan olarak her özellik, bağlantının sohbet modelini kullanır.

Her ayarın bir ConnectionId ve bir Model anahtarı vardır; örneğin AISettings.Rewrite.ConnectionId (AM_AISETTINGS_REWRITE_CONNECTIONID). Boş bırakılan Model, bağlantının varsayılan modelini kullanır.

Yerleşik özellikler, bağlantının sınırlamalarını kullanır ancak kitle kapsamını kullanmaz: Özelliği kullanabilen herkes, onun bağlantısını kullanabilir. Dikkat gerektiren veya silinmiş bir bağlantı, başka bir bağlantı seçene kadar özelliğin çalışmasını engeller; sayfa bunu belirtir.

Yapay zeka ajanları

Aracılar uygulaması (id mattermost-ai) varsayılan olarak açıktır. Yapılandırması iki adımdan oluşur: bir hizmet (model sağlayıcısına bir bağlantı) eklersiniz, ardından bu hizmeti kullanan ajanları oluşturursunuz.

1. Bir hizmet ekleyin

Sistem Konsolu › Uygulama ekleri › Aracılar bölümüne gidin ve Yapay Zekâ Hizmetleri altında Yapay Zekâ Hizmeti Ekle düğmesine tıklayın. Hizmet türü seçin:

• OpenAI Uyumlu: Kendi başınıza çalıştırdığınız bir model sunucusu veya OpenAI tarzı bir API'si olan herhangi bir sağlayıcı için. API URL'sini (örneğin http://ollama:11434/v1 veya http://vllm.internal:8000/v1) ve sunucu gerektiriyorsa yalnızca API Anahtarı'nı doldurun. Sunucu yalnızca Chat Completions API'sini destekliyorsa, Responses API'sini Kullan seçeneğini kapatın.
• OpenAI, Anthropic, Google Gemini, Google Vertex AI, AWS Bedrock, Azure, Cohere, Mistral: barındırılan sağlayıcılar. Her biri kendi API Anahtarı'sını gerektirir (Bedrock: bir AWS bölgesi ve kimlik bilgileri veya bir IAM rolü; Vertex AI: bir proje, bölge ve hizmet hesabı; Azure: API URL'si de dahil).

Ardından Varsayılan model (sağlayıcı modellerini raporlayabiliyorsa bir liste, değilse adını yazın) ve sağlayıcı bunları raporlamıyorsa Giriş token sınırı ile Çıktı token sınırı değerlerini ayarlayın. Bu hizmet başarısız olduğunda devralması için bir Yedek Hizmet tanımlayabilirsiniz. Kaydedin.

Sunucu bu istekleri kendisi yapar, bu nedenle API'ye erişebilmelidir: aynı compose projesindeki bir model sunucusu, ağınızda bulunan bir sunucu veya İnternet üzerindeki bir sunucu. Giden istekler HTTP_PROXY ve HTTPS_PROXY değişkenlerine uyar.

2. Ajanlar oluşturun

Aracılar, web uygulamasının Aracılar sayfasında oluşturulur: Aracılar panelindeki aracı seçicisindeki Yönet öğesiyle (klasik arayüzde ayrıca ürün menüsünden) açılır. Adresi https://chat.example.com/plug/mattermost-ai/agents şeklindedir. Her aracın bir Görüntülenecek ad, bir Aracı Kullanıcı Adı (insanların onu nasıl bahsettiği), bir Hizmet ve isteğe bağlı olarak bir model, Özel Talimatlar ile Görüntüyü Etkinleştir (görüntüler) ve Araçları Etkinleştir anahtarları vardır. Erişim sekmesi, hangi kanallarda kullanılabileceğini ve hangi kullanıcıların kullanabileceğini sınırlar. Sistem Konsolu'ndaki AI Functions bölümünde, Varsayılan bot, örneğin arama özetleri için, hiçbir aracı seçilmediğinde kullanılacak aracı belirler.

Ajanlar uygulamasının isteğe bağlı özellikleri

• Gömme araması (deneysel, kapalı): iletiler üzerinde anlamsal arama. pgvector eklentisi olan PostgreSQL ve bir gömme modeli (OpenAI veya OpenAI uyumlu) gerektirir. Her iletiyi, özel kanallar ve doğrudan iletiler dahil olmak üzere, gömme modeline gönderir.
• Web araması (kapalı): ajanların Google, Brave veya sizin çalıştırdığınız bir SearXNG sunucusu aracılığıyla web'de arama yapmasını sağlar.
• Yerel araçlar: bunları sunan sağlayıcılarda, ajanlar sağlayıcının kendi web aramasını (desteklenen yeni ajanlar için varsayılan olarak açık), web içeriği getirme ve kod çalıştırma işlevlerini kullanabilir. Bunlar sağlayıcıda çalışır. Ajan başına kapatabilirsiniz.
• Model Bağlam Protokolü (MCP): ek araçlar için ajanları güvendiğiniz MCP sunucularına bağlayın.
• Hata Ayıklama: İz Çıktısı (kapalı, sunucu günlükleri veya bir OpenTelemetry uç noktası) ve Token Kullanım Günlüğünü Etkinleştir, bu özellik token sayılarını logs/agents/token_usage.log dosyasına yazar.

Ses metne çevirme: arama transkripsiyonları ve altyazılar

Aramalar, OpenAI uyumlu /v1/audio/transcriptions uç noktası sunan bir konuşmadan metne (speech-to-text) sunucusu tarafından, canlı altyazılarla birlikte transkript edilebilir. Kurulum, Aramalar ve ses bölümündedir. Transkriptleri özetle seçeneği etkinleştirildiğinde, varsayılan ajan her transkriptin bir özetini de gönderir.

Metinden sese: Sesli okuma

Metni sese dönüştürme özelliği açıkken, her iletinin menüsünde Yüksek sesle oku seçeneği bulunur: sunucu, iletinin metnini bir metni sese dönüştürme API'sine gönderir ve sesi çalar. Ayarlar, Sistem Konsolu › Bütünleştirmeler › Metni sese dönüştür bölümündedir:

Yukarıdaki adres ve anahtar yerine bir model bağlantısı kullanmak için, AI › Built-in features bölümünde Metni sese dönüştür için bunu seçin. Sayfa, iletilerin bu bağlantıyla sesli okunduğunu belirtir: API temel URL’si ve API anahtarı kullanılmaz, Ses hâlâ kullanılır ve bağlantı bir model belirtmediğinde Model de kullanılır. İletileri sesli oku hâlâ açık olmalıdır.

Göndermeden önce sunucu, kod bloklarını, bağlantıları, emoji kodlarını ve biçimlendirmeyi kaldırır ve en fazla 4000 karakteri korur. MP3 ses ister ve bellekte son 64 sonucu tutar; böylece iki kez okunan bir iletinin metni yalnızca bir kez gönderilir.

Otomatik çeviri

Otomatik çeviri, bir kanalın iletilerini her okuyucunun kendi dilinde gösterir. Yapılandırması, Sistem Konsolu › Site yapılandırması › Yerelleştirme bölümünde, Otomatik çeviri altındadır:

Her sağlayıcının kendi alanları vardır:

• Model connection: sunucu genelinde bir bağlantı ve modeli, AI › Built-in features bölümündeki Otomatik çeviri ile aynı ayar (AISettings.AutoTranslation). Özgün bir çeviri modeli hızlı ve doğruyken; genel bir LLM de işe yarar.
• LibreTranslate: LibreTranslate API Uç Noktası ve LibreTranslate API Anahtarı (AutoTranslationSettings.LibreTranslate.URL, .APIKey). LibreTranslate sunucusu kendi ağınızda çalıştırılabilir.
• OpenAI uyumlu API: API temel URL’si (/v1 dahil, sunucu sohbet tamamlama uç noktasını kullanır), Model ve API anahtarı (AutoTranslationSettings.OpenAI.URL, .Model, .APIKey). Yerel olarak çalıştırılan küçük bir çeviri modeli iyi sonuç verir.
• AI chat app's service (older): 0.9.0'dan önce kurulan sunucuların sağlayıcısı, Aracılar uygulamasının bir hizmetini kullanıyordu. Artık uygulama gerekmez: AI › Built-in features bölümünde otomatik çeviri için seçilen bağlantıyla veya yükseltme sırasında uygulamanın hizmetinden kopyalanan bağlantıyla çeviri yapar. Model connection'a geçiş ayarı önerilen sağlayıcıya taşır.

Bu özellik etkinleştirildiğinde, kanal yöneticileri ayarlar bölümünden kanalları için çeviriyi açar (Otomatik çeviri) ve her üye kanal menüsünden bu özelliği devre dışı bırakabilir (İletileri çevir). Doğrudan ve grup iletilerinde herhangi bir üye bu özelliği etkinleştirebilir; kısıtlama etkinse, çeviri bu ortamlarda kullanılamaz. Çevrilmiş iletilerde, orijinaline giden bir bağlantıyla birlikte "... dilinden çevrildi" ifadesi gösterilir.

Metin gönderilmeden önce kod, bağlantılar, bahsetmeler ve emojiler yer tutucularla değiştirilir ve sonrasında geri konur.

Veriler nereye gönderilir

Bunların tümünü kendi ağınızda tutmak için, her özelliği kendinizin çalıştırdığı sunuculara yönlendirin. Bir bulut sağlayıcı kullanıyorsanız, veri saklama koşullarını kontrol edin ve kullanıcılarınıza hangi özelliklerin iletilerini dışarı gönderdiğini bildirin.

Yapay zekayı kapatma

Tek bir anahtar yoktur; her özelliğin kendi anahtarı vardır.

• Yeniden yazma ve özetler: Bunları Sistem Konsolu › Yapay zekâ › Yerleşik özellikler bölümünde Kapalı olarak ayarlayın. Kullanıcılar zaten sahip oldukları özetleri okumaya devam ediyor.
• Model bağlantıları: Bir bağlantıyı silerek kullanımını tamamen durdurun. Hiçbir bağlantı yoksa, ne yerleşik özellikler ne de uygulamalar sunucu üzerinden yapay zekâyı kullanabilir.
• Ajanlar: Ajanlar uygulamasını Sistem Konsolu › Uygulama ekleri › Uygulama eki yönetimi bölümünde devre dışı bırakın. Bu işlem arama özetlerini de kaldırır.
• Transkripsiyon ve altyazılar: AM_CALLS_ENABLE_TRANSCRIPTIONS=false ve AM_CALLS_ENABLE_LIVE_CAPTIONS=false (varsayılan değerler).
• Yüksek sesle oku: Bağlantı kullanıp kullanmadığına bakılmaksızın İletileri sesli oku özelliğini kapatın (AM_TEXTTOSPEECHSETTINGS_ENABLE=false, varsayılan değer).
• Çeviri: Otomatik çeviriyi kapatın (AM_AUTOTRANSLATIONSETTINGS_ENABLE=false, varsayılan değer).

Ajanlar uygulamasını devre dışı bırakmak diğer özellikleri kapatmaz; bu özellikler model bağlantılarını veya kendi API'lerini kullanır.