Agente de IA para Integração de Sistemas de Vale-Transporte

30 de November de 2025 • Tempo de leitura: 5 min

Como criar um agente de IA que facilita a integração de diferentes sistemas de vale-transporte.

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 Agente de IA para Integração de Sistemas de Vale-Transporte. 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 é facilitar a integração de diferentes sistemas de vale-transporte, assegurando a compatibilidade e a troca de informações em tempo real, reduzindo os problemas de comunicação entre sistemas distintos.

2. Contexto e Problema

Cenário Atual

A integração de sistemas de vale-transporte enfrenta diversos desafios, especialmente quando se trata de assegurar a compatibilidade e garantir a troca de informações em tempo real. Os principais problemas identificados são:

  • Dificuldades na integração de diferentes sistemas de vale-transporte.
  • Necessidade de garantir a compatibilidade e a troca de informações em tempo real entre sistemas distintos.

Esses desafios resultam em atrasos e falhas na comunicação, impactando negativamente a eficiência operacional dos sistemas de vale-transporte.

3. Impactos Esperados

A implementação deste agente de IA visa alcançar os seguintes resultados:

  • Facilitar a integração entre diferentes sistemas de vale-transporte.
  • Assegurar a troca de informações em tempo real para evitar atrasos ou falhas na comunicação.
  • Prover suporte contínuo para resolver problemas de integração que possam surgir.

4. Visão Geral da Solução

O agente de IA para integração de sistemas de vale-transporte facilita a compatibilidade entre diferentes plataformas e assegura a troca de informações em tempo real. A seguir são detalhadas todas as regras de negócio e especificações funcionais necessárias para que esse agente atue como um facilitador eficiente e autônomo na integração de sistemas de vale-transporte.

A solução consiste em um fluxo de automação composto por diversos agentes de IA. O processo inicia com a preparação de consultas de metadados e termina com a criação de monitores e alertas para operação contínua da integração.

A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo. O fluxo inclui etapas que garantem a compatibilidade e a troca de informações em tempo real.

Agentes Função Principal
Agente Preparador de Consulta de Metadados - Sistema A (RF 1) Preparar o payload para recuperar metadados do Sistema A de vale-transporte.
Agente de Execução de Chamada à API - Metadados Sistema A (RF 2) Realizar chamada à API do Sistema A para obter metadados.
Agente Preparador de Consulta de Metadados - Sistema B (RF 3) Preparar o payload para recuperar metadados do Sistema B de vale-transporte.
Agente de Execução de Chamada à API - Metadados Sistema B (RF 4) Realizar chamada à API do Sistema B para obter metadados.
Agente de Definição de Mapeamento e Transformação A→B (RF 5) Comparar metadados dos Sistemas A e B e gerar um mapeamento de campos.
Agente de Validação de Compatibilidade e Gaps (RF 6) Auditar o mapeamento proposto, medir compatibilidade e listar gaps.
Agente Preparador de Teste de Sincronização em Tempo Real (RF 7) Gerar payloads para configurar webhooks e publicar eventos de teste.
Agente de Execução de Chamada à API - Configurar Assinaturas/Webhooks (RF 8) Executar chamadas de API para configurar assinaturas de eventos nos Sistemas A e B.
Agente de Execução de Chamada à API - Disparo de Evento de Teste (RF 9) Executar a chamada de API que publica o evento de teste no Sistema A.
Agente de Tratamento de Resultado e Relatório de Teste (RF 10) Consolidar retornos das APIs e produzir relatório de latência e sucesso.
Agente Preparador de Regras de Monitoramento Contínuo (RF 11) Gerar configuração de monitores e alertas para operação contínua da integração.
Agente de Execução de Chamada à API - Criação de Monitores e Alertas (RF 12) Realizar chamadas à API para criar monitores e alertas definidos.

5. Protótipos

Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos que demonstram o fluxo de trabalho dos agentes e o resultado final esperado. Explore os links abaixo para entender melhor a solução em ação.

6. Requisitos Funcionais

RF 1. Agente Preparador de Consulta de Metadados - Sistema A

1.1 Tarefa do Agente

Preparar o payload para recuperar metadados (esquemas, versões e capabilities) do Sistema A de vale-transporte.

1.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um objeto JSON com as chaves necessárias para preparar uma chamada à API do Sistema A de vale-transporte.

# 2. Objetivo
Preparar o payload para recuperar metadados do Sistema A, assegurando que os headers e query params estejam corretos para a execução da chamada.

# 3. Regras que você deve seguir para gerar sua resposta
- Normalize a URL final concatenando base_url + endpoints.metadata, removendo barras duplicadas.
- Defina headers conforme auth_type: oauth2 => Authorization: Bearer {{token}}; api_key => x-api-key: {{api_key}}.
- Construa query.capabilities concatenando os itens de requested_capabilities em ordem alfabética.
- Garanta method="GET", headers.Accept="application/json" e timeout_ms=20000.
- Não inclua body em chamadas GET.
- Retorne somente as chaves: url, method, headers, query e timeout_ms.

# 4. Exemplo de Output que você deve produzir
{"url": "https://api.sistema-a.com/v1/metadata", "method": "GET", "headers": {"Authorization": "Bearer {{token}}", "Accept": "application/json"}, "query": {"capabilities": "schema,events,webhooks"}, "timeout_ms": 20000} 
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 um objeto JSON com as configurações do Sistema A 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 objeto JSON contendo as configurações necessárias para a chamada à API.
  • 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.

1.3.2 Especificação do Output

  • Formato de output: O output deve ser um objeto JSON contendo a URL, método, headers, query e timeout configurados para a chamada à API.
  • Exemplo de Estrutura de Output:
     {"url": "https://api.sistema-a.com/v1/metadata", "method": "GET", "headers": {"Authorization": "Bearer {{token}}", "Accept": "application/json"}, "query": {"capabilities": "schema,events,webhooks"}, "timeout_ms": 20000} 
  • Número de caracteres esperado: O JSON gerado deve ser conciso, com um tamanho estimado em torno 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 - Metadados Sistema A (RF 2).

© 2025 prototipe.ai. Todos os direitos reservados.