> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# YZ özellikleri

Sohbet, görevler, model politikası ve kendi-anahtarını-getir.

## Sahte yapay zekayı deneyin, ardından gerçek bir sağlayıcı seçin

İlk sonucunuz için Web eğitiminin /dashboard görevini izleyin: yerel akışı başlatın, bir istemi sıraya alın, çalıştırın ve sonucu görüntüleyin. AI_PROVIDER=fake, harici bir modele veri göndermeden veya ücretli bir API anahtarı kullanmadan tekrarlanabilir bir gösterim yanıtı döndürür.

Gerçek nesil için öncelikle kalıcı hesapları yapılandırın, bir AI sağlayıcı seçin ve aşağıdaki AI yapılandırmasını takip edin. Veritabanı kataloğuna bir model ve fiyatını ekleyin, her takma ad için izin verilen modelleri seçin ve çalışma alanına gerekli erişimi verin. Hızlı gibi bir takma ad, kullanıcıya gösterilen dostane bir seçimdir; kendisi harici bir sağlayıcının model kimliği değildir.

Bir arka plan AI task'nin ayrıca yapılandırılmış işler hizmetine ihtiyacı vardır. Hiçbir model seçeneği gösterilmiyorsa, yeniden denemeden önce kataloğu ve takma ad politikasını inceleyin. Erişim reddedilirse etkin çalışma alanının yetkilerini inceleyin. Tüm sağlayıcı API anahtarlarını tarayıcıda, mobil uygulamada veya masaüstü penceresinde değil, Web sunucusunun yapılandırmasında tutun.

[Kimlik bilgisi gerektirmeyen yapay zeka gösterimini deneyin](https://supastack.dev/tr/docs/web/ship-in-5-minutes.md)

[Gerçek yapay zeka oluşturmayı yapılandırın](https://supastack.dev/tr/docs/modules/ai-configuration.md)

[İzin verilen modelleri ve fiyatları ekleyin](https://supastack.dev/tr/docs/web/setup-ai.md)

[Arka planda görev yürütmeyi yapılandırın](https://supastack.dev/tr/docs/modules/jobs.md)


## Görev yaşam döngüsünü izleyin

Üretim görev API'si, görevi kalıcı kılıp ai.generate Trigger.dev iş akışını göndermeden önce kimliği doğrulanmış çalışma alanını ve yetkilendirmeyi doğrular. Yönlendirici yetenek gereksinimlerini ve yapılandırılmış model politikasını uygular.

```
POST /api/ai/tasks
  → authenticated workspace + entitlement
  → durable task record
  → Trigger.dev ai.generate
  → model routing + generation
  → usage record + result
  → transactional completion delivery
```


## Takma adları ve bütçeleri yapılandırın

Kullanıcı etkin bir takma ad seçer: cheap, fast veya smart. Sunucu, alttaki model kimliklerini, sağlayıcı kimlik bilgilerini, çalışma alanı politikasını ve bütçe uygulamasını kontrol eder. Şifreli kendi-anahtarını-getir desteği aynı yalnızca-sunucu sınırını korumalıdır.


## İş akışı semantiğini açık tutun

JobRunner yalnızca enqueue, status ve cancel vaat eder. Trigger.dev iş akışı semantiği açıktır, dayanıklı yürütme davranışı dahil. Genel sözleşmeden yeniden deneme ya da zamanlama garantileri çıkarmayın.

Üretim gönderim yolu, belirsiz gönderimi ele almak için idempotency ve kaydedilmiş görev kurtarma kullanır. Üretimin tamamlanması, tamamlanma e-postası tesliminden ayrıdır.


## Kurulum ve yapılandırma

AI_PROVIDER=fake geliştirmeyi deterministik tutar. Üretim sağlayıcıları sunucu tarafında yapılandırılır (OpenAI, Anthropic ya da OpenAI uyumlu bir uç nokta) ve istemci paketlerine asla girmeyen anahtarlarla. AI_MODEL_POLICY, kullanıcıya dönük takma adları — cheap, fast, smart — katalog model kimliklerine eşler; boş bir takma ad, seçeneği arayüzden kaldırır.

Model kataloğu (ai-model-catalog), fiyatlar değiştikten sonra kullanım kayıtlarının açıklanabilir kalması için yetenek meta verileri ve değişmez fiyatlandırma taşır.

```
POST /api/ai/tasks          → durable task + Trigger.dev dispatch
GET  /api/ai/tasks/{taskId}  → status + result
/chat                        → streaming assistant surface
```


## Uygulama iş akışı

Sohbet yüzeyi, çalışma alanı üyesi başına ileti dizilerini tutar ve chat-stream-runtime üzerinden token akışı yapar. Daha uzun üretimler görev olarak çalışır: API sınırında yetkilendirilir, ai.generate iş akışıyla yürütülür ve idempotent gönderim deposu üzerinden kurtarılabilir.

Kendi-anahtarını-getir modu, sağlayıcı anahtarlarını AES-GCM zarfları olarak saklar (CREDENTIAL_ENCRYPTION_KEY, byok-key-vault.ts); şifre çözme yalnızca sunucu yürütme yolu içinde gerçekleşir. Kullanım ve tahmini maliyet, çalışma alanı bütçeleri için istek başına kaydedilir.


## Doğrulama ve sorun giderme

Devre dışı bir takma adın arayüzde olmadığını, yetkilendirme ve bütçe retlerinin gönderimden önce gerçekleştiğini, yeniden denenen gönderimin görevini yeniden kullandığını ve saklanan BYOK anahtarının istemciye asla dönmediğini doğrulayın. Gerçek model kabulünü belgelenen sağlayıcı smoke yolunda tutun.


## Sonraki

[Arka plan işleri](https://supastack.dev/tr/docs/web/jobs.md)