Ana içeriğe geç

SDK Genel Bakış

MonoChat’in Custom Function SDK’sı, geliştiricilerin platformu JavaScript ile yazılmış özel mantıklarla genişletmesine olanak tanır. Fonksiyon türüne bağlı olarak, parametre olarak sağlanan sdk nesnesi, istemci tarafı veya sunucu tarafı yürütmeye optimize edilmiş farklı yetenekler sunar.

İki ana SDK bağlamı vardır:

  • İstemci SDK: Tarayıcıda çalışan fonksiyonlar için, özellikle Custom View.
  • Sunucu SDK: Sunucuda çalışan diğer tüm fonksiyon türleri için kullanılır.

Her iki SDK için detaylı bilgiler ve API referansları ilgili bölümlerde sunulacaktır.

Özel Fonksiyon Türleri​

MonoChat, platformda belirli amaçlara hizmet eden çeşitli özel fonksiyon türlerini destekler:

Custom View (İstemci)​

İstemci tarafında çalışan fonksiyonlar, geliştiricilerin MonoChat arayüzü içinde özel UI bileşenleri veya tam sayfa görünümler oluşturmasına olanak tanır. Bu fonksiyonlar istemci SDK’sını kullanır ve MonoChat tarafından sağlanan yerleşik UI bileşenlerinden faydalanabilir.

Custom Flow Node (Sunucu)​

Kullanıcı veya workflow akışlarına eklenebilen sunucu tarafı fonksiyonlardır. İş mantığı, entegrasyonlar veya veri dönüşümleri gibi görevleri sunucu tarafında gerçekleştirirler.

Sunucu Tarafı Metod (Sunucu)​

Diğer fonksiyonlar tarafından çağrılabilen yeniden kullanılabilir sunucu tarafı fonksiyonlardır. Bu metodlar, sunucu veya istemci tarafından çağrılabilir ve açığa çıkartılırsa API uç noktaları üzerinden de erişilebilir.

// Örnek kullanım
CustomFunction(async function ({ sdk }, reject, resolve) {
  const Samples = await sdk.customCollection("samples");
  const { datas, options } = await Samples.listAsync();

  resolve(datas);
});

AI Aracı (Sunucu)​

AI Node’lar içinde AI Kullanıcıları (LLM’ler) tarafından kullanılmak üzere tasarlanmış fonksiyon araçlarıdır. Konuşmalar sırasında kullanıcıların aksiyon almasını, veri çekmesini veya mantık tetiklemesini sağlar.

Cron Job (Sunucu)​

Belirli aralıklarla çalışan sunucu tarafı zamanlanmış işlerdir. Veri senkronizasyonu, hatırlatıcı gönderme veya workflow tetikleme gibi arka plan görevleri için uygundur.

Özel Uygulama Kurulumu (Sunucu)​

MonoStore’dan yayınlanan bir uygulamanın kurulum aşamasında kullanılır. Başlangıç verilerini yüklemek, yapılandırmaları ayarlamak veya bir organizasyon uygulamayı yüklediğinde setup rutinlerini çalıştırmak için idealdir.