Guia de versão e API personalizada do FinRobot

Identifique qual FinRobot você está executando

O README oficial revisado em d2219100 em 5 de setembro de 2026 descreve o FinRobot Desktop v0.1.0 com PydanticAI, FastAPI e React/Tauri. Ele também mantém um fluxo finrobot_equity Pro e tutoriais AutoGen mais antigos. Essas superfícies de configuração não são intercambiáveis. A versão desktop está marcada como desktop-v0.1.0 em 6a8161ff; o snapshot master é uma identidade de fonte separada. Registre a release ou commit real, o comando de entrada e o arquivo de configuração. A presença de instruções OAI_CONFIG_LIST legadas no mesmo repositório não estabelece como a aplicação desktop carrega modelos.

Compare os caminhos de aplicação documentados

Trate a seleção de versão como a primeira verificação de compatibilidade. A documentação desktop descreve orquestração, papéis especializados de pesquisa e computação financeira determinística, mas esta revisão não estabeleceu seu caminho de endpoint personalizado da APIsRouter. O script Pro e os agentes Python legados expõem configurações diferentes visíveis na fonte. Uma solicitação bem-sucedida por um caminho não certifica os outros. Revise também as notas oficiais de plataforma e assinatura desktop antes da instalação; não ignore verificações de segurança do sistema operacional apenas para concluir um tutorial de integração.

Use campos de endpoint Pro somente no script Pro

O arquivo atual finrobot_equity/core/config/config.ini.example inclui openai_api_key, openai_base_url e openai_model. generate_financial_analysis.py lê base URL e modelo opcionais e os encaminha ao caminho de geração de texto. O template abaixo adapta esses campos verificados; substitua os placeholders em maiúsculas localmente. Este arquivo INI não implica interpolação de variáveis de ambiente. Proteja o arquivo real com permissões locais, exclua-o do controle de versão e evite publicá-lo em logs de suporte. A chave de dados financeiros continua independente da credencial do 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

Execute o caminho de geração de texto Pro com entradas explícitas

Use o script de análise Pro com a identidade da sua empresa e um arquivo de configuração protegido e depois inspecione a análise gerada antes da renderização do relatório. Aquisição financeira, premissas de previsão e cálculos numéricos permanecem separadas da rota de narrativa do modelo mostrada abaixo. Para um emissor internacional, confira cobertura da bolsa, moeda de apresentação e base contábil do provedor de dados antes de comparar resultados. Resolva explicitamente quantidade de ações, períodos fiscais e qualquer conversão de moeda. Execute apenas as etapas necessárias ao estabelecer o primeiro pacote de relatório inspecionável.

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

Mantenha cálculos financeiros reproduzíveis

A arquitetura desktop atual separa explicitamente computação financeira da explicação por LLM. Aplique o mesmo princípio de aceitação ao revisar qualquer artefato FinRobot: rastreie um número exibido até as entradas da fonte, unidades, premissas e cálculo que o produziu. Uma avaliação determinística ainda depende de previsões incertas; reprodutibilidade não prova que essas previsões se confirmarão. Mantenha premissas básicas e cenários alternativos distintos, preserve as fórmulas e faça o modelo discutir sensibilidades em vez de escolher silenciosamente um valor-alvo. Exija que entradas ausentes continuem ausentes até que um revisor forneça uma premissa autorizada.

Trate notebooks AutoGen legados como uma migração separada

O finrobot/agents/workflow.py mantido importa AutoGen e aceita llm_config. Tutoriais legados carregam entradas de modelo por OAI_CONFIG_LIST e passam uma lista de configuração a esse fluxo. Se mantiver esse caminho, siga juntos notebook e versão das dependências. Não transplante uma configuração PydanticAI moderna para ele nem descreva OAI_CONFIG_LIST como configuração universal do FinRobot. Migrar um processo de relatórios existente exige verificar ferramentas, carregamento da chave de dados, comportamento de execução de código e geração do relatório, não apenas trocar uma base URL.

Valide um relatório da entrada ao localizador da fonte

Comece com um pacote delimitado de documentos públicos e uma pergunta estreita. Depois de um teste de cliente autorizado separadamente, valide uma ferramenta de dados necessária, um cálculo numérico e uma seção do relatório com citações. Registre revisão da aplicação, hashes das fontes, configuração sem segredos, ID do modelo resolvido e uso observado. Confira se o texto gerado preserva unidades e diferencia fatos reportados de projeções. Um hello do transporte ou resposta da fábrica de modelos prova somente essa etapa. A aceitação do relatório completo também exige completude dos dados, revisão dos cálculos, saída legível e alegações rastreáveis.

Faça orçamento e recupere nas fronteiras das etapas

Separe cobranças de dados financeiros, solicitações de modelo, recursos de renderização do relatório e revisão do analista. Use preços atuais para uma estimativa e depois reconcilie o registro de solicitações, incluindo tentativas e falhas. Se um campo da API for ignorado, inspecione o script de entrada exato antes de adicionar mais arquivos de configuração. Se um relatório estiver vazio, inspecione logs de aquisição e parsing antes de mudar o modelo. Quando entradas numéricas entrarem em conflito, pause o relatório para revisão e preserve os dois valores da fonte. Retome da etapa corrigida para que o relatório concluído preserve o motivo de cada mudança.

Evidências e limitações

Documentação de fonte e release foi revisada em 5 de setembro de 2026. Campos de endpoint Pro e seu encaminhamento são confirmados em d2219100; o caminho de gateway personalizado do desktop continua sem verificação. Nenhuma solicitação da APIsRouter, relatório completo ou caso de uso medido foi executado para este guia. Os exemplos Pro aplicam-se aos scripts nomeados, não ao desktop nem a todos os notebooks legados.

Perguntas frequentes