Early. These endpoints power SmoothOS today and may still change. Reference documentation lives inside the product for early-access agencies; a public developer program, partner keys and outgoing webhooks aren't available yet.
Kimlik doğrulama
Her istek, Authorization başlığında Bearer token olarak oturum açmış bir kullanıcının erişim token'ını taşır. Ayrı API anahtarları yoktur. SAI o kişinin oturumuyla okur ve yazar; böylece neyi görebileceğine model değil, veritabanının satır düzeyinde güvenliği karar verir. Bir araç yetki duvarına çarptığında SAI tahmin yürütmez; bu bilginin o erişimle görünmediğini söyler.
POST /functions/v1/sai/chat
Tek bir konuşma turu. Bir message ve isteğe bağlı olarak ekrandaki kaydı (context), bir threadId, bir agent, bir task ve bir locale gönderin. Yanıt threadId, reply, agent (operator, finance, delivery, brand ya da growth), model, locale, region, grounding ve çağrılan araçları döndürür. threadId gönderilmezse, kullanıcı konuşmaları saklayabiliyorsa yeni bir konuşma açılır; aksi hâlde tur durumsuzdur ve threadId null olur.
curl -X POST "$SMOOTHOS_API/functions/v1/sai/chat" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"message": "Which invoices are overdue?", "locale": "en-US", "context": {"route": "/admin"}}'POST /functions/v1/sai/action
Model içermeyen tek bir araç çağrısı; widget'lar ve kısayollar için. tool ve args gönderin, tool ve result geri alın. Bugün kullanılabilen araçlar: get_financial_summary (bir dönem için para birimine göre ödenen, açık, vadesi geçmiş ve 30 gün içinde vadesi gelecek toplamlar), get_project_kpis (tek bir proje için durum, ilerleme, görevler, bütçeye karşı zaman, faturalanan ve ödenen) ve get_client_dossier (bir markanın onaylı hafızası). Hepsi çağıranın yetkileriyle çalışır.
curl -X POST "$SMOOTHOS_API/functions/v1/sai/action" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"tool": "get_financial_summary", "args": {"from": "2026-10-01", "to": "2026-10-31"}}'POST /functions/v1/sai/context
SAI'nin bir ekran için yükleyeceği şeyi döndürür: kaydı ve arkasındaki markayı. Bir route, isteğe bağlı bir title ve kind, id ile label'dan oluşan isteğe bağlı bir entity içeren bir sayfa bağlamı gönderin. Web uygulaması bu yapıyı mevcut sayfadan kurar; ileride planlanan mobil uygulama da aynısını gönderecek.
Diller
SAI, veriler hangi dilde olursa olsun her zaman kullanıcının yerel ayarında (locale) yanıt verir. Locale önce isteğin locale alanından, sonra Accept-Language başlığından, sonra kullanıcının kayıtlı dilinden alınır. Ürün İngilizce, Türkçe ve Arapçayı destekler.
Modeller ve anahtarlar
Her tur üç katmandan birine gider: uzun okumalar için bulk (varsayılan Gemini 3.6 Flash), araçlar, para, kapsam ve kayıtlardan yanıtlar için reason (varsayılan Claude Sonnet 5.5) ve ekranda kayıt olmayan kısa sorular için quick (varsayılan Claude Haiku 5.5). Ajanslar kendi Anthropic ya da Google anahtarlarını getirir; bu anahtarlar bir kasada saklanır ve ajanslar her katmanı Ayarlar'dan değiştirebilir. Her çağrı modeli, token sayısı ve maliyetiyle kaydedilir.
Hatalar
401 unauthorized: token eksik ya da geçersiz. 403 no_agency: kullanıcı bir ajansa bağlı değil. 409 ai_not_configured: ajans bir yapay zekâ sağlayıcısı kurmamış. 400 invalid_message ya da unknown_tool: mesaj ya da araç adı geçerli değil.
Henüz yok
Akışlı yanıtlar, görev oluşturma ya da fatura taslağı hazırlama gibi yazma araçları (her biri bir onay adımıyla) ve mobil anlık bildirimler planlanıyor, henüz yayımlanmadı. İş ortakları için giden webhook'lar da henüz yok.
Lisans
SmoothOS, Business Source License 1.1 kapsamında kaynak kodu erişilebilir bir yazılımdır ve her sürüm üç yıl sonra Apache 2.0 olur. Kendi sunucunuzda barındırabileceğiniz bir Community Edition yolda; bekleme listesi açık.