graph TD %%{init: {'theme': 'mc','layout': 'elk'}}%% Prompt-sistq[<div><img alt="logo" src="/_astro/square-terminal.BMOXc-nZ.svg" style="height: 20px !important;width: 20px !important"/></div>Prompt] style Prompt-sistq stroke:#a170ff ChatInput-s9apd[<div><img alt="logo" src="/_astro/messages-square.BaSDmT6g.svg" style="height: 20px !important;width: 20px !important"/></div>Entrada de Usuario] style ChatInput-s9apd stroke:#a170ff Prompt-3ogxb[<div><img alt="logo" src="/_astro/square-terminal.BMOXc-nZ.svg" style="height: 20px !important;width: 20px !important"/></div>Prompt] style Prompt-3ogxb stroke:#a170ff OpenAIModel-kp0l0[<div><img alt="logo" src="/_astro/openAI.BhmuxEs3.svg" style="height: 20px !important;width: 20px !important"/></div>Analizador de Intención] style OpenAIModel-kp0l0 stroke:#a170ff OpenAIModel-712yx[<div><img alt="logo" src="/_astro/openAI.BhmuxEs3.svg" style="height: 20px !important;width: 20px !important"/></div>Generador de Respuesta] style OpenAIModel-712yx stroke:#a170ff Prompt-3y0vr[<div><img alt="logo" src="/_astro/square-terminal.BMOXc-nZ.svg" style="height: 20px !important;width: 20px !important"/></div>Constructor de Respuesta Final] style Prompt-3y0vr stroke:#a170ff ChatOutput-up1u4[<div><img alt="logo" src="/_astro/messages-square.BaSDmT6g.svg" style="height: 20px !important;width: 20px !important"/></div>Chat Output] style ChatOutput-up1u4 stroke:#a170ff OpenAIModel-o282l[<div><img alt="logo" src="/_astro/openAI.BhmuxEs3.svg" style="height: 20px !important;width: 20px !important"/></div>OpenAI] style OpenAIModel-o282l stroke:#a170ff YFinanceToolComponent-zoqeh[<div><img alt="logo" src="/_astro/badge-euro.b_yZ5I36.svg" style="height: 20px !important;width: 20px !important"/></div>YFinance Tool] style YFinanceToolComponent-zoqeh stroke:#a170ff AdvancedAgent-n79by[Agent] style AdvancedAgent-n79by stroke:#a170ff OpenAIModel-712yx -.- ChatOutput-up1u4 linkStyle 0 stroke:#a170ff Prompt-3y0vr -.- OpenAIModel-712yx linkStyle 1 stroke:#a170ff Prompt-sistq -.- OpenAIModel-kp0l0 linkStyle 2 stroke:#a170ff ChatInput-s9apd -.- Prompt-sistq linkStyle 3 stroke:#a170ff ChatInput-s9apd -.- Prompt-3y0vr linkStyle 4 stroke:#a170ff OpenAIModel-kp0l0 -.- Prompt-3ogxb linkStyle 5 stroke:#a170ff AdvancedAgent-n79by -.- Prompt-3y0vr linkStyle 6 stroke:#a170ff Prompt-3ogxb -.- AdvancedAgent-n79by linkStyle 7 stroke:#a170ff YFinanceToolComponent-zoqeh -.- AdvancedAgent-n79by linkStyle 8 stroke:#a170ff OpenAIModel-o282l -.- AdvancedAgent-n79by linkStyle 9 stroke:#a170ff

📄 Consultas de estoque – Documentação Técnica

🧩 Descrição Geral

O fluxo automatiza a consulta de preços e informações de ações no Yahoo Finance. Quando o usuário faz uma pergunta sobre um ativo, o sistema extrai o ticker, obtém dados atualizados, analisa a solicitação e gera uma resposta estruturada e contextualizada, tudo em tempo real.

⚙️ Funcionalidades Principais

Extração automática de tickers a partir de mensagens de usuários.
Detecção de intenção para identificar o objetivo da consulta (preço, notícias, histórico, etc.).
Integração com a API do Yahoo Finance para obter dados de mercado em tempo real.
Roteamento inteligente de solicitações usando um agente avançado que decide qual ferramenta usar.
Geração de resposta final em linguagem natural, incorporando dados contextuais.
Entrega em chat em formato legível, mantendo a mesma sessão de conversa.

🔄 Passos do Fluxo de Trabalho

Nome do Componente	Papel no Fluxo	Entradas Principais	Saídas Principais
Entrada de Usuário	Recebe a mensagem inicial do usuário.	Mensagem textual + metadados de sessão.	Mensagem com texto do usuário.
Prompt de Extração de Tickers	Constrói o prompt que extrai os tickers do texto do usuário.	Mensagem do usuário.	Lista de tickers identificados.
Analizador de Intenção	Processa a lista de tickers para determinar a intenção da consulta.	Texto gerado pelo Prompt de Extração de Tickers.	Resumo de intenção + lista de tickers.
Prompt de Configuração do Agente	Gera instruções para o agente, indicando quais dados buscar.	Lista de tickers.	Prompt de instruções para o agente.
Agente Especialista em Finanças	Roteia a solicitação, seleciona ferramentas e controla iterações.	Prompt de instruções + lista de tickers.	Resposta contendo dados financeiros extraídos.
Ferramenta Yahoo Finance	Busca informações de mercado (preço, notícias, histórico).	Ticker e tipo de informação solicitada.	Dados estruturados de mercado.
Construtor de Resposta Final	Formata a resposta final combinando dados e tarefa do usuário.	Dados financeiros + tarefa do usuário.	Prompt completo para geração de resposta.
Gerador de Resposta	Executa o modelo LLM para produzir a mensagem de retorno.	Prompt completo.	Mensagem de resposta em linguagem natural.
Saída de Chat	Exibe a mensagem final ao usuário, mantendo o contexto da conversa.	Mensagem de resposta.	Mensagem entregue ao usuário.

🧠 Notas

O agente utiliza o modelo gpt‑4o como motor de linguagem; outros modelos podem ser substituídos sem alterar a lógica de fluxo.
A ferramenta Yahoo Finance requer apenas o símbolo da ação; o número de notícias pode ser configurado, mas por padrão retorna 5 itens.
O fluxo pode ser adaptado para múltiplos tickers em uma única consulta, pois a extração de tickers suporta listas.
Todos os dados retornados pela ferramenta são tratados em formato JSON e incorporados ao prompt final.
O agente está configurado para não usar memória persistente (use_checkpointer: false), mantendo um estado leve entre iterações.
O fluxo é completamente independente de IDs internos; os nomes dos componentes são extraídos da propriedade name ou derivados do id quando necessário.