Guía de versión y API personalizada de FinRobot

Identifica qué FinRobot estás ejecutando

El README oficial revisado en d2219100 el 5 de septiembre de 2026 describe FinRobot Desktop v0.1.0 con PydanticAI, FastAPI y React/Tauri. También conserva un flujo finrobot_equity Pro y tutoriales AutoGen antiguos. No son superficies de configuración intercambiables. La versión de escritorio está etiquetada como desktop-v0.1.0 en 6a8161ff; la instantánea master es una identidad de fuente separada. Registra la versión o commit real, el comando de entrada y el archivo de configuración. La presencia de instrucciones OAI_CONFIG_LIST heredadas en el mismo repositorio no demuestra cómo carga modelos la aplicación de escritorio.

Compara las rutas de aplicación documentadas

Trata la selección de versión como la primera comprobación de compatibilidad. La documentación de escritorio describe la orquestación, funciones especializadas de investigación y cálculo financiero determinista, pero esta revisión no estableció su ruta de endpoint personalizado de APIsRouter. El script Pro y los agentes Python heredados exponen ajustes visibles distintos. Una solicitud correcta en uno no puede certificar los otros. Revisa también las notas oficiales de plataforma y firma del escritorio antes de instalar; no eludas las comprobaciones de seguridad del sistema operativo solo para completar un tutorial de integración.

Usa los campos de endpoint Pro solo para el script Pro

El archivo actual finrobot_equity/core/config/config.ini.example incluye openai_api_key, openai_base_url y openai_model. generate_financial_analysis.py lee la URL base y el modelo opcionales y los reenvía a su ruta de generación de texto. La plantilla de abajo adapta esos campos verificados; sustituye localmente los placeholders en mayúsculas. Este archivo INI no implica interpolación de variables de entorno. Protege el archivo real con permisos locales, exclúyelo del control de versiones y evita publicarlo en logs de soporte. La clave de datos financieros sigue siendo independiente de la credencial del modelo.

[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

Ejecuta la ruta de generación de texto Pro con entradas explícitas

Usa el script de análisis Pro con la identidad de tu empresa y el archivo de configuración protegido y revisa después el análisis generado antes de renderizar el informe. La adquisición financiera, los supuestos de previsión y los cálculos numéricos siguen separados de la ruta de narración del modelo que aparece abajo. Para un emisor internacional, comprueba la cobertura de la bolsa, la moneda de información y la base contable del proveedor de datos antes de comparar resultados. Resuelve explícitamente las cantidades de acciones, los periodos fiscales y cualquier conversión de moneda. Ejecuta solo las etapas necesarias mientras estableces el primer paquete de informe inspeccionable.

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

Mantén reproducibles los cálculos financieros

La arquitectura de escritorio actual separa explícitamente el cálculo financiero de la explicación del LLM. Aplica el mismo principio de aceptación al revisar cualquier artefacto de FinRobot: rastrea cada número mostrado hasta las entradas de origen, las unidades, los supuestos y el cálculo que lo produjo. Una valoración determinista todavía depende de previsiones inciertas; la reproducibilidad no demuestra que esas previsiones vayan a cumplirse. Mantén separados los supuestos base y los escenarios alternativos, conserva las fórmulas y pide al modelo que analice sensibilidades en lugar de seleccionar silenciosamente un valor objetivo. Exige que las entradas ausentes sigan ausentes hasta que un revisor proporcione un supuesto autorizado.

Trata los notebooks AutoGen heredados como una migración separada

El archivo conservado finrobot/agents/workflow.py importa AutoGen y acepta llm_config. Los tutoriales heredados cargan entradas de modelo mediante OAI_CONFIG_LIST y pasan una lista de configuración a ese flujo. Sigue juntos el notebook y la versión de dependencias si mantienes esta ruta. No trasplantes una configuración PydanticAI moderna ni describas OAI_CONFIG_LIST como un ajuste universal de FinRobot. Migrar un proceso de informes existente requiere comprobar sus herramientas, la carga de claves de datos, el comportamiento de ejecución de código y la generación del informe, no solo sustituir una URL base.

Valida un informe desde la entrada hasta el localizador de fuente

Empieza con un paquete acotado de informes públicos y una pregunta estrecha. Después de una prueba autorizada del cliente por separado, valida una herramienta de datos necesaria, un cálculo numérico y una sección de informe con citas. Registra la revisión de la aplicación, los hashes de fuente, la configuración sin secretos, el ID de modelo resuelto y el uso observado. Comprueba que el texto generado conserve las unidades y distinga los datos comunicados de las proyecciones. Un saludo del transporte o una respuesta de la fábrica de modelos demuestra solo esa etapa. La aceptación del informe completo necesita además datos completos, revisión del cálculo, salida legible y afirmaciones trazables.

Presupuesta y recupera en los límites de cada etapa

Separa los cargos de datos financieros, las solicitudes al modelo, los recursos de renderizado del informe y la revisión del analista. Usa los precios actuales para una estimación y concilia después el registro de solicitudes, incluidos reintentos y fallos. Si se ignora un campo de API, inspecciona el script de entrada concreto antes de añadir más archivos de configuración. Si un informe está vacío, inspecciona los logs de adquisición y análisis antes de cambiar el modelo. Cuando las entradas numéricas entren en conflicto, pausa el informe para revisión y conserva ambos valores de fuente. Reanuda desde la etapa corregida para que el informe completado conserve el motivo de cada cambio.

Evidencia y limitaciones

La documentación de fuente y versión se revisó el 5 de septiembre de 2026. Los campos de endpoint Pro y su reenvío están confirmados en d2219100; la ruta de gateway personalizado de Desktop sigue sin verificarse. Para esta guía no se ejecutaron una solicitud de APIsRouter, un informe completo ni un caso de uso medido. Los ejemplos Pro se aplican a los scripts nombrados, no al escritorio ni a todos los notebooks heredados.

Preguntas frecuentes