1. Propósito e Escopo
Este documento define todos os prompts, configurações de memória, transição entre estados e demais requisitos funcionais para o Fluxo de Agentes "Análise de Risco em Carteiras de Investimento", uma solução de automação projetada para avaliar o risco associado a carteiras de investimento e fornecer sugestões de ajuste para otimização do portfólio. Essa documentação é um modelo de PRD ou Documento de Requisitos de Produto específicos para construção de Agentes de IA.
O objetivo principal é transformar o input de dados da carteira em análises detalhadas de risco e sugestões de ajustes, otimizando a gestão do portfólio de investimentos.
2. Contexto e Problema
Cenário Atual
A análise de risco em carteiras de investimento é complexa e demorada, especialmente em carteiras diversificadas que exigem ajustes frequentes para otimização. Os investidores encontram dificuldades em acompanhar as mudanças de mercado e ajustar seus portfólios de forma eficiente e em tempo hábil.
Problemas Identificados
- Avaliação Complexa: O processo de avaliação de risco é demorado e requer análise detalhada de múltiplos ativos financeiros.
- Necessidade de Ajustes Frequentes: As carteiras precisam ser ajustadas regularmente para otimizar o risco e retorno, o que pode ser desafiador sem ferramentas automatizadas.
- Monitoramento Contínuo: A falta de monitoramento contínuo do risco e desempenho pode levar a decisões desatualizadas e menos informadas.
3. Impactos Esperados
A implementação deste fluxo de automação visa alcançar os seguintes resultados:
- Reduzir o tempo de avaliação de risco em pelo menos 50%.
- Melhorar a precisão das sugestões de ajuste de portfólio.
- Automatizar o monitoramento contínuo de risco e desempenho do portfólio.
4. Visão Geral da Solução
O agente de IA para análise de risco em carteiras de investimento processa dados da carteira, aplica regras de avaliação de risco e sugere ajustes de portfólio com base em mudanças de mercado e perfil do investidor. A seguir são detalhadas todas as regras de negócio e especificações funcionais necessárias para que esse agente atue como um assistente útil e autônomo na gestão de carteiras de investimento.
A solução consiste em um fluxo de automação composto por 3 agentes de IA. O processo inicia com a avaliação de risco da carteira e termina com o monitoramento contínuo do risco e desempenho do portfólio.
A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.
| Agentes | Função Principal |
|---|---|
Agente de Avaliação de Risco de Carteira (RF 1)
| Avaliar o risco associado a carteiras de investimento. |
Agente de Proposição de Ajustes de Portfólio (RF 2)
| Propor ajustes no portfólio de investimento para otimização. |
Agente de Monitoramento Contínuo de Risco (RF 3)
| Monitorar continuamente o risco e o desempenho do portfólio. |
5. Protótipos
Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos interativos que demonstram tanto o fluxo de trabalho dos agentes quanto o resultado final que o investidor receberá. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Avaliação de Risco de Carteira
1.1 Tarefa do Agente
Avaliar o risco associado a carteiras de investimento.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados da carteira de investimento, incluindo composição de ativos, peso de cada ativo e perfil do investidor.
# 2. Objetivo
Avaliar o risco associado a carteiras de investimento, gerando uma análise detalhada do perfil de risco da carteira.
# 3. Regras que você deve seguir para gerar sua resposta
- Analisar o perfil de risco de diferentes ativos financeiros com base em dados históricos de mercado e tendências atuais.
- Calcular indicadores de risco como volatilidade e beta para cada ativo, utilizando modelos estatísticos reconhecidos.
- Integrar os indicadores individuais para formar uma visão consolidada do risco da carteira, considerando a correlação entre ativos.
- Considerar o perfil do investidor ao analisar a tolerância ao risco, ajustando a análise conforme necessário, e documentar as justificativas para ajustes sugeridos.
# 4. Exemplo de Output que você deve produzir
{
"perfil_risco_carteira": "Moderado",
"indicadores": [
{
"ativo": "Ação A",
"volatilidade": 0.15,
"beta": 1.2
},
{
"ativo": "Ação B",
"volatilidade": 0.1,
"beta": 0.8
}
]
} 1.3 Configurações do Agente
1.3.1 Especificação do Input
- Mecanismo de Acionamento: Este agente é o ponto de partida do fluxo e deve ser acionado pelo envio de dados da carteira de investimento via API. Na fase de testes, os dados serão enviados para o agente diretamente por upload de um arquivo CSV na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é um arquivo CSV contendo dados da carteira de investimento.
-
Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos:
.csv. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 15.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON contendo a análise detalhada do perfil de risco da carteira, incluindo indicadores de risco como volatilidade e beta.
-
Exemplo de Estrutura de Output:
{ "perfil_risco_carteira": "Moderado", "indicadores": [ { "ativo": "Ação A", "volatilidade": 0.15, "beta": 1.2 }, { "ativo": "Ação B", "volatilidade": 0.1, "beta": 0.8 } ] } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.500 caracteres.
1.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.6
1.3.4 Ferramentas do Agente
- Documentos: Não consulta documentos externos.
- Calculadora: Utiliza lógica interna para calcular indicadores de risco.
- Busca Online: Não utiliza.
- Sistemas Externos: Não se conecta a sistemas externos.
1.3.5 Memória
- Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
- Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Proposição de Ajustes de Portfólio (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Proposição de Ajustes de Portfólio (RF 2).
RF 2. Agente de Proposição de Ajustes de Portfólio
2.1 Tarefa do Agente
Propor ajustes no portfólio de investimento para otimização.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo a análise de risco da carteira e dados de mercado atualizados.
# 2. Objetivo
Propor ajustes no portfólio de investimento para otimização, indicando quais ativos aumentar, diminuir ou substituir.
# 3. Regras que você deve seguir para gerar sua resposta
- Propor ajustes no portfólio com base em mudanças de mercado e perfil do investidor, utilizando algoritmos de otimização de portfólio.
- As sugestões devem priorizar a otimização do equilíbrio entre risco e retorno, considerando a diversificação e análise de cenários.
- Levar em consideração a liquidez dos ativos ao propor ajustes, garantindo que as transações sejam viáveis e economicamente justificadas.
# 4. Exemplo de Output que você deve produzir
{
"ajustes_sugeridos": [
{
"ativo": "Ação A",
"acao": "Aumentar",
"justificativa": "Alta expectativa de valorização com base em dados de mercado."
},
{
"ativo": "Ação B",
"acao": "Diminuir",
"justificativa": "Risco elevado identificado na análise de risco."
}
]
} 2.3 Configurações do Agente
2.3.1 Especificação do Input
- Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 1).
- Tipo do input: Este agente deve ser apto a receber como input a análise de risco da carteira em formato JSON, gerada pelo agente anterior.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato:
.json(JSON). - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 2.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON contendo as sugestões de ajuste de portfólio, indicando quais ativos aumentar, diminuir ou substituir.
-
Exemplo de Estrutura de Output:
{ "ajustes_sugeridos": [ { "ativo": "Ação A", "acao": "Aumentar", "justificativa": "Alta expectativa de valorização com base em dados de mercado." }, { "ativo": "Ação B", "acao": "Diminuir", "justificativa": "Risco elevado identificado na análise de risco." } ] } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.000 caracteres.
2.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.6
2.3.4 Ferramentas do Agente
- Documentos: Não consulta documentos externos.
- Calculadora: Utiliza lógica interna para otimização de portfólio.
- Busca Online: Não utiliza.
- Sistemas Externos: Não se conecta a sistemas externos.
2.3.5 Memória
- Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
- Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Monitoramento Contínuo de Risco (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Monitoramento Contínuo de Risco (RF 3).
RF 3. Agente de Monitoramento Contínuo de Risco
3.1 Tarefa do Agente
Monitorar continuamente o risco e o desempenho do portfólio.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados de mercado atualizados e a composição atual do portfólio.
# 2. Objetivo
Monitorar continuamente o risco e o desempenho do portfólio, gerando relatórios de monitoramento contínuo.
# 3. Regras que você deve seguir para gerar sua resposta
- Monitorar continuamente o risco e o desempenho do portfólio, atualizando os dados em tempo real e utilizando alertas predefinidos para mudanças significativas.
- Atualizar indicadores de risco conforme mudanças de mercado e composição do portfólio, garantindo precisão e incorporando novas informações relevantes.
- Alertar sobre desvios significativos no perfil de risco ou desempenho esperado, sugerindo ações corretivas quando necessário, e registrar todas as notificações e ações recomendadas.
# 4. Exemplo de Output que você deve produzir
{
"relatorio_monitoramento": [
{
"data": "18/11/2025",
"risco_atual": "Moderado",
"desempenho": "Dentro do esperado",
"alertas": [
{
"mensagem": "Desvio significativo no risco da Ação A",
"acao_recomendada": "Reavaliar posição"
}
]
}
]
} 3.3 Configurações do Agente
3.3.1 Especificação do Input
- Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 2).
- Tipo do input: Este agente deve ser apto a receber como input dados de mercado atualizados e a composição atual do portfólio em formato JSON.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato:
.json(JSON). - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 3.000 caracteres.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON contendo o relatório de monitoramento contínuo de risco e desempenho do portfólio.
-
Exemplo de Estrutura de Output:
{ "relatorio_monitoramento": [ { "data": "18/11/2025", "risco_atual": "Moderado", "desempenho": "Dentro do esperado", "alertas": [ { "mensagem": "Desvio significativo no risco da Ação A", "acao_recomendada": "Reavaliar posição" } ] } ] } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.000 caracteres.
3.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.6
3.3.4 Ferramentas do Agente
- Documentos: Não consulta documentos externos.
- Calculadora: Utiliza lógica interna para monitoramento de risco e desempenho.
- Busca Online: Não utiliza.
- Sistemas Externos: Não se conecta a sistemas externos.
3.3.5 Memória
- Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
- Visibilidade da Resposta: A resposta gerada por este agente não é passada para outros agentes internos.
3.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo de análise de risco e otimização de portfólio.