Agente de IA para Monitoramento de Carteiras de Investimentos

Normalizar dados de carteiras e definir parâmetros de monitoramento e limiares de alerta por cliente e por ativo.

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 uma lista de carteiras de investimentos 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 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 é uma lista de carteiras de investimentos.
• Formatos Suportados: Esse agente deve ser capaz de receber dados em formatos: .csv, .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON unificado com portfólios normalizados, mapa de identificadores, limiares numéricos de alerta, janelas de observação, regras de cooldown e payloads prontos para consultas a APIs.
• Exemplo de Estrutura de Output:

  { "portfolios_normalizados": [...], "mapa_identificadores": {...}, "limiares_alerta": {...}, "janelas_observacao": {...}, "regras_cooldown": {...}, "payloads_consultas": [...] }

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 5.000 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 normalização de dados.
• 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 Execução de Chamada à API - Dados de Mercado (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Chamada à API - Dados de Mercado (RF 2).

Realizar chamadas às APIs de mercado para recuperar cotações em tempo quase real, book resumido, volumes, yields, curvas, taxas de câmbio e calendário de eventos corporativos.

2.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 1).
• Tipo do input: Este agente deve ser apto a receber payloads prontos contendo lista de instrumentos normalizados, campos requisitados, janelas temporais e parâmetros de paginação/limite.
• 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.

2.3.2 Especificação do Output

• Formato de output: O output deve ser pacotes de dados de mercado por instrumento com timestamps, preços (open/high/low/last), volumes, variação, yields/taxas, eventos corporativos e metadados de fonte.
• Exemplo de Estrutura de Output:

  { "dados_mercado": [...], "metadados": {...} }

• Número de caracteres esperado: O output gerado deve ter um tamanho estimado em torno de 8.000 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: Não se aplica (uso de ferramenta)
• Temperatura: Não se aplica

2.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o payload recebido para a API externa de mercado e retornar os dados brutos como resposta.

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 Execução de Chamada à API - Dados de Carteiras (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Chamada à API - Dados de Carteiras (RF 3).

Realizar chamadas à API do sistema de custódia/portfolio para obter posições atualizadas, caixa, transações recentes e metas de alocação.

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 payloads prontos com identificadores de cliente/carteira, escopo temporal, filtros de status e campos solicitados.
• 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 dados consolidados por cliente contendo posições, quantidades, custos médios, datas, caixa disponível, metas de alocação e restrições aplicáveis.
• Exemplo de Estrutura de Output:

  { "dados_carteira": [...], "metadados": {...} }

• Número de caracteres esperado: O output gerado deve ter um tamanho estimado em torno de 8.000 caracteres.

3.3.3 Parâmetros de Geração

• Modelo: Não se aplica (uso de ferramenta)
• Temperatura: Não se aplica

3.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o payload recebido para a API externa do sistema de custódia/portfolio e retornar os dados brutos como resposta.

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 deve ser visível para o Agente de Detecção de Eventos de Mercado e Risco (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Detecção de Eventos de Mercado e Risco (RF 4).

Identificar eventos relevantes que disparem alertas com base nos limiares definidos e na combinação de dados de mercado e de carteira.

4.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 3).
• Tipo do input: Este agente deve ser apto a receber portfólios normalizados, thresholds por ativo e classe, dados de mercado recuperados e calendário de eventos.
• 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.

4.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista estruturada de eventos_detectados com tipo, severidade, ativos afetados, métricas calculadas, timestamp, janela considerada e recomendação de prioridade inicial.
• Exemplo de Estrutura de Output:

  { "eventos_detectados": [...], "metadados": {...} }

• Número de caracteres esperado: O output gerado deve ter um tamanho estimado em torno de 10.000 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

4.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para detecção de eventos.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

4.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 Geração de Recomendações de Ajuste (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Recomendações de Ajuste (RF 5).

Propor ações táticas e/ou de rebalanceamento alinhadas ao perfil e às restrições do cliente a partir dos eventos detectados.

5.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 4).
• Tipo do input: Este agente deve ser apto a receber eventos detectados, portfólios normalizados, metas de alocação, restrições do cliente, parâmetros de liquidez (ADV), custos/transações mínimos e regras fiscais aplicáveis.
• 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.

5.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista de propostas de ajuste contendo ordens sugeridas (comprar/vender), quantidades/percentuais, racional, impacto estimado em risco/alocação, notas de liquidez e observações de elegibilidade/suitability.
• Exemplo de Estrutura de Output:

  { "propostas_ajuste": [...], "metadados": {...} }

• Número de caracteres esperado: O output gerado deve ter um tamanho estimado em torno de 10.000 caracteres.

5.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

5.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para geração de recomendações.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

5.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 Priorização e Formatação de Alertas (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Priorização e Formatação de Alertas (RF 6).

Classificar, consolidar e formatar os alertas e recomendações em payloads prontos para envio por canal.

6.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 5).
• Tipo do input: Este agente deve ser apto a receber eventos detectados e propostas de ajuste associadas, preferências de notificação do cliente (canal, horários, idioma) e regras de cooldown.
• 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.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um pacote de alertas consolidados com prioridade final, canal sugerido, texto resumido para cliente, resumo executivo para assessor e anexo JSON estruturado para sistemas.
• Exemplo de Estrutura de Output:

  { "alertas_consolidados": [...], "metadados": {...} }

• Número de caracteres esperado: O output gerado deve ter um tamanho estimado em torno de 10.000 caracteres.

6.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

6.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para priorização e formatação de alertas.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

6.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 Execução de Chamada à API - Envio de Alertas (RF 7).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Chamada à API - Envio de Alertas (RF 7).

Enviar os alertas formatados para os canais definidos (app, e-mail, SMS, webhook) e registrar confirmações de entrega.

7.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 6).
• Tipo do input: Este agente deve ser apto a receber payload de alerta pronto para envio, contendo canal, conteúdo, metadados de roteamento e parâmetros de reentrega.
• 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é 5.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser confirmações de envio por canal, IDs de mensagem, status de entrega e erros de roteamento quando houver.
• Exemplo de Estrutura de Output:

  { "confirmacoes_envio": [...], "erros_roteamento": [...] }

• Número de caracteres esperado: O output gerado deve ter um tamanho estimado em torno de 3.000 caracteres.

7.3.3 Parâmetros de Geração

• Modelo: Não se aplica (uso de ferramenta)
• Temperatura: Não se aplica

7.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o payload recebido para a API externa de notificação e retornar as confirmações de envio como resposta.

7.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 (confirmações de envio) é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. As confirmações de envio são o resultado que deve ser disponibilizado ao usuário.