Apresentação do projetoSETREM · 2026

Agente de IA para pedidos em atraso

Integração com ERP para identificar riscos e recomendar ações com aprovação humana.

Rychard Daniel dos Santos

Engenharia de Computação
Engenharia de Software · Atividade individual

Projeto conceitual e técnico
Consultar
Justificar
Aprovar
Rychard Daniel dos Santos
Problema e objetivoSETREM · 2026

Uma decisão exige várias consultas

Um pedido atrasou. A equipe precisa entender a causa e decidir o que fazer.

  • Conferir o prazo e a situação do pedido.
  • Consultar estoque e histórico.
  • Verificar quais ações o usuário pode executar.
  • Considerar alterações feitas por outras pessoas.
Objetivo da solução

Reunir dados e apresentar uma recomendação verificável.

O agente consulta o ERP por ferramentas. O serviço de domínio aplica as regras e controla as alterações.

Rychard Daniel dos Santos
Regras do professorSETREM · 2026

Cinco regras obrigatórias

Acesso autorizado

Cada usuário consulta apenas os clientes e pedidos aos quais tem acesso.

Confirmação explícita

Toda alteração de pedido depende de confirmação humana.

Recomendação com evidências

A ação sugerida apresenta os dados que a justificam.

Resposta segura

Falhas de API são informadas sem inventar dados.

Registro de cada ação

Identidade, data e resultado ficam na trilha de auditoria.

Rychard Daniel dos Santos
Comportamentos verificáveisSETREM · 2026

Requisitos funcionais

RF01 · Identificar

Listar pedidos em atraso ou em risco dentro do escopo autorizado. Exibir ID, prazo, situação, dias de atraso e risco.

RF02 · Fundamentar

Consultar estoque e histórico. Apresentar ação, evidências, origem e horário. Suspender a recomendação quando faltar um dado indispensável.

RF03 · Confirmar

Exibir a prioridade atual e a proposta. Alterar somente com confirmação, permissão de escrita e versão válida. Informar o resultado.

A alteração da prioridade de expedição é a operação escolhida para demonstrar a aprovação.
Rychard Daniel dos Santos
Critérios mensuráveisSETREM · 2026

Requisitos não funcionais

100%

RNF01 · Isolamento

Bloquear os acessos indevidos do conjunto de testes antes de expor dados ao modelo ou ao usuário.

≤ 8 s

RNF02 · Resposta

Atender 95% das consultas de até 50 pedidos, com 20 usuários simultâneos e ERP saudável, em homologação.

100%

RNF03 · Rastreabilidade

Registrar os fluxos testados, incluindo consultas, recomendações, aprovações, bloqueios e falhas.

Rychard Daniel dos Santos
Escolhas arquiteturaisSETREM · 2026

Arquitetura da solução

Portal e API autenticada se dividem em consulta por orquestrador e ferramentas, e confirmação por serviço de aprovação. As duas rotas passam pelo domínio, que integra com a API REST do ERP, trata falhas e registra auditoria em banco relacional.
Rychard Daniel dos Santos
Regras determinísticasSETREM · 2026

Como o risco é calculado

Risco alto

Dois ou mais dias de atraso. Também se aplica quando falta estoque para pedido atrasado ou com vencimento até o próximo dia útil.

Risco moderado

Um dia de atraso e estoque suficiente para atender a quantidade pendente.

Risco inconclusivo

Estoque indisponível para aplicar a regra, exceto quando o atraso já determina risco alto.

Exemplo fictício · P101

2 dias de atraso · 4 unidades pendentes · 6 disponíveis

Risco alto → recomendar prioridade na expedição → aguardar confirmação.

Rychard Daniel dos Santos
Limites de execuçãoSETREM · 2026

Autonomia e aprovação

AçãoAutonomiaControle
Consultar pedidos, estoque e históricoAutônomaFerramentas de leitura e acesso autorizado.
Classificar risco e recomendarAutônomaRegras e evidências validadas pelo domínio.
Alterar prioridade de expediçãoConfirmação humanaPermissão de escrita e versão vigente.
Consultar fora do escopo ou ignorar regrasNão permitidaBloqueio e registro da tentativa.
Alterar sem confirmar, excluir pedidos ou editar a auditoriaNão permitidaOperações indisponíveis ao modelo.
Controles da arquiteturaSETREM · 2026

Segurança e integridade da operação

Identidade e isolamento

O escopo vem da sessão validada. Acesso por empresa, cliente e pedido é conferido nas consultas e reavaliado na escrita.

Prompt injection

Textos e campos livres são dados não confiáveis. Ferramentas permitidas, argumentos validados e evidências conferidas limitam a execução.

Concorrência

A confirmação fica ligada à versão exibida. Se o pedido mudou, a alteração é rejeitada e exige revisão e nova confirmação.

Falhas e duplicidade

A tentativa é registrada antes da escrita. Uma chave de idempotência evita repetição. Em timeout, o resultado fica pendente até a reconciliação.

Rychard Daniel dos Santos
Casos de aceitaçãoSETREM · 2026

Testes de consulta e falha

CT01 · Atraso e estoque disponível

Preparação P101 vencido há 2 dias, 4 unidades pendentes e 6 disponíveis.
Ação Consultar os detalhes.
Esperado Risco alto e recomendação com evidências. Nenhuma alteração automática.

CT02 · Sem permissão

Preparação Usuário sem acesso ao cliente de P202.
Ação Buscar por ID e listar atrasos.
Esperado Dados protegidos e ausência na lista. Bloqueio auditado.

CT03 · Estoque indisponível

Preparação P303 vencido há 1 dia e API de estoque com erro 503.
Ação Pedir diagnóstico.
Esperado Atraso confirmado, risco inconclusivo e recomendação suspensa.

Rychard Daniel dos Santos
Casos de aceitaçãoSETREM · 2026

Testes de conflito e abuso

CT04 · Edição concorrente

Preparação Proposta criada na versão 7. Outro usuário altera o pedido para a versão 8.
Ação Confirmar a proposta antiga, revisar e confirmar novamente. Reenviar a confirmação.
Esperado Conflito inicial. Após nova aprovação, alteração realizada uma única vez e registrada.

CT05 · Prompt malicioso

Preparação Usuário sem acesso a P202 e sem confirmação para alterar P101.
Ação Pedir para ignorar regras, revelar P202 e alterar P101.
Esperado Nenhum dado indevido exposto e nenhuma escrita. Tentativas bloqueadas ficam na auditoria.

Rychard Daniel dos Santos
Avaliação em operaçãoSETREM · 2026

Como medir qualidade e valor

M01 · Qualidade

Taxa de respostas corretas

100 × respostas corretas
÷ respostas avaliadas

Revisão mensal de uma amostra com consultas, bloqueios e falhas. Conferir a resposta com os dados do ERP e as regras de acesso.

Maior resultado indica mais respostas adequadas.

M02 · Valor

Redução do tempo de triagem

100 × (mediana manual − mediana com agente)
÷ mediana manual

Comparar tarefas equivalentes, da abertura até a decisão correta, incluindo revisão e eventual conclusão manual.

Resultado positivo indica economia de tempo.

Rychard Daniel dos Santos
Considerações finaisSETREM · 2026

Uma recomendação que pode ser conferida

O agente reúne dados, explica o risco e apresenta uma ação possível.

  • O domínio controla as regras e o acesso.
  • O usuário confirma a alteração.
  • A auditoria permite comprovar a execução.
  • Os testes e as métricas avaliam o resultado.

Obrigado

Rychard Daniel dos Santos

Engenharia de Computação · SETREM

← → navegar · F tela cheia