מדריך גרסה ו-API מותאם ל-FinRobot

זהו איזה FinRobot אתם מריצים

ה-README הרשמי שנבדק ב-d2219100 ב-5 בספטמבר 2026 מתאר את FinRobot Desktop v0.1.0 עם PydanticAI, FastAPI ו-React/Tauri. הוא גם שומר תהליך finrobot_equity Pro ומדריכי AutoGen ישנים. אלה משטחי תצורה שאינם ניתנים להחלפה. ה-release השולחני מסומן desktop-v0.1.0 ב-6a8161ff; ה-snapshot של master הוא זהות מקור נפרדת. תעדו את ה-release או ה-commit בפועל, את פקודת הכניסה ואת קובץ התצורה. הימצאות הוראות OAI_CONFIG_LIST ישנות באותו מאגר אינה מבססת כיצד יישום desktop טוען מודלים.

השוו את נתיבי היישום המתועדים

התייחסו לבחירת גרסה כבדיקת התאימות הראשונה. תיעוד desktop מתאר תזמור, תפקידי מחקר מתמחים וחישוב פיננסי דטרמיניסטי, אך בדיקה זו לא ביססה נתיב endpoint מותאם של APIsRouter. סקריפט Pro וסוכני Python ישנים חושפים הגדרות נראות במקור שונות. בקשה שהצליחה בנתיב אחד אינה מאשרת את האחרים. בדקו גם את ההערות הרשמיות על פלטפורמת desktop ועל חתימה לפני התקנה; אל תעקפו בדיקות אבטחת מערכת הפעלה רק כדי להשלים מדריך אינטגרציה.

השתמשו בשדות endpoint של Pro רק בסקריפט Pro

הקובץ הנוכחי finrobot_equity/core/config/config.ini.example כולל openai_api_key, openai_base_url ו-openai_model. generate_financial_analysis.py קורא base URL ו-model אופציונליים ומעביר אותם לנתיב יצירת הטקסט. התבנית שלהלן מתאימה את השדות שאומתו; החליפו את מצייני המקום הגדולים מקומית. קובץ INI זה אינו מרמז על interpolation של משתני סביבה. הגנו על הקובץ האמיתי בהרשאות מקומיות, החריגו אותו מבקרת גרסאות והימנעו מפרסומו ביומני תמיכה. מפתח הנתונים הפיננסיים נשאר נפרד מפרטי הגישה למודל.

[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 עם קלטים מפורשים

השתמשו בסקריפט ניתוח Pro עם זהות החברה וקובץ תצורה מוגן, ואז בדקו את הניתוח שנוצר לפני רינדור הדוח. איסוף פיננסי, הנחות תחזית וחישובים מספריים נשארים נפרדים מנתיב נרטיב המודל שמוצג למטה. עבור מנפיק בינלאומי בדקו את כיסוי הבורסה של ספק הנתונים, מטבע הדיווח ובסיס החשבונאות לפני השוואת תוצאות. פתרו במפורש ספירת מניות, תקופות כספיות וכל המרת מטבע. הפעילו רק את השלבים הדרושים בזמן הכנת חבילת דוח ראשונה שניתנת לבדיקה.

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

שמרו על חישובים פיננסיים שניתנים לשחזור

ארכיטקטורת desktop הנוכחית מפרידה במפורש חישוב פיננסי מהסבר LLM. החילו את אותו עיקרון בקבלת כל artifact של FinRobot: עקבו אחר מספר מוצג אל קלטי המקור, יחידות, הנחות והחישוב שיצר אותו. הערכת שווי דטרמיניסטית עדיין תלויה בתחזיות לא ודאיות; שחזוריות אינה הוכחה שהתחזיות יתגשמו. שמרו הנחות בסיס ותרחישים חלופיים נפרדים, שימרו נוסחאות ובקשו מהמודל לדון ברגישויות במקום לבחור בשקט ערך יעד. דרשו שקלטים חסרים יישארו חסרים עד שבודק יספק הנחה מורשית.

התייחסו ל-notebooks הישנות של AutoGen כהגירה נפרדת

הקובץ הקיים finrobot/agents/workflow.py מייבא AutoGen ומקבל llm_config. notebooks ישנות טוענות רשומות מודל דרך OAI_CONFIG_LIST ומעבירות רשימת תצורה ל-workflow הזה. אם אתם מתחזקים את הנתיב הזה, עקבו יחד אחר ה-notebook וגרסת התלויות. אל תעתיקו אליו תצורת PydanticAI מודרנית ואל תתארו OAI_CONFIG_LIST כהגדרת FinRobot אוניברסלית. הגירת תהליך דוחות קיים דורשת בדיקת כלים, טעינת מפתחות נתונים, התנהגות ביצוע קוד ויצירת דוח, לא רק החלפת base URL.

אמתו דוח אחד מקלט ועד מאתר מקור

התחילו בחבילת filing ציבורית מוגבלת ובשאלה צרה. לאחר בדיקת לקוח שאושרה בנפרד אמתו כלי נתונים נדרש אחד, חישוב מספרי אחד וקטע דוח אחד עם ציטוטים. תעדו revision יישום, hashes של מקור, תצורה ללא סודות, ID מודל שנפתר ו-usage שנצפה. בדקו שטקסט שנוצר שומר יחידות ומבחין בין עובדות מדווחות לתחזיות. תשובת hello של תעבורה או תגובת factory מוכיחות רק את השלב הזה. קבלת דוח מלא דורשת בנוסף שלמות נתונים, בדיקת חישוב, פלט קריא וטענות שניתנות לעקיבה.

תקצבו ושחזרו בגבולות שלבים

הפרידו חיובי נתונים פיננסיים, בקשות מודל, משאבי רינדור דוח ובדיקת אנליסט. השתמשו במחירים נוכחיים לאומדן ואז התאימו את יומן הבקשות, כולל ניסיונות חוזרים וכשלים. אם שדה API מתעלמים ממנו, בדקו את סקריפט הכניסה המדויק לפני הוספת קובצי תצורה. אם דוח ריק, בדקו יומני איסוף ופענוח לפני שינוי מודל. כאשר קלטים מספריים סותרים, עצרו את הדוח לבדיקה ושמרו את שני ערכי המקור. המשיכו מהשלב שתוקן כדי שהדוח שהושלם ישמר את הסיבה לכל שינוי.

ראיות ומגבלות

תיעוד המקור וה-release נבדק ב-5 בספטמבר 2026. שדות endpoint של Pro והעברתם אושרו ב-d2219100; נתיב gateway מותאם של desktop עדיין לא אומת. עבור מדריך זה לא בוצעו בקשת APIsRouter, דוח מלא או מקרה שימוש שנמדד. דוגמאות Pro חלות על הסקריפטים ששמם נקוב, לא על desktop או על כל notebook ישנה.

שאלות נפוצות