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, busca online, consulta a documentos e demais requisitos funcionais para a criação de um agente de IA que revisa e atualiza automaticamente contratos e termos de credenciamento de estabelecimentos, garantindo que todas as cláusulas estejam em conformidade com as normativas vigentes. Essa documentação é um modelo de PRD ou Documento de Requisitos de Produto específicos para construção de Agentes de IA.
2. Contexto e Problema
Problemas específicos e já conhecidos que esse agente precisa resolver:
- Atualização manual de contratos é demorada e propensa a erros.
- Normativas e regulamentos mudam frequentemente, exigindo revisões constantes.
- Risco de não conformidade com as políticas internas e regulamentações externas.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Reduzir o tempo de atualização de contratos em pelo menos 70%.
- Garantir a conformidade contínua com normativas vigentes.
- Minimizar erros e omissões nas atualizações contratuais.
- Aumentar a eficiência do processo de revisão de contratos.
4. Visão Geral da Solução
O agente de IA para atualização de contratos de estabelecimentos credenciados processa contratos existentes, verifica normativas vigentes e atualiza automaticamente as cláusulas para garantir conformidade. 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 atualização de contratos de credenciamento.
A solução consiste em um fluxo de automação composto por 11 agentes de IA. O processo inicia com a preparação e extração dos contratos e termina com o envio do contrato final e a comunicação às partes interessadas.
| Agentes | Função Principal |
|---|---|
Agente de Preparação e Extração de Contratos (RF 1)
| Receber contratos e produzir uma representação estruturada com todas as cláusulas. |
Agente de Definição de Parâmetros de Pesquisa Regulatória (RF 2)
| Derivar parâmetros para busca de normativas externas e políticas internas aplicáveis. |
Agente de Busca Online de Normativas (RF 3)
| Realizar busca online para obter normativas, guias e comunicados oficiais. |
Agente de Execução de Consulta a Documento de Políticas Internas (RF 4)
| Realizar consulta ao repositório de políticas internas. |
Agente de Consolidação e Mapeamento de Normativas (RF 5)
| Consolidar normativas e mapear impactos por cláusula do contrato. |
Agente Redator de Atualizações Contratuais (RF 6)
| Produzir propostas de redação atualizada para itens não conformes. |
Agente de Redação de Comunicação de Aprovação (RF 7)
| Preparar comunicações solicitando revisão e aprovação das alterações. |
Agente de Execução de Chamada à API de Notificação e Coleta de Aprovação (RF 8)
| Executar o envio das comunicações e coletar aprovações. |
Agente de Finalização e Versionamento de Contrato (RF 9)
| Consolidar feedback aprovado e gerar versão final do contrato. |
Agente de Execução de Chamada à API de Notificação Final (RF 10)
| Enviar o contrato final e comunicar a conclusão do processo. |
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 cliente receberá. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Preparação e Extração de Contratos
1.1 Tarefa do Agente
Receber contratos (PDF, DOCX, texto) e produzir uma representação estruturada com todas as cláusulas, identificadores estáveis e metadados necessários para comparação normativa.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo contratos em formatos diversos. Esses documentos contêm as cláusulas e termos acordados entre as partes.
# 2. Objetivo
Produzir uma representação estruturada de cada contrato, identificando cláusulas, metadados e referências internas para posterior análise normativa.
# 3. Regras que você deve seguir para gerar sua resposta
- Atribua um identificador estável para cada cláusula, preservando a numeração original.
- Classifique cada cláusula em temas predefinidos (ex.: escopo, vigência, rescisão).
- Extraia e normalize dados como datas, prazos e valores.
- Identifique referências cruzadas e crie placeholders para anexos citados.
- Marque cláusulas como obrigatórias ou opcionais conforme a linguagem utilizada.
# 4. Exemplo de Output que você deve produzir
{
"contract_id": "12345",
"clauses": [
{
"clause_id": "1.1",
"title": "Objeto",
"full_text": "Este contrato tem por objeto...",
"mandatory": true
}
]
} 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 contratos 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: Contratos em formatos PDF, DOCX ou texto.
-
Formatos Suportados:
.pdf,.docx,.txt. - 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: JSON estruturado contendo o identificador do contrato, lista de cláusulas e metadados associados.
-
Exemplo de Estrutura de Output:
{ "contract_id": "12345", "clauses": [ { "clause_id": "1.1", "title": "Objeto", "full_text": "Este contrato tem por objeto...", "mandatory": true } ] } - Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 10.000 caracteres.
1.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
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 Definição de Parâmetros de Pesquisa Regulatória (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Definição de Parâmetros de Pesquisa Regulatória (RF 2).
RF 2. Agente de Definição de Parâmetros de Pesquisa Regulatória
2.1 Tarefa do Agente
Derivar, a partir do contrato estruturado e do contexto do estabelecimento, os parâmetros prontos para busca de normativas externas e políticas internas aplicáveis.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um JSON estruturado de um contrato, juntamente com metadados do estabelecimento.
# 2. Objetivo
Derivar parâmetros de busca para normativas e políticas internas aplicáveis.
# 3. Regras que você deve seguir para gerar sua resposta
- Mapeie temas do contrato a órgãos e bases típicas.
- Ajuste palavras-chave combinando tema + sinônimos regulatórios.
- Defina intervalos de datas padrão e expanda conforme necessário.
- Estabeleça necessidade de atualização por tema baseado em alterações normativas recentes.
# 4. Exemplo de Output que você deve produzir
{
"search_parameters": {
"jurisdictions": ["BR"],
"agencies": ["ANPD", "ANVISA"],
"key_topics": ["LGPD", "sanitário"],
"date_ranges": ["2023-01-01", "2025-12-31"],
"keywords": ["privacidade", "compliance"]
}
} 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: JSON estruturado de contratos e metadados do estabelecimento.
-
Formatos Suportados:
.json. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 15.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: JSON com parâmetros de busca consolidados.
-
Exemplo de Estrutura de Output:
{ "search_parameters": { "jurisdictions": ["BR"], "agencies": ["ANPD", "ANVISA"], "key_topics": ["LGPD", "sanitário"], "date_ranges": ["2023-01-01", "2025-12-31"], "keywords": ["privacidade", "compliance"] } } - Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 5.000 caracteres.
2.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
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
- 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 Busca Online de Normativas (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Busca Online de Normativas (RF 3).