Panduan versi dan API kustom FinRobot

Identifikasi FinRobot yang Anda jalankan

README resmi yang ditinjau pada d2219100 tanggal 5 September 2026 menjelaskan FinRobot Desktop v0.1.0 dengan PydanticAI, FastAPI, dan React/Tauri. README juga mempertahankan workflow finrobot_equity Pro serta tutorial AutoGen lama. Semua ini bukan permukaan konfigurasi yang dapat dipertukarkan. Rilis desktop ditag desktop-v0.1.0 pada 6a8161ff; snapshot master merupakan identitas sumber terpisah. Catat rilis atau commit aktual, perintah entrypoint, dan file konfigurasi. Kehadiran instruksi OAI_CONFIG_LIST lama dalam repositori yang sama tidak membuktikan cara aplikasi desktop memuat model.

Bandingkan jalur aplikasi yang terdokumentasi

Jadikan pemilihan versi sebagai pemeriksaan kompatibilitas pertama. Dokumentasi desktop menjelaskan orkestrasi, peran riset spesialis, dan komputasi keuangan deterministik, tetapi tinjauan ini tidak menetapkan jalur endpoint kustom APIsRouter-nya. Skrip Pro dan agen Python lama memiliki pengaturan yang terlihat di sumber berbeda. Request yang berhasil melalui satu jalur tidak mengesahkan jalur lain. Tinjau juga catatan platform desktop dan penandatanganan resmi sebelum instalasi; jangan melewati pemeriksaan keamanan sistem operasi hanya untuk menyelesaikan tutorial integrasi.

Gunakan kolom endpoint Pro hanya untuk skrip Pro

finrobot_equity/core/config/config.ini.example saat ini berisi openai_api_key, openai_base_url, dan openai_model. generate_financial_analysis.py membaca base URL dan model opsional lalu meneruskannya ke jalur pembuatan teks. Template berikut mengadaptasi field yang telah diverifikasi; ganti placeholder huruf besar secara lokal. File INI ini tidak berarti ada interpolasi environment variable. Lindungi file sebenarnya dengan izin lokal, kecualikan dari version control, dan jangan menerbitkannya dalam log dukungan. Key data keuangan tetap independen dari kredensial model.

[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

Jalankan jalur pembuatan teks Pro dengan input eksplisit

Gunakan skrip analisis Pro dengan identitas perusahaan dan file konfigurasi terlindungi, lalu periksa analisis yang dihasilkan sebelum rendering laporan. Akuisisi keuangan, asumsi perkiraan, dan perhitungan numerik tetap terpisah dari jalur narasi model di bawah. Untuk penerbit internasional, periksa cakupan bursa, mata uang pelaporan, dan basis akuntansi penyedia data sebelum membandingkan hasil. Jelaskan jumlah saham, periode fiskal, dan setiap konversi mata uang. Jalankan hanya tahap yang diperlukan saat menyiapkan paket laporan pertama yang dapat diperiksa.

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

Jaga perhitungan keuangan tetap dapat direproduksi

Arsitektur desktop saat ini secara eksplisit memisahkan komputasi keuangan dari penjelasan LLM. Terapkan prinsip penerimaan yang sama saat meninjau artefak FinRobot: telusuri angka yang ditampilkan ke input sumber, satuan, asumsi, dan perhitungan yang menghasilkannya. Valuasi deterministik tetap bergantung pada perkiraan yang tidak pasti; reproduktibilitas bukan bukti bahwa perkiraan akan bertahan. Pisahkan asumsi dasar dan skenario alternatif, pertahankan formula, dan minta model membahas sensitivitas alih-alih memilih nilai target secara diam-diam. Wajibkan input yang hilang tetap hilang sampai peninjau memberikan asumsi berotorisasi.

Perlakukan notebook AutoGen lama sebagai migrasi terpisah

finrobot/agents/workflow.py yang dipertahankan mengimpor AutoGen dan menerima llm_config. Tutorial lama memuat entri model melalui OAI_CONFIG_LIST dan meneruskan config list ke workflow tersebut. Jika mempertahankan jalur ini, ikuti notebook dan versi dependensinya secara bersamaan. Jangan memindahkan konfigurasi PydanticAI modern ke sana atau menyebut OAI_CONFIG_LIST sebagai pengaturan FinRobot universal. Migrasi proses laporan yang ada memerlukan pemeriksaan tool, pemuatan data-key, perilaku eksekusi kode, dan pembuatan laporan, bukan hanya mengganti base URL.

Validasi satu laporan dari input ke penunjuk sumber

Mulailah dengan paket pengajuan publik terbatas dan pertanyaan sempit. Setelah uji client yang diotorisasi terpisah, validasi satu data tool yang diperlukan, satu perhitungan numerik, dan satu bagian laporan dengan sitasi. Catat revisi aplikasi, hash sumber, konfigurasi tanpa secret, model ID yang diselesaikan, dan penggunaan yang diamati. Pastikan teks yang dibuat mempertahankan satuan dan membedakan fakta yang dilaporkan dari proyeksi. Hello transport atau respons factory model hanya membuktikan tahap tersebut. Penerimaan laporan lengkap juga memerlukan kelengkapan data, tinjauan perhitungan, output yang terbaca, dan klaim yang dapat ditelusuri.

Anggarkan dan pulihkan di batas tahap

Pisahkan biaya data keuangan, permintaan model, resource rendering laporan, dan peninjauan analis. Gunakan harga terkini untuk perkiraan, lalu rekonsiliasikan ledger request, termasuk retry dan kegagalan. Jika kolom API diabaikan, periksa skrip entry yang tepat sebelum menambahkan file konfigurasi. Jika laporan kosong, periksa log akuisisi dan parsing sebelum mengubah model. Jika input numerik bertentangan, hentikan laporan untuk peninjauan dan pertahankan kedua nilai sumber. Lanjutkan dari tahap yang dikoreksi agar laporan selesai mempertahankan alasan setiap perubahan.

Bukti dan keterbatasan

Dokumentasi sumber dan rilis ditinjau 5 September 2026. Kolom endpoint Pro dan forwarding-nya dikonfirmasi di d2219100; jalur gateway kustom desktop tetap belum terverifikasi. Tidak ada request APIsRouter, laporan lengkap, atau kasus penggunaan terukur yang dijalankan untuk panduan ini. Contoh Pro berlaku untuk skrip yang disebutkan, bukan desktop atau setiap notebook lama.

Pertanyaan umum