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
- 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 - Metadados Sistema A (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 - Metadados Sistema A (RF 2).