FinRobot sürümü ve özel API kılavuzu

Hangi FinRobot'u çalıştırdığınızı belirleyin

5 Eylül 2026'da d2219100 revizyonunda incelenen resmî README, PydanticAI, FastAPI ve React/Tauri kullanan FinRobot Desktop v0.1.0'ı açıklar. Ayrıca finrobot_equity Pro iş akışını ve eski AutoGen öğreticilerini korur. Bunlar birbirinin yerine geçebilen yapılandırma yüzeyleri değildir. Masaüstü sürümü desktop-v0.1.0 etiketiyle 6a8161ff'tedir; master görüntüsü ayrı bir kaynak kimliğidir. Gerçek sürümü veya commit'i, giriş komutunu ve yapılandırma dosyasını kaydedin. Aynı depodaki eski OAI_CONFIG_LIST talimatlarının bulunması masaüstü uygulamasının modelleri nasıl yüklediğini kanıtlamaz.

Belgelenmiş uygulama yollarını karşılaştırın

Sürüm seçimini ilk uyumluluk kontrolü sayın. Masaüstü dokümantasyonu orkestrasyonu, uzman araştırma rollerini ve deterministik finansal hesaplamayı anlatır, ancak bu inceleme özel APIsRouter uç nokta yolunu oluşturmadı. Pro komut dosyası ve eski Python ajanları farklı kaynakta görünen ayarları açığa çıkarır. Birinden gelen başarılı istek diğerlerini onaylamaz. Kurulumdan önce resmî masaüstü platformu ve imzalama notlarını da inceleyin; entegrasyon öğreticisini tamamlamak için işletim sistemi güvenlik kontrollerini atlamayın.

Pro uç nokta alanlarını yalnızca Pro komut dosyasında kullanın

Güncel finrobot_equity/core/config/config.ini.example openai_api_key, openai_base_url ve openai_model içerir. generate_financial_analysis.py isteğe bağlı temel URL'yi ve modeli okur ve bunları metin üretim yoluna iletir. Aşağıdaki şablon bu doğrulanmış alanlara uyarlanır; büyük harfli yer tutucuları yerelde değiştirin. Bu INI dosyası ortam değişkeni interpolasyonu anlamına gelmez. Gerçek dosyayı yerel izinlerle koruyun, sürüm kontrolünden çıkarın ve destek günlüklerinde yayımlamayın. Finansal veri anahtarı model kimlik bilgisinden bağımsız kalır.

[API_KEYS]
fmp_api_key = YOUR_FINANCIAL_DATA_KEY
openai_api_key = YOUR_APISROUTER_KEY
openai_base_url = https://api.apisrouter.com/v1
openai_model = CURRENT_CATALOG_MODEL_ID

Pro metin üretme yolunu açık girdilerle çalıştırın

Şirket kimliğiniz ve korunan yapılandırma dosyanızla Pro analiz komut dosyasını kullanın, sonra rapor oluşturmadan önce üretilen analizi inceleyin. Finansal edinim, tahmin varsayımları ve sayısal hesaplamalar aşağıda gösterilen model anlatı yolundan ayrı kalır. Uluslararası ihraççıda sonuçları karşılaştırmadan önce veri sağlayıcısının borsa kapsamını, raporlama para birimini ve muhasebe temelini kontrol edin. Pay sayılarını, mali dönemleri ve para birimi dönüşümünü açıkça çözün. İlk incelenebilir rapor paketini oluştururken yalnızca gereken aşamaları çalıştırın.

python finrobot_equity/core/src/generate_financial_analysis.py \
  --company-ticker "$RESEARCH_TICKER" \
  --company-name "$RESEARCH_COMPANY" \
  --config-file finrobot_equity/core/config/config.ini \
  --generate-text-sections

Finansal hesaplamaları yeniden üretilebilir tutun

Güncel masaüstü mimarisi finansal hesaplamayı LLM açıklamasından açıkça ayırır. Her FinRobot varlığını incelerken aynı kabul ilkesini uygulayın: gösterilen sayıyı kaynak girdilerine, birimlere, varsayımlara ve onu üreten hesaplamaya kadar izleyin. Deterministik değerleme yine belirsiz tahminlere dayanır; yeniden üretilebilirlik bu tahminlerin gerçekleşeceğinin kanıtı değildir. Temel varsayımları ve alternatif senaryoları ayrı tutun, formülleri koruyun ve modelden bir hedef değeri sessizce seçmek yerine duyarlılıkları tartışmasını isteyin. İnceleyen yetkili bir varsayım sağlayana kadar eksik girdilerin eksik kalmasını gerektirin.

Eski AutoGen notebook'larını ayrı geçiş sayın

Korunan finrobot/agents/workflow.py AutoGen'i içe aktarır ve llm_config kabul eder. Eski öğreticiler model girdilerini OAI_CONFIG_LIST üzerinden yükler ve bu iş akışına bir config list geçirir. Bu yolu sürdürüyorsanız notebook'u ve bağımlılık sürümünü birlikte izleyin. Modern PydanticAI yapılandırmasını buraya taşımayın veya OAI_CONFIG_LIST'i evrensel FinRobot ayarı gibi anlatmayın. Mevcut rapor sürecini taşımak yalnızca temel URL'yi değiştirmek değil, araçlarını, veri anahtarı yüklemesini, kod yürütme davranışını ve rapor üretimini kontrol etmeyi gerektirir.

Tek bir raporu girdiden kaynak konumuna doğrulayın

Sınırlı bir herkese açık bildirim paketi ve dar bir soruyla başlayın. Ayrı yetkili istemci testinden sonra gerekli bir veri aracını, bir sayısal hesaplamayı ve atıflı bir rapor bölümünü doğrulayın. Uygulama revizyonunu, kaynak hash'lerini, gizli bilgiler çıkarılmış yapılandırmayı, çözümlenmiş model ID'sini ve gözlenen kullanımı kaydedin. Üretilen metnin birimleri koruduğunu ve raporlanan gerçekleri projeksiyonlardan ayırdığını kontrol edin. Taşıma hello'su veya model fabrikası yanıtı yalnızca o aşamayı kanıtlar. Tam rapor kabulü veri eksiksizliği, hesaplama incelemesi, okunabilir çıktı ve izlenebilir iddialar gerektirir.

Aşama sınırlarında bütçeleyin ve kurtarın

Finansal veri ücretlerini, model isteklerini, rapor oluşturma kaynaklarını ve analist incelemesini ayırın. Tahmin için güncel fiyatlandırmayı kullanın, sonra yeniden denemeler ve hatalar dahil istek defterini uzlaştırın. Bir API alanı yok sayılıyorsa daha fazla yapılandırma dosyası eklemeden kesin giriş komut dosyasını inceleyin. Rapor boşsa modeli değiştirmeden önce edinim ve ayrıştırma günlüklerini inceleyin. Sayısal girdiler çatıştığında raporu inceleme için durdurun ve her iki kaynak değerini koruyun. Her değişikliğin nedeni korunarak tamamlanmış raporun düzeltilen aşamadan sürdürülmesini sağlayın.

Kanıt ve sınırlamalar

Kaynak ve sürüm dokümantasyonu 5 Eylül 2026'da incelendi. Pro uç nokta alanları ve bunların iletilmesi d2219100 içinde doğrulanır; masaüstü özel ağ geçidi yolu hâlâ doğrulanmamıştır. Bu kılavuz için APIsRouter isteği, eksiksiz rapor veya ölçülmüş kullanım vakası çalıştırılmadı. Pro örnekleri adlandırılan komut dosyaları için geçerlidir, masaüstü veya tüm eski notebook'lar için değil.

Sık sorulan sorular