YZ'yi kurun

Kurulum ve yapılandırma

Herhangi bir adımdan önce, Başlamadan önce ve Terminal temelleri bölümlerini okuyun. Bu talimatlar, supastack monorepo'nun tamamını VS Kodunda açtığınızı varsayar; kök package.json dosyası depo kökünü işaretler. pnpm komutlarında çalışma alanı paketi bir uygulama veya paylaşılan kod klasörüdür; Üründe çalışma alanı, ekibin veri taşıyıcısı ve güvenlik sınırıdır. corepack pnpm --filter ... komutlar kökünden çalıştırılırken monorepodan bir paket seçer. Yalnızca senkronize edilmiş bir mobil veya masaüstü klasörü açtıysanız, Web arka ucunu, Docker kurulumunu veya kök komut dosyalarını içermez: arka ucu bu monorepodan veya erişilebilir bir barındırılan sunucudan çalıştırın ve platform klasörünün kendi komut dosyalarını kullanın. Ortam değişkeni, yerel bir .env dosyasında veya barındırma kontrol panelinizde depolanan adlandırılmış bir ayardır; İlgili uygulamayı değiştirdikten sonra yeniden başlatın ve sunucu sırlarını NEXT_PUBLIC_ ve EXPO_PUBLIC_ değerlerinin dışında tutun.

1. Yerel Web sunucusu için apps/web/.env.local'yi ve sağlayıcı seçimi için apps/web/src/agent-runtime.ts'yi açın; .env.example, desteklenen ayar adlarının listesidir.

2. Kendi sağlayıcı hesabınız olmadığı ve gerçek nesli test etmek istemediğiniz sürece AI_PROVIDER=fake'yi yerel arayüz çalışması için saklayın; sağlayıcı anahtarlarını asla NEXT_PUBLIC_ veya EXPO_PUBLIC_ ayarına koymayın.

3. Web uygulamasını depo kökünden corepack pnpm --filter @supastack/web dev ile başlatın. Beklenen: Ücretli bir sağlayıcıyı yapılandırmadan yerel ekranlar keşfedilebilir; gerçek nesil, geçerli bir sunucu sağlayıcısı ve veritabanı kataloğunda etkinleştirilmiş model seçenekleri gerektirir.

Varsayılan AI_PROVIDER=fake yerel deterministik çalışmayı destekler. Gerçek sağlayıcı yapılandırması sunucu ortamına aittir. .env.example'da listelenen sağlayıcı anahtarları OpenAI, Anthropic ve OpenAI uyumlu uç noktayı içerir.

AI_MODEL_POLICY, cheap, fast ve smart takma adları için sıralı model kimlikleri içerir. Boş takma ad listesi o seçimi devre dışı bırakır. Model kimlikleri, geçerli değişmez fiyatlandırmaya sahip etkin veritabanı katalog girdilerine karşılık gelmelidir.

AI_MODEL_POLICY='{"cheap":[],"fast":["catalog-model-id"],"smart":["catalog-model-id"]}'
AGENT_FRAMEWORK=ai-sdk    # ai-sdk | mastra | langgraph | openai-agents

Kopyalanacak komutlar

Bir komutun hangi klasörde çalıştığını görmek için yorumları takip edin. İki terminal etiketlenmişse, iki terminal penceresi açın ve ikincisini kullanırken ilk komutu çalışır durumda tutun.

corepack pnpm --filter @supastack/web dev

Uygulama iş akışı

Üretim görevlerini kabul etmeden önce kataloğu ve çalışma alanı politikasını yapılandırın. Tarayıcı etkin takma adları alırken yetenek eşleştirme, model seçimi, yetkilendirme kontrolleri ve bütçe uygulaması sunucuda kalır.

Kimlik bilgilerini NEXT_PUBLIC_ ve EXPO_PUBLIC_ değişkenlerinden uzak tutun. Kendi-anahtarını-getir modu için mevcut şifreli zarfı ve sunucu şifre çözme sınırını kullanın; saklanan sağlayıcı anahtarını asla arayüze döndürmeyin.

Doğrulama ve sorun giderme

Uygulama hiçbir AI modelinin bulunmadığını bildirirse sunucunun AI_PROVIDER'sini, yönetici kataloğundaki etkin modelleri ve fiyatları ve ucuz/hızlı/akıllı takma ad politikasını kontrol edin. Gerçek bir sağlayıcı kimlik doğrulama hatası verirse apps/web/.env.local'deki anahtarını kontrol edin ve sunucuyu yeniden başlatın. NEXT_PUBLIC_ ön ekine sahip bir anahtar tarayıcılar tarafından görülebilir ve kaldırılmalıdır.

Devre dışı takma adları, eksik yetenekleri, etkin olmayan yetkilendirmeyi ve tükenmiş bütçeleri doğrulayın. Gerçek üretim için ayrıca yetkilendirilmiş sağlayıcı smoke çalışması kullanın. Takma ad yoksa ham model seçici açmak yerine sunucu politikasını ve katalog yapılandırmasını inceleyin.