graph TD %%{init: {'theme': 'mc','layout': 'elk'}}%% ChatInput-im722[<div><img alt="logo" src="/_astro/messages-square.BaSDmT6g.svg" style="height: 20px !important;width: 20px !important"/></div>Chat Input] style ChatInput-im722 stroke:#a170ff ChatOutput-7h4uy[<div><img alt="logo" src="/_astro/messages-square.BaSDmT6g.svg" style="height: 20px !important;width: 20px !important"/></div>Chat Output] style ChatOutput-7h4uy stroke:#a170ff OpenAIModel-xyjkl[<div><img alt="logo" src="/_astro/openAI.BhmuxEs3.svg" style="height: 20px !important;width: 20px !important"/></div>OpenAI] style OpenAIModel-xyjkl stroke:#a170ff DeepResearchAgent-af1xa[Deep Research Agent] style DeepResearchAgent-af1xa stroke:#a170ff OpenAIWebSearchToolComponent-mezqb[<div><img alt="logo" src="/_astro/openAI.BhmuxEs3.svg" style="height: 20px !important;width: 20px !important"/></div>OpenAI Built-in tools] style OpenAIWebSearchToolComponent-mezqb stroke:#a170ff ChatInput-im722 -.- DeepResearchAgent-af1xa linkStyle 0 stroke:#a170ff DeepResearchAgent-af1xa -.- ChatOutput-7h4uy linkStyle 1 stroke:#a170ff OpenAIModel-xyjkl -.- DeepResearchAgent-af1xa linkStyle 2 stroke:#a170ff OpenAIWebSearchToolComponent-mezqb -.- DeepResearchAgent-af1xa linkStyle 3 stroke:#a170ff

Agente de Pesquisa Profunda

🧩 Descrição Geral

O fluxo Agente de Pesquisa Profunda automatiza o atendimento de consultas complexas, combinando planejamento estratégico, execução de buscas na web, análise de dados e síntese de resultados. Ele integra um modelo de linguagem OpenAI, uma ferramenta de busca web e um agente especializado que orquestra todas as etapas, entregando respostas detalhadas e estruturadas ao usuário.

⚙️ Funcionalidades Principais

Recebe a mensagem inicial do usuário via interface de chat.
Usa o modelo OpenAI para gerar a lógica de resposta e planejar ações.
Executa buscas na web com a ferramenta OpenAI Web Search, coletando informações relevantes.
O Agente de Pesquisa Profunda combina as respostas do modelo e das buscas, aplicando iteração e validação (Human‑in‑the‑Loop) quando necessário.
Exibe a resposta final ao usuário em formato de chat, mantendo consistência e clareza.

🔄 Passos do Fluxo de Trabalho

Nome do Componente	Papel no Fluxo	Entradas Principais	Saídas Principais
Entrada de Chat	Recebe a consulta do usuário	Mensagem enviada pelo usuário	Mensagem em formato interno
Modelo OpenAI	Fornece o modelo de linguagem usado pelo agente	Configurações do modelo (nome, temperatura, etc.)	Modelo de linguagem (LanguageModel)
Ferramenta Web Search	Realiza buscas na web e fornece dados	Texto de busca, modelo de linguagem, instruções	Dados de busca (Data)
Agente de Pesquisa Profunda	Planeja, executa, analisa e sintetiza a resposta	Mensagem de entrada, modelo de linguagem, ferramentas	Resposta em formato de mensagem
Saída de Chat	Exibe a resposta ao usuário	Mensagem gerada pelo agente	Mensagem de chat visível para o usuário

🧠 Notas

Dependência de API: é necessário fornecer uma chave válida da OpenAI para o modelo e a ferramenta.
Human‑in‑the‑Loop: o agente pode requerer aprovação humana antes de usar determinadas ferramentas, garantindo alinhamento com as intenções do usuário.
Saída Estruturada: opcionalmente, o agente pode retornar a resposta em formato JSON, conforme definido pelo schema configurado.
Memória: o agente pode habilitar memória para manter o contexto em conversas prolongadas.
Streaming: tanto o modelo quanto o agente suportam streaming, permitindo que o usuário veja a resposta enquanto ela é gerada.
Ferramentas: a ferramenta Web Search pode ser configurada para usar diferentes modelos de linguagem, adaptando a qualidade da resposta às necessidades do caso.

Esta documentação concentra‑se na funcionalidade e no fluxo de dados, omitindo detalhes de implementação interna e configurações de código.