Руководство по версии FinRobot и собственному API

Определите, какой FinRobot вы запускаете

Официальный README, проверенный на d2219100 5 сентября 2026 года, описывает FinRobot Desktop v0.1.0 на PydanticAI, FastAPI и React/Tauri. В нём также сохраняются рабочий процесс finrobot_equity Pro и старые учебные материалы AutoGen. Это разные поверхности конфигурации. Desktop-релиз помечен desktop-v0.1.0 на 6a8161ff; snapshot master — отдельная идентичность источника. Запишите фактический релиз или 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 и передаёт их в путь генерации текста. Следующий шаблон адаптирует проверенные поля; замените заглавные placeholders локально. Этот 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

Сохраняйте воспроизводимость финансовых вычислений

Текущая архитектура desktop явно отделяет финансовые вычисления от объяснения LLM. Применяйте тот же принцип при проверке любого артефакта FinRobot: связывайте отображаемое число с исходными входами, единицами, допущениями и расчётом, который его создал. Детерминированная оценка всё ещё зависит от неопределённых прогнозов; воспроизводимость не доказывает, что эти прогнозы сбудутся. Разделяйте базовые допущения и альтернативные сценарии, сохраняйте формулы и просите модель обсуждать чувствительность, а не молча выбирать целевое значение. Требуйте, чтобы отсутствующие входы оставались отсутствующими, пока проверяющий не внесёт авторизованное допущение.

Рассматривайте старые notebook AutoGen как отдельную миграцию

Сохранившийся finrobot/agents/workflow.py импортирует AutoGen и принимает llm_config. Старые notebook загружают записи моделей через OAI_CONFIG_LIST и передают список конфигурации в этот workflow. Если поддерживаете этот путь, связывайте notebook и версию зависимостей. Не переносите в него современную конфигурацию PydanticAI и не описывайте OAI_CONFIG_LIST как универсальную настройку FinRobot. Миграция существующего процесса отчётов требует проверки инструментов, загрузки ключей данных, поведения выполнения кода и генерации отчёта, а не только замены base URL.

Проверьте один отчёт от входа до локатора источника

Начните с ограниченного пакета публичных filings и узкого вопроса. После отдельно авторизованного теста клиента проверьте один нужный инструмент данных, один численный расчёт и один раздел отчёта с цитатами. Запишите revision приложения, хэши источников, конфигурацию без секретов, разрешённый ID модели и наблюдаемое usage. Проверьте, что созданный текст сохраняет единицы и различает факты и прогнозы. Ответ транспорта hello или результат factory подтверждает только этот этап. Приёмка полного отчёта дополнительно требует полноты данных, проверки расчётов, читабельного вывода и прослеживаемых утверждений.

Планируйте бюджет и восстанавливайте работу по границам этапов

Разделяйте расходы финансовых данных, запросы модели, ресурсы рендеринга отчёта и проверку аналитика. Используйте текущие цены для оценки, затем сверяйте журнал запросов, включая повторы и ошибки. Если поле API игнорируется, сначала проверьте точный скрипт входа, прежде чем добавлять новые файлы конфигурации. Если отчёт пуст, изучите журналы получения и разбора до смены модели. Когда численные вводные расходятся, приостановите отчёт для проверки и сохраните оба исходных значения. Продолжайте с исправленного этапа, чтобы готовый отчёт сохранял причину каждого изменения.

Свидетельства и ограничения

Документация источников и релизов была проверена 5 сентября 2026 года. Поля endpoint Pro и их передача подтверждены в d2219100; собственный путь gateway desktop остаётся непроверенным. Для этого руководства не выполнялись запрос APIsRouter, полный отчёт или измеренный пример использования. Примеры Pro относятся к названным скриптам, а не к desktop или каждой старой notebook.

Частые вопросы