OnePro AI

Análise completa de uma ou mais carteiras (salvas ou montadas na conversa): retorno histórico, risco, drawdown e comparação com até 5 benchmarks na mesma chamada, como o seletor múltiplo da tela (com 'portfolios' e sem benchmarks, entram CDI e IBOV, o default da tela; montando as linhas em 'carteiras', entra só o que você pedir). Portfólio salvo é medido por padrão pela IMPLEMENTAÇÃO (produtos e taxas reais — o número da tela; base='classes' mede a alocação-alvo), com a base declarada em base_da_analise; produto com índice e menos de 120 meses de série é estendido pelo índice, descontada a taxa (a regra da tela, declarada em complementacao), e a janela_efetiva nomeia o ativo limitante. É a tool principal para "analise minha carteira" e a área Comparativo do app (Análise › Comparativo): "Ranking de Portfolios", "Consistência de Retorno — 10 Anos", "Recuperação dos Portfólios" e "Janelas Móveis" com a tabela de vitórias abaixo dela. 'carteiras' reproduz o montador da tela: até 10 linhas, cada uma um portfólio salvo ou itens {ticker, peso}, e cada item produto OU índice do catálogo — um índice sozinho a 100% É o índice, sem taxa, como a tela faz: "compare o MSCI USA Small Cap, minha carteira salva e o VOO" é uma chamada só. Use visao="ranking" para ordenar várias carteiras, "consistencia" para janelas de 10 anos, "sequencias_negativas" para os piores períodos e "janelas_moveis" para "em quantas janelas de N anos a carteira superou o CDI": o retorno de cada janela é o ACUMULADO do período, NUNCA anualizado — não compare esses % com CAGR. A "Correlação 5 anos móveis" NÃO está no conector — diga isso se ele pedir. Para reproduzir a aba Comportamento de UMA carteira use onepro_comportamento: esta compara carteiras entre si; aquela reproduz a tela, ativo a ativo. Resultados em termos nominais na moeda pedida, janela informada em janela_efetiva — cite-a. Não otimiza pesos (use onepro_otimizacao) nem projeta o futuro (onepro_prospectivo, onepro_plano_retirada).

Busca ativos e índices por ticker ou trecho do nome no catálogo do OnePro (ETFs BR e globais, ações, BDRs, FIIs, fundos, debêntures, renda fixa, índices). Use PRIMEIRO sempre que o usuário citar um ativo por nome ou ticker incerto — as demais tools exigem o identificador exato retornado aqui (ticker; slug para RF pública; ISIN para RF privada). A busca é por texto (substring), não semântica: prefira o ticker ou um trecho único do nome ("IVVB", "Ibovespa"); descrições genéricas ("ETF de S&P 500 da BlackRock") não encontram nada. Não retorna preços nem retornos (use onepro_ficha_ativo).

Calculadoras determinísticas de acumulação, sem carteira: que retorno anual preciso para chegar à meta (retorno_necessario), quanto terei (patrimonio_alvo), quanto aportar (aporte_necessario) e se um plano fecha (verificar_plano) — tudo em termos REAIS (R$ de hoje e % a.a. acima da inflação). São as abas de Análise › Aportes do app: retorno necessário, patrimônio alvo e sucesso aposentadoria (esta parte da renda mensal alvo — converta em meta de patrimônio antes). A quarta aba, TWRR x MWRR, NÃO está no conector: só existe no site. Use para contas rápidas de planejamento; para probabilidade com uma carteira concreta use onepro_gbi, e para simular a aposentadoria (retiradas), onepro_plano_retirada. Cada cálculo exige campos próprios — o erro diz exatamente o que falta.

Analisa o histórico de 1 ativo ou compara 2 a 10 no mesmo período e moeda: retorno anualizado, volatilidade, Sharpe, drawdown máximo e correlação. Use para "qual foi melhor", "quão correlacionados são", "qual caiu mais" ou análise de risco de um único ativo. Para medir os ativos contra um índice (IBOV, IDIV, CDI, IFIX, IMA-B, S&P 500…), passe a sigla em benchmarks — índice não é produto e não entra em tickers. A resposta informa a janela efetivamente usada (janela_efetiva) — cite-a. Não projeta o futuro (para simulação use os motores, ex.: onepro_plano_retirada). incluir_overlap=true acrescenta as posições em comum entre ETFs. incluir_janelas_moveis=true responde o gráfico "Janelas Móveis" do comparador e da página do ativo — em quantas janelas de 1, 3, 5, 10, 15 e 20 anos cada ativo ficou acima dos outros e dos benchmarks —, com o retorno de cada janela em ACUMULADO do período, NUNCA anualizado: não compare esses % com CAGR. Para o mesmo gráfico de CARTEIRAS use onepro_analise_portfolio (visao="janelas_moveis"), que também devolve a série mês a mês.

Reproduz a aba Comportamento do OnePro (Análise › Asset Allocation › Comportamento) para uma carteira: métricas completas (retorno, CAGR real, volatilidade, Sharpe, Sortino, Ulcer, melhor/pior ano, maior queda e tempo de recuperação), retorno ano a ano, rentabilidade suavizada, drawdown, correlação, as quedas intra-ano (por ano, o retorno do ano ao lado do pior mês dele) e as janelas móveis — os mesmos números que o assinante vê no app. Analisa EXATAMENTE os pesos informados, sem otimizar (para otimizar use onepro_otimizacao e passe os pesos dela como 'carteira'). Portfólio salvo é medido por padrão pela IMPLEMENTAÇÃO (os produtos que o assinante carrega, taxas reais — a mesma carteira de onepro_analise_portfolio); base='classes' mede a alocação-alvo por índice. base_da_analise declara a base em TODA visão e sub-aba, e a complementação automática da tela (produto com índice e menos de 120 meses é estendido, descontada a taxa) sai no bloco complementacao. Use quando o usuário citar a aba Comportamento ou um de seus gráficos ("Rentabilidade do Portfólio", "Rentabilidade Anual e Maior Declínio Intra-Ano", "Janelas Móveis", "Performance Frente aos Benchmarks", o rastreio); para comparar carteiras entre si e com benchmarks, e para ranking/consistência, a tool é onepro_analise_portfolio — esta reproduz a tela de UMA carteira. Escolha a visão em 'visao'; 'incluir' reproduz as sub-abas Ativos, Índices Econômicos (IPCA, CPI, CDI, dólar) e Rastreio (IBOV, CDI, TSM, TSMUS). visao='janelas_moveis' responde "em quantas janelas de N anos a carteira superou o CDI": o retorno de cada janela é o ACUMULADO do período, NUNCA anualizado — não compare com CAGR nem anualize por conta própria; para CAGR real por janela móvel use onepro_multiperiodo (aba Multi Período). A série mês a mês sai com response_format='detailed' e a janela escolhida em 'janela_anos'. A "Correlação 5 anos móveis" NÃO está no conector — diga isso se ele pedir. Confira a janela_efetiva.

Composição de um ETF, BDR ou FII: visão "resumo" traz agregados por setor, país e as 10 maiores posições; visão "posicoes" lista as posições individuais, paginadas. Use quando o usuário perguntar "o que o fundo X carrega". Para o caminho inverso ("quem carrega a ação Y"), use onepro_etfs_que_carregam. Não cobre fundos sem carteira divulgada (a resposta orienta a alternativa). ETFs de ETFs são decompostos: as posições efetivas (look-through) declaram o ETF de origem em via_etf.

Diagnóstico da conexão com o OnePro: status da assinatura, cotas de uso restantes e versão do snapshot de dados — o mesmo estado que o assinante vê em Configurações › OnePro AI no app. Use quando outra tool falhar de forma inesperada, quando o usuário perguntar "por que não funciona" ou para saber a data-base dos dados. Não retorna dados pessoais nem de carteira; conectar ou revogar um cliente de IA é feito no site, nessa mesma tela.

Lookup reverso de holdings: dado um ativo (ex.: NVDA, PETR4), lista os ETFs do catálogo que o carregam e com que peso, do maior para o menor. Use para "quais ETFs têm exposição a X" ou "quem carrega Y". Não responde a composição de um fundo (use onepro_composicao_ativo). Não cobre fundos sem carteira divulgada — um ativo pode estar em mais ETFs do que os listados.

Ficha completa de UM ativo de qualquer classe: identificação, custos, PL, retornos (1m/1a/3a/5a…), alocação e estrutura. Use quando o usuário quiser entender ou avaliar um ativo específico; para comparar dois ou mais, prefira onepro_comparar_ativos; para posições individuais da carteira do fundo, use onepro_composicao_ativo. Exige o identificador exato (resolva antes com onepro_buscar_ativos). Retornos vêm do snapshot mensal, na moeda pedida; o bloco complementacao diz se o histórico foi estendido pelo índice de referência do ativo.

Goal-based investing: probabilidade de a carteira atingir uma meta de patrimônio em um prazo, dado o patrimônio atual e aportes mensais (valores em R$ de hoje, resultado em termos REAIS — não aplique inflação por cima). É a aba Sucesso do portfólio do app (Análise › GBI): "Taxa de Sucesso", "Trajetórias Históricas vs. Meta", "Distribuição de Patrimônio Simulado vs. Meta" e os percentis por horizonte. Use para "chego a R$ X em N anos?". Portfólio salvo é medido por padrão pela IMPLEMENTAÇÃO (os produtos que o assinante carrega, taxas reais — a mesma carteira da tool âncora onepro_analise_portfolio); base='classes' mede a alocação-alvo por índice, e base_da_analise declara a base usada, a implementação e a parcela não implementada. Nessa base, produto com índice de referência e menos de 120 meses de série é estendido para trás pelo índice sem pedido, descontada a taxa — a regra da tela; o bloco complementacao declara o índice usado e os meses simulados. Se o usuário quiser o aporte ou retorno NECESSÁRIO para a meta (cálculo determinístico, sem carteira), use onepro_calculadora_aportes; para a distribuição completa sem meta, onepro_prospectivo. Seed determinística por snapshot: repetir a chamada dá o mesmo resultado. Confira janela_efetiva na resposta.