Panduan versi dan API tersuai FinRobot

Kenal pasti FinRobot yang anda jalankan

README rasmi yang disemak pada d2219100 pada 5 September 2026 menerangkan FinRobot Desktop v0.1.0 dengan PydanticAI, FastAPI dan React/Tauri. Ia turut mengekalkan aliran kerja finrobot_equity Pro dan tutorial AutoGen lama. Ini bukan permukaan konfigurasi yang boleh ditukar ganti. Keluaran desktop ditanda desktop-v0.1.0 pada 6a8161ff; snapshot master ialah identiti sumber berasingan. Rekodkan keluaran atau commit sebenar, arahan masuk dan fail konfigurasi. Kehadiran arahan OAI_CONFIG_LIST lama dalam repositori sama tidak membuktikan cara aplikasi desktop memuatkan model.

Bandingkan laluan aplikasi yang didokumenkan

Anggap pemilihan versi sebagai pemeriksaan keserasian pertama. Dokumentasi desktop menerangkan orkestrasi, peranan penyelidikan khusus dan pengiraan kewangan deterministik, tetapi semakan ini tidak menetapkan laluan endpoint APIsRouter tersuainya. Skrip Pro dan ejen Python lama mendedahkan tetapan berbeza yang kelihatan dalam sumber. Permintaan berjaya melalui satu tidak boleh mengesahkan yang lain. Semak juga nota platform desktop dan tandatangan rasmi sebelum pemasangan; jangan memintas pemeriksaan keselamatan sistem operasi hanya untuk menyiapkan tutorial integrasi.

Gunakan medan endpoint Pro hanya untuk skrip Pro

finrobot_equity/core/config/config.ini.example semasa merangkumi openai_api_key, openai_base_url dan openai_model. generate_financial_analysis.py membaca URL asas dan model pilihan lalu memajukannya kepada laluan penjanaan teks. Templat di bawah menyesuaikan medan disahkan itu; gantikan placeholder huruf besar secara tempatan. Fail INI ini tidak membayangkan interpolasi pemboleh ubah persekitaran. Lindungi fail sebenar dengan kebenaran tempatan, kecualikan daripada kawalan versi dan elakkan menerbitkannya dalam log sokongan. Kunci data kewangan kekal bebas daripada kelayakan 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 laluan penjanaan teks Pro dengan input jelas

Gunakan skrip analisis Pro dengan identiti syarikat dan fail konfigurasi terlindung, kemudian periksa analisis terjana sebelum merender laporan. Pemerolehan kewangan, andaian ramalan dan pengiraan angka kekal berasingan daripada laluan naratif model di bawah. Untuk penerbit antarabangsa, semak liputan bursa penyedia data, mata wang pelaporan dan asas perakaunan sebelum membandingkan hasil. Selesaikan kiraan saham, tempoh fiskal dan sebarang penukaran mata wang secara jelas. Jalankan peringkat yang diperlukan sahaja semasa membina pakej laporan pertama yang boleh 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

Kekalkan pengiraan kewangan boleh dihasilkan semula

Seni bina desktop semasa memisahkan pengiraan kewangan daripada penjelasan LLM secara jelas. Gunakan prinsip penerimaan sama apabila menyemak artifak FinRobot: jejaki angka dipaparkan kepada input sumber, unit, andaian dan pengiraan yang menghasilkannya. Penilaian deterministik masih bergantung pada ramalan tidak pasti; kebolehulangan bukan bukti ramalan akan berlaku. Asingkan andaian asas dan senario alternatif, kekalkan formula dan minta model membincangkan sensitiviti dan bukannya memilih nilai sasaran secara senyap. Minta input hilang kekal hilang sehingga penyemak membekalkan andaian yang dibenarkan.

Anggap notebook AutoGen lama sebagai migrasi berasingan

finrobot/agents/workflow.py yang dikekalkan mengimport AutoGen dan menerima llm_config. Tutorial lama memuatkan entri model melalui OAI_CONFIG_LIST dan menghantar senarai konfigurasi kepada aliran kerja. Jika mengekalkan laluan ini, ikut notebook dan versi kebergantungan bersama. Jangan memindahkan konfigurasi PydanticAI moden ke dalamnya atau menerangkan OAI_CONFIG_LIST sebagai tetapan FinRobot universal. Migrasi proses laporan sedia ada memerlukan pemeriksaan alat, pemuatan kunci data, tingkah laku pelaksanaan kod dan penjanaan laporan, bukan menggantikan URL asas sahaja.

Sahkan satu laporan daripada input kepada lokasi sumber

Mulakan dengan pakej pemfailan awam terhad dan soalan sempit. Selepas ujian klien yang dibenarkan berasingan, sahkan satu alat data wajib, satu pengiraan angka dan satu bahagian laporan dengan petikan. Rekodkan semakan aplikasi, hash sumber, konfigurasi tanpa rahsia, ID model diselesaikan dan penggunaan diperhatikan. Semak teks terjana mengekalkan unit dan membezakan fakta dilaporkan daripada unjuran. Salam pengangkutan atau respons kilang model hanya membuktikan peringkat itu. Penerimaan laporan lengkap juga memerlukan kelengkapan data, semakan pengiraan, output mudah dibaca dan dakwaan boleh dijejaki.

Belanjakan dan pulihkan pada sempadan peringkat

Asingkan caj data kewangan, permintaan model, sumber render laporan dan semakan penganalisis. Gunakan harga semasa untuk anggaran, kemudian rekonsiliasikan lejar permintaan termasuk percubaan dan kegagalan. Jika medan API diabaikan, periksa skrip entri tepat sebelum menambah fail konfigurasi lain. Jika laporan kosong, periksa log pemerolehan dan parsing sebelum menukar model. Apabila input angka bercanggah, jedakan laporan untuk semakan dan simpan kedua-dua nilai sumber. Sambung daripada peringkat dibetulkan supaya laporan lengkap mengekalkan sebab setiap perubahan.

Bukti dan batasan

Dokumentasi sumber dan keluaran disemak pada 5 September 2026. Medan endpoint Pro dan pemajuannya disahkan dalam d2219100; laluan gerbang tersuai desktop kekal tidak disahkan. Tiada permintaan APIsRouter, laporan lengkap atau kes penggunaan terukur dilaksanakan untuk panduan ini. Contoh Pro terpakai pada skrip dinamakan, bukan desktop atau semua notebook lama.

Soalan lazim