Agente de IA para Classificação de Ativos

Realizar chamadas a APIs de dados de mercado para obter cotações, curvas, índices e metadados necessários à classificação de ativos.

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 um payload de dados de mercado via API. Na fase de testes, o fluxo será iniciado pelo envio manual dos dados, que serão enviados para o agente diretamente por upload na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um payload de dados de mercado.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato JSON.
• 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 JSON estruturado contendo todas as informações de mercado necessárias para a classificação de ativos.
• Exemplo de Estrutura de Output:

   { "snapshot_id": "abc123", "vendor": "market_vendor", "reference_date": "2025-12-03", "symbols": ["AAPL", "GOOGL"], "data_by_symbol": { "AAPL": { "price": 150.0, "price_prev": 148.0, "return_window": 0.0135, "volume": 1000000, "bid_ask_spread": 0.01, "dv_30d": 1.2, "vol_30d": 0.25, "rating_ext": "AA", "sector": "Technology", "country": "USA", "fx_rate": 1.0 } }, "benchmarks": { "cdi": 0.12, "selic": 0.13, "inflation": 0.04, "vix": 0.2, "curves": { "gov_br": [ {"tenor": "1Y", "rate": 0.07} ], "usd": [ {"tenor": "1Y", "rate": 0.05} ] } } }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.000 caracteres, dependendo da quantidade de símbolos processados.

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: Não utiliza.
• Busca Online: Utiliza para obter dados de mercado em tempo real.
• Sistemas Externos: Conecta-se a APIs de mercado para obtenção de dados.

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 Classificação de Ativos Financeiros (RF 2).

1.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Classificação de Ativos Financeiros (RF 2).

Categorizar e classificar ativos financeiros com base em critérios predefinidos, produzindo pontuações e rótulos padronizados para análise e monitoramento.

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 um JSON estruturado contendo dados de ativos financeiros.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato JSON.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 20.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo as classificações e análises dos ativos financeiros.
• Exemplo de Estrutura de Output:

   { "reference_date": "2025-12-03", "criteria_version": "v1.0", "market_snapshot_id": "abc123", "assets": [ { "asset_id": "1", "symbol": "AAPL", "canonical_asset_type": "Equity", "sector_std": "Technology", "country": "USA", "scores": { "risk": 25, "return": 80, "liquidity": 90, "composite": 70 }, "classes": { "risk": "baixo", "return": "alto", "liquidity": "alta", "overall": "A" }, "rationale": ["volatilidade baixa", "retorno > benchmark"], "data_quality_flags": { "missing_fields": [], "used_defaults": false, "outliers": [] }, "compliance_flags": { "criteria_override_applied": false, "rule_ids": [] } } ], "aggregation": { "by_class_overall": { "A": 10, "B": 5, "C": 3, "D": 2 }, "by_asset_type": { "Equity": 15, "Bond": 5 }, "exposures": { "currency": { "USD": 70, "EUR": 30 }, "country": { "USA": 60, "Germany": 40 }, "sector": { "Technology": 50, "Finance": 50 } } }, "classificacao_atualizada": "sim" }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 8.000 caracteres, dependendo do número de ativos classificados.

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 cálculos de classificação.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Relatório de Análise com Base na Classificação (RF 3).

2.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Relatório de Análise com Base na Classificação (RF 3).

Gerar relatório estruturado de análise e monitoramento a partir do classification_result, destacando insights acionáveis e mudanças relevantes.

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 um JSON contendo o classification_result.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato JSON.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 10.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo o relatório de análise e monitoramento dos ativos financeiros.
• Exemplo de Estrutura de Output:

   { "generated_at": "2025-12-03T11:23:00", "reference_date": "2025-12-03", "summary": { "carteiras_por_classe": { "A": 10, "B": 5, "C": 3, "D": 2 }, "destaques": [ "AAPL com alto retorno", "GOOGL com baixa liquidez" ] }, "insights": [ { "title": "Alto Retorno em AAPL", "severity": "info", "insight_text": "AAPL apresentou retorno acima do benchmark com volatilidade controlada.", "related_assets": ["AAPL"], "rule_ref": "retorno" } ], "tables": { "top_risk": ["GOOGL"], "top_return": ["AAPL"], "low_liquidity": ["GOOGL"] }, "diffs": [], "recomendações_regrais": ["revisar limiar de risco"] }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 7.000 caracteres, dependendo da complexidade do relatório.

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 cálculos de análise.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 é o entregável final e 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. O relatório gerado é o resultado que deve ser disponibilizado ao usuário.