Посібник із версій і користувацького API FinRobot

Визначте, який FinRobot ви запускаєте

Офіційний README, перевірений у d2219100 5 вересня 2026 року, описує FinRobot Desktop v0.1.0 на PydanticAI, FastAPI та React/Tauri. Він також зберігає Pro-процес finrobot_equity і старі посібники AutoGen. Це не взаємозамінні поверхні конфігурації. Настільний випуск позначено desktop-v0.1.0 у 6a8161ff; знімок master є окремою ідентичністю джерела. Запишіть фактичний випуск або коміт, команду входу й файл конфігурації. Наявність інструкцій OAI_CONFIG_LIST зі старого процесу в тому самому репозиторії не встановлює, як настільна програма завантажує моделі.

Порівняйте документовані шляхи програм

Розглядайте вибір версії як першу перевірку сумісності. Документація робочого столу описує оркестрацію, спеціалізовані дослідницькі ролі та детерміновані фінансові обчислення, але ця перевірка не встановила шлях користувацької кінцевої точки APIsRouter. Pro-скрипт і застарілі агенти Python мають різні видимі з джерела налаштування. Успішний запит через один не сертифікує інші. Перед установленням також перегляньте офіційні нотатки про платформу та підписування робочого столу; не обходьте перевірки безпеки операційної системи лише для завершення посібника інтеграції.

Використовуйте поля кінцевої точки Pro лише для скрипту Pro

Поточний finrobot_equity/core/config/config.ini.example містить openai_api_key, openai_base_url і openai_model. generate_financial_analysis.py читає необов’язкові базові URL і модель та передає їх до шляху генерації тексту. Наведений нижче шаблон адаптує ці перевірені поля; замініть заповнювачі у верхньому регістрі локально. Цей INI-файл не означає інтерполяцію змінних середовища. Захистіть реальний файл локальними дозволами, виключіть його з контролю версій і не публікуйте в журналах підтримки. Ключ фінансових даних залишається незалежним від облікових даних моделі.

[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

Зберігайте фінансові розрахунки відтворюваними

Поточна архітектура робочого столу явно відокремлює фінансові обчислення від пояснення LLM. Застосовуйте той самий принцип прийняття під час перевірки будь-якого артефакту FinRobot: простежуйте показане число до входів джерела, одиниць, припущень і розрахунку, що його створив. Детермінована оцінка все одно залежить від невизначених прогнозів; відтворюваність не доводить, що ці прогнози справдяться. Тримайте базові припущення й альтернативні сценарії окремо, зберігайте формули та просіть модель обговорювати чутливість, а не мовчки обирати цільове значення. Вимагайте, щоб відсутні входи залишалися відсутніми, доки рецензент не надасть авторизоване припущення.

Розглядайте застарілі ноутбуки AutoGen як окрему міграцію

Збережений finrobot/agents/workflow.py імпортує AutoGen і приймає llm_config. Застарілі посібники завантажують записи моделей через OAI_CONFIG_LIST і передають список конфігурації до цього процесу. Якщо підтримуєте цей шлях, узгоджуйте ноутбук і версію залежностей. Не переносіть у нього сучасну конфігурацію PydanticAI й не описуйте OAI_CONFIG_LIST як універсальний параметр FinRobot. Міграція наявного процесу звіту потребує перевірки його інструментів, завантаження ключа даних, поведінки виконання коду та генерації звіту, а не лише заміни базового URL.

Перевірте один звіт від входу до локатора джерела

Почніть з обмеженого пакета публічних подань і вузького питання. Після окремо авторизованого тесту клієнта перевірте один потрібний інструмент даних, один числовий розрахунок і один розділ звіту з цитатами. Запишіть ревізію програми, хеші джерел, конфігурацію без секретів, розв’язаний ID моделі та спостережуване використання. Перевірте, що згенерований текст зберігає одиниці й розрізняє заявлені факти та прогнози. Привітання транспорту або відповідь фабрики моделі доводять лише цей етап. Прийняття повного звіту додатково потребує повноти даних, перевірки розрахунків, читабельного результату й відстежуваних тверджень.

Плануйте бюджет і відновлюйтеся на межах етапів

Розділяйте списання фінансових даних, запити моделі, ресурси рендерингу звіту та перевірку аналітика. Для оцінки використовуйте актуальні тарифи, а потім узгодьте журнал запитів, включно з повторами й збоями. Якщо поле API ігнорується, перевірте точний скрипт входу до додавання інших файлів конфігурації. Якщо звіт порожній, перевірте журнали отримання та розбору до зміни моделі. Коли числові входи конфліктують, призупиніть звіт для перевірки та збережіть обидва значення джерела. Продовжуйте з виправленого етапу, щоб завершений звіт зберігав причину кожної зміни.

Докази та обмеження

Документацію джерела та випуску перевірено 5 вересня 2026 року. Поля кінцевої точки Pro та їх пересилання підтверджені в d2219100; користувацький шлях шлюзу Desktop залишається неперевіреним. Для цього посібника не виконувалися запит APIsRouter, повний звіт або виміряний кейс використання. Приклади Pro застосовуються до названих скриптів, а не до Desktop чи кожного застарілого ноутбука.

Поширені запитання