Agente de IA para Gestão de Créditos de Vale-Transporte

05 de December de 2025 • Tempo de leitura: 5 min

Como criar um agente de IA que automatiza o processo de verificação e atualização de saldos de créditos de vale-transporte em cartões.

Biblioteca de Prompts e Agentes

1. Propósito e Escopo

Este documento define todos os prompts, configurações de memória, transição entre estados, ferramentas como chamadas a sistemas externos e demais requisitos funcionais para o Fluxo de Agentes "Gestão de Créditos de Vale-Transporte", uma solução de automação projetada para verificar e atualizar saldos de créditos de vale-transporte em cartões de forma precisa e eficiente. 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 é automatizar a verificação de saldos e a atualização eficiente dos mesmos, garantindo precisão nas informações para evitar transtornos aos usuários.

2. Contexto e Problema

Cenário Atual

Atualmente, a verificação de saldos de créditos de vale-transporte é feita manualmente, o que é propenso a erros humanos e demora na atualização dos saldos nos cartões. Isso pode causar transtornos significativos aos usuários que dependem desses créditos para seu deslocamento diário.


Problemas Identificados

  • Erro Humano: A verificação manual de saldos pode resultar em erros, levando a informações imprecisas para os usuários.
  • Atualização Ineficiente: O processo atual de atualização de saldos é demorado, causando atrasos no uso dos créditos pelos usuários.
  • Necessidade de Precisão: Informações imprecisas de saldo podem resultar em transtornos significativos para os usuários que dependem dos créditos de transporte.

3. Impactos Esperados

A implementação deste fluxo de automação visa alcançar os seguintes resultados:

  • Aumentar a Precisão: Automatizar a verificação de saldos em tempo real para garantir informações precisas aos usuários.
  • Eficiência na Atualização: Integrar com sistemas de pagamento para facilitar a atualização automática de saldos de créditos nos cartões.
  • Satisfação do Usuário: Implementar um sistema de notificação para alertar usuários sobre saldos baixos ou atualizações necessárias, melhorando a experiência do usuário.

4. Visão Geral da Solução

O agente de IA para gestão de créditos de vale-transporte automatiza o processo de verificação e atualização de saldos em cartões, garantindo precisão e eficiência para os usuários. 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 créditos de vale-transporte.

A solução consiste em um fluxo de automação composto por vários agentes de IA. O processo inicia com a preparação do payload para consulta de saldo e termina com a atualização e notificação dos usuários sobre seus saldos.

A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.

Agentes Função Principal
Agente de Preparação de Payload de Consulta de Saldo (RF 1) Construir o payload padronizado para consulta de saldo a partir do número do cartão e políticas de negócio.
Agente de Execução de Chamada à API - Consulta de Saldo (RF 2) Realizar chamada à API do Sistema de VT para obter o saldo do cartão informado.
Agente de Normalização e Validação de Resposta de Saldo (RF 3) Normalizar a resposta da API de saldo para um formato canônico e sinalizar condições de negócio (ex.: saldo baixo).
Agente Decisor e Preparador de Notificação de Saldo Baixo (RF 4) Avaliar se o saldo está abaixo do limite e preparar payload de notificação.
Agente de Execução de Chamada à API - Notificação (RF 5) Realizar envio da notificação preparada ao sistema de mensagens.
Agente de Preparação de Payload de Recarga de Créditos (RF 6) Construir payload de recarga/atualização de créditos integrando com sistema de pagamento.
Agente de Execução de Chamada à API - Recarga (RF 7) Realizar chamada à API do sistema de pagamento/VT para efetivar a recarga.
Agente de Conciliação e Confirmação de Recarga (RF 8) Normalizar a resposta de recarga e produzir estado final de atualização do saldo, com instruções de reconsulta quando necessário.
Agente Preparador de Notificação de Recarga (RF 9) Preparar payload de notificação para o usuário após a recarga.
Agente de Execução de Chamada à API - Notificação de Recarga (RF 10) Enviar a notificação da recarga ao sistema de mensagens.

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 usuário receberá. Explore os links abaixo para entender melhor a solução em ação.

Ver Agente na Prototipe AI

6. Requisitos Funcionais

RF 1. Agente de Preparação de Payload de Consulta de Saldo

1.1 Tarefa do Agente

Construir o payload padronizado para consulta de saldo a partir do número do cartão e políticas de negócio.

1.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo o número do cartão e informações de políticas de negócio para construir um payload de consulta de saldo.

# 2. Objetivo
Construir o payload padronizado para consulta de saldo a partir do número do cartão e políticas de negócio.

# 3. Regras que você deve seguir para gerar sua resposta
- Rejeite cartões que contenham caracteres não numéricos; remova espaços e traços antes da validação.
- Verifique se o comprimento do cartão está entre tamanho_min e tamanho_max definidos em politicas.validacoes_cartao; se inválido, defina no output campo query.cartao como null e acrescente header x-validation-error: cartao_invalido.
- Sempre inclua x-tenant-id e x-origin com os valores recebidos; gere x-idempotency-key único por combinação cartao+endpoint+data (YYYYMMDD-HH) para garantir idempotência por janela de 1h.
- Defina timeout_ms entre 5s e 10s; use 8s por padrão. Configure retry_policy com no máximo 2 tentativas e backoff mínimo de 300ms.
- Padronize o endpoint como /api/v1/saldos/consultar e method GET; parâmetros no objeto query.
- Se limite_saldo_baixo não for informado, use 20.00 (moeda_padrao): BRL.
- Nunca inclua dados sensíveis além do número do cartão nos queries/headers; não inclua CPF/PII.
- Garanta que o número do cartão no payload esteja mascarado apenas para logs externos (não aplicável ao output deste agente).
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 do cartão e políticas de negócio 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 conjunto de dados estruturados contendo o número do cartão e políticas de negócio.
  • Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .json.
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 5.000 caracteres.

1.3.2 Especificação do Output

  • Formato de output: O output deve ser um objeto JSON contendo o payload de consulta de saldo, com endpoint, method, query, headers, timeout_ms e retry_policy.
  • Exemplo de Estrutura de Output: 
     {"endpoint":"/api/v1/saldos/consultar","method":"GET","query":{"cartao":"1234567890"},"headers":{"x-tenant-id":"TENANT","x-origin":"PORTAL","x-idempotency-key":"uuid"},"timeout_ms":8000,"retry_policy":{"max_attempts":2,"backoff_ms":300}}
  • Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 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: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

1.3.5 Memória

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 - Consulta de Saldo (RF 2).

RF 2. Agente de Execução de Chamada à API - Consulta de Saldo

2.1 Tarefa do Agente

Realizar chamada à API do Sistema de VT para obter o saldo do cartão informado.

2.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um payload pronto para consulta de saldo, contendo endpoint, method, query, headers, timeout_ms e retry_policy.

# 2. Objetivo
Realizar chamada à API do Sistema de VT para obter o saldo do cartão informado.

# 3. Regras que você deve seguir para gerar sua resposta
- Realize a chamada à API utilizando os dados do payload recebido.
- Garanta que a chamada seja feita respeitando as políticas de retry definidas.
- Capture a resposta da API e formate-a conforme necessário para os agentes subsequentes.
- Em caso de erro de comunicação, registre o erro e não reenvie a chamada automaticamente.
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 um objeto JSON contendo o payload de consulta de saldo.
  • 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 até 1.000 caracteres.

2.3.2 Especificação do Output

  • Formato de output: O output deve ser um objeto JSON contendo o status da chamada à API e o saldo retornado, conforme necessário para os agentes subsequentes.
  • Exemplo de Estrutura de Output: 
     {"status":200,"body":{"cartao":"1234567890","saldo":50.00,"moeda":"BRL","data_servidor":"2025-12-05T11:07:00-03:00","fonte":"SISTEMA_VT"}}
  • Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 500 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: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

2.3.5 Memória

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

Ao concluir sua execução, esse agente aciona o Agente de Normalização e Validação de Resposta de Saldo (RF 3).

RF 3. Agente de Normalização e Validação de Resposta de Saldo

3.1 Tarefa do Agente

Normalizar a resposta da API de saldo para um formato canônico e sinalizar condições de negócio (ex.: saldo baixo).

3.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo a resposta da API de saldo, contendo o status e o corpo da resposta.

# 2. Objetivo
Normalizar a resposta da API de saldo para um formato canônico e sinalizar condições de negócio (ex.: saldo baixo).

# 3. Regras que você deve seguir para gerar sua resposta
- Se status ∉ {200,201}, defina status_consulta: "erro" e inclua observacoes com código e motivo; saldo deve ser null.
- Converta data_servidor para timezone politicas.timezone (padrão America/Sao_Paulo) e ISO 8601; se ausente, use timestamp local de processamento.
- Garanta que saldo seja numérico com 2 casas decimais; se body.saldo vier null/NaN, trate como 0.00 e adicione observacao: "saldo_informado_nulo".
- Normalize moeda para código ISO 4217; se ausente, use moeda_padrao (BRL).
- Calcule saldo_baixo = (saldo <= limite_saldo_baixo) considerando arredondamento em 2 casas.
- Retorne cartao exatamente como recebido do body se válido; se divergente do consultado, mantenha o consultado e adicione observacao: "cartao_divergente_na_fonte".
- status_consulta deve ser "sucesso" apenas se status in {200,201} e houver campo saldo.
- Não inclua dados pessoais do usuário no output.
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 um objeto JSON contendo a resposta da API de saldo.
  • 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 até 1.000 caracteres.

3.3.2 Especificação do Output

  • Formato de output: O output deve ser um objeto JSON contendo o status normalizado da consulta de saldo e sinalizações de condições de negócio.
  • Exemplo de Estrutura de Output: 
     {"cartao":"1234567890","saldo":50.00,"moeda":"BRL","data_verificacao":"2025-12-05T11:07:00-03:00","fonte":"SISTEMA_VT","status_consulta":"sucesso","saldo_baixo":false,"limite_saldo_baixo":20.00,"observacoes":[]}
  • Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 500 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: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

3.3.5 Memória

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

Ao concluir sua execução, esse agente aciona o Agente Decisor e Preparador de Notificação de Saldo Baixo (RF 4).

RF 4. Agente Decisor e Preparador de Notificação de Saldo Baixo

4.1 Tarefa do Agente

Avaliar se o saldo está abaixo do limite e preparar payload de notificação.

4.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo a resposta normalizada da consulta de saldo, incluindo informações sobre o saldo e condições de negócio.

# 2. Objetivo
Avaliar se o saldo está abaixo do limite e preparar payload de notificação.

# 3. Regras que você deve seguir para gerar sua resposta
- Defina enviar_notificacao = true somente se saldo_baixo == true e status_consulta == "sucesso".
- Escolha canal por ordem de preferência recebida; se vazio, use "app".
- Formate valores monetários conforme moeda (BRL com vírgula decimal, 2 casas) apenas no texto; mantenha valores numéricos nos metadados.
- Se idioma != pt-BR, ajuste assunto/mensagem conforme idioma; se ausente, use pt-BR.
- Inclua no payload metadados mínimos: cartao, saldo, limite, data.
- Nunca inclua número completo do cartão em mensagem ao usuário; apenas nos metadados internos.
4.3 Configurações do Agente

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 um objeto JSON contendo as informações normalizadas da consulta de saldo.
  • 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 até 1.000 caracteres.

4.3.2 Especificação do Output

  • Formato de output: O output deve ser um objeto JSON contendo a decisão de envio de notificação e o payload preparado para o sistema de mensagens.
  • Exemplo de Estrutura de Output: 
     {"enviar_notificacao":true,"payload":{"canal":"app","assunto":"Saldo de VT baixo","mensagem":"Seu saldo de VT (BRL 12,50) está abaixo de BRL 20,00.","destinatario":{"tipo":"usuario","id":""},"metadados":{"cartao":"1234567890","saldo":12.5,"limite":20.0,"data":"2025-12-05T11:07:00-03:00"}}}
  • Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 600 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 documentos externos.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

4.3.5 Memória

4.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 - Notificação (RF 5).

RF 5. Agente de Execução de Chamada à API - Notificação

5.1 Tarefa do Agente

Realizar envio da notificação preparada ao sistema de mensagens.

5.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um payload de notificação pronto, contendo canal, assunto, mensagem, destinatario e metadados.

# 2. Objetivo
Realizar envio da notificação preparada ao sistema de mensagens.

# 3. Regras que você deve seguir para gerar sua resposta
- Utilize o payload recebido para fazer a chamada à API do sistema de mensagens.
- Garanta que a chamada respeite as políticas de rate limit e deduplicação do sistema de mensagens.
- Capture a resposta da API e garanta que a mensagem foi aceita pelo sistema.
5.3 Configurações do Agente

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 um objeto JSON contendo o payload de notificação.
  • 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 até 1.000 caracteres.

5.3.2 Especificação do Output

  • Formato de output: O output deve ser um objeto JSON contendo o status do envio da notificação e detalhes adicionais, se necessário.
  • Exemplo de Estrutura de Output: 
     {"status":202,"body":{"message_id":"abc123","canal":"app","aceito":true}}
  • Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 300 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 documentos externos.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

5.3.5 Memória

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

Ao concluir sua execução, esse agente aciona o Agente de Preparação de Payload de Recarga de Créditos (RF 6).

RF 6. Agente de Preparação de Payload de Recarga de Créditos

6.1 Tarefa do Agente

Construir payload de recarga/atualização de créditos integrando com sistema de pagamento.

6.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo informações sobre o cartão e o valor de recarga para construir um payload de recarga.

# 2. Objetivo
Construir payload de recarga/atualização de créditos integrando com sistema de pagamento.

# 3. Regras que você deve seguir para gerar sua resposta
- Valide valor_recarga: deve estar entre politicas.valor_min e politicas.valor_max; se fora do intervalo, zere body e adicione header x-validation-error: valor_recarga_invalido.
- Arredonde valor_recarga para 2 casas decimais (round half up).
- Exija moeda ISO 4217; se ausente, use BRL.
- Normalize tipo de meio_pagamento para o catálogo permitido {cartao_credito, boleto, pix}; se desconhecido, marque x-validation-error: meio_pagamento_invalido.
- Gere x-idempotency-key único por combinação cartao+valor+moeda; recargas repetidas com mesma chave devem ser idempotentes.
- Defina timeout_ms 12s e sem retries automáticos (max_attempts:1) para evitar dupla cobrança.
6.3 Configurações do Agente

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 um objeto JSON contendo as informações do cartão e valor de recarga.
  • 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 até 1.000 caracteres.

6.3.2 Especificação do Output

  • Formato de output: O output deve ser um objeto JSON contendo o payload de recarga, com endpoint, method, body, headers, timeout_ms e retry_policy.
  • Exemplo de Estrutura de Output: 
     {"endpoint":"/api/v1/recargas","method":"POST","body":{"cartao":"1234567890","valor":100.00,"moeda":"BRL","meio_pagamento":{"tipo":"pix","token":"..."}},"headers":{"x-tenant-id":"TENANT","x-origin":"PORTAL","x-idempotency-key":"uuid"},"timeout_ms":12000,"retry_policy":{"max_attempts":1}}
  • Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 500 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 documentos externos.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

6.3.5 Memória

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 - Recarga (RF 7).

RF 7. Agente de Execução de Chamada à API - Recarga

7.1 Tarefa do Agente

Realizar chamada à API do sistema de pagamento/VT para efetivar a recarga.

7.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um payload de recarga pronto, contendo endpoint, method, body, headers, timeout_ms.

# 2. Objetivo
Realizar chamada à API do sistema de pagamento/VT para efetivar a recarga.

# 3. Regras que você deve seguir para gerar sua resposta
- Realize a chamada à API utilizando os dados do payload recebido.
- Garanta que a chamada seja feita respeitando as políticas de idempotência definidas.
- Capture a resposta da API e formate-a conforme necessário para os agentes subsequentes.
- Em caso de erro de comunicação, registre o erro e não reenvie a chamada automaticamente.
7.3 Configurações do Agente

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 um objeto JSON contendo o payload de recarga.
  • 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 até 1.000 caracteres.

7.3.2 Especificação do Output

  • Formato de output: O output deve ser um objeto JSON contendo o status da recarga e detalhes adicionais, conforme necessário para os agentes subsequentes.
  • Exemplo de Estrutura de Output: 
     {"status":201,"body":{"transacao_id":"tx_123","status":"aprovada","autorizacao":"A1B2C3","nsu":"000123","valor":100.00,"moeda":"BRL","data_processamento":"2025-12-05T11:07:30-03:00"}}
  • Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 500 caracteres.

7.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.6

7.3.4 Ferramentas do Agente

  • Documentos: Não consulta documentos externos.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

7.3.5 Memória

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

Ao concluir sua execução, esse agente aciona o Agente de Conciliação e Confirmação de Recarga (RF 8).

RF 8. Agente de Conciliação e Confirmação de Recarga

8.1 Tarefa do Agente

Normalizar a resposta de recarga e produzir estado final de atualização do saldo, com instruções de reconsulta quando necessário.

8.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo a resposta da API de recarga, contendo o status e o corpo da resposta.

# 2. Objetivo
Normalizar a resposta de recarga e produzir estado final de atualização do saldo, com instruções de reconsulta quando necessário.

# 3. Regras que você deve seguir para gerar sua resposta
- Mapear status HTTP e do corpo para status_recarga: 201/200 + body.status in {aprovada,confirmed} => "aprovada"; 202 ou body.status in {pendente,in_process} => "pendente"; 4xx com motivo pagamento_negado => "negada"; 5xx => "erro".
- Se aprovado e saldo_anterior_opcional disponível, calcule novo_saldo = saldo_anterior + valor_recarga; se a fonte devolver saldo atualizado, prefira o da fonte.
- Normalize datas para ISO 8601 em America/Sao_Paulo; preencha data_atualizacao com data_processamento se disponível.
- Defina reconsulta_necessaria = true quando status_recarga == "pendente" ou quando a fonte não retornar saldo atualizado.
- Inclua transacao.id, nsu e autorizacao quando disponíveis; se ausentes, inclua observacao: "identificadores_transacao_ausentes".
8.3 Configurações do Agente

8.3.1 Especificação do Input

  • Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 7).
  • Tipo do input: Este agente deve ser apto a receber um objeto JSON contendo a resposta da API de recarga.
  • 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 até 1.000 caracteres.

8.3.2 Especificação do Output

  • Formato de output: O output deve ser um objeto JSON contendo o status final da recarga, novo saldo e instruções de reconsulta, se necessário.
  • Exemplo de Estrutura de Output: 
     {"cartao":"1234567890","status_recarga":"aprovada|pendente|negada|erro","valor_recarga":100.00,"moeda":"BRL","novo_saldo":150.00,"data_atualizacao":"2025-12-05T11:07:31-03:00","transacao":{"id":"tx_123","nsu":"000123","autorizacao":"A1B2C3"},"reconsulta_necessaria":false}
  • Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 500 caracteres.

8.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.6

8.3.4 Ferramentas do Agente

  • Documentos: Não consulta documentos externos.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

8.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 Preparador de Notificação de Recarga (RF 9).

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

Ao concluir sua execução, esse agente aciona o Agente Preparador de Notificação de Recarga (RF 9).

RF 9. Agente Preparador de Notificação de Recarga

9.1 Tarefa do Agente

Preparar payload de notificação para o usuário após a recarga.

9.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo informações sobre o status da recarga e o novo saldo para preparar uma notificação ao usuário.

# 2. Objetivo
Preparar payload de notificação para o usuário após a recarga.

# 3. Regras que você deve seguir para gerar sua resposta
- Defina enviar_notificacao conforme status_recarga: aprovada => true (mensagem de sucesso); pendente => true (mensagem de processamento); negada/erro => true (mensagem de falha com instruções); caso preferencia de canal vazia, use "app".
- Adeque o texto ao idioma; padrão pt-BR.
- Mantenha números formatados no texto e valores numéricos nos metadados.
- Não exibir número completo do cartão no corpo da mensagem.
9.3 Configurações do Agente

9.3.1 Especificação do Input

  • Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 8).
  • Tipo do input: Este agente deve ser apto a receber um objeto JSON contendo o status da recarga e o novo saldo.
  • 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 até 1.000 caracteres.

9.3.2 Especificação do Output

  • Formato de output: O output deve ser um objeto JSON contendo a decisão de envio de notificação e o payload preparado para o sistema de mensagens.
  • Exemplo de Estrutura de Output: 
     {"enviar_notificacao":true,"payload":{"canal":"app","assunto":"Recarga de VT aprovada","mensagem":"Sua recarga de BRL 100,00 foi aprovada. Novo saldo: BRL 150,00.","destinatario":{"tipo":"usuario","id":""},"metadados":{"cartao":"1234567890","valor":100.00,"novo_saldo":150.00}}}
  • Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 600 caracteres.

9.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.6

9.3.4 Ferramentas do Agente

  • Documentos: Não consulta documentos externos.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

9.3.5 Memória

9.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 - Notificação de Recarga (RF 10).

RF 10. Agente de Execução de Chamada à API - Notificação de Recarga

10.1 Tarefa do Agente

Enviar a notificação da recarga ao sistema de mensagens.

10.2 Prompt ou Instruções do Agente 
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um payload de notificação pronto para envio, contendo canal, assunto, mensagem, destinatario e metadados.

# 2. Objetivo
Enviar a notificação da recarga ao sistema de mensagens.

# 3. Regras que você deve seguir para gerar sua resposta
- Utilize o payload recebido para fazer a chamada à API do sistema de mensagens.
- Garanta que a chamada respeite as políticas de rate limit e deduplicação do sistema de mensagens.
- Capture a resposta da API e garanta que a mensagem foi aceita pelo sistema.
10.3 Configurações do Agente

10.3.1 Especificação do Input

  • Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 9).
  • Tipo do input: Este agente deve ser apto a receber um objeto JSON contendo o payload de notificação.
  • 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 até 1.000 caracteres.

10.3.2 Especificação do Output

  • Formato de output: O output deve ser um objeto JSON contendo o status do envio da notificação e detalhes adicionais, se necessário.
  • Exemplo de Estrutura de Output: 
     {"status":202,"body":{"message_id":"msg_456","aceito":true}}
  • Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 300 caracteres.

10.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.6

10.3.4 Ferramentas do Agente

  • Documentos: Não consulta documentos externos.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

10.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.

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

A execução deste agente finaliza o fluxo. A resposta gerada é o resultado que deve ser disponibilizado ao usuário.

Posts Relacionados

© 2025 prototipe.ai. Todos os direitos reservados.