compass_backoffice/docs/AJUSTES_IC_NOC_GRL_OCI_OPENAI.md

Ajustes IC/NOC/GRL e LLM_PROVIDER=oci_openai

Esta versão corrige dois pontos do runtime nativo do backoffice:

1. IC/NOC/GRL padronizados pelo framework

   • O workflow nativo agora emite eventos pelo AgentObserver do framework.
   • Eventos legados AGA.*, NOC.* e GRL.* capturados dos nós originais são reemitidos pela ponte _bridge_legacy_ics.
   • O runtime emite explicitamente eventos de início, conclusão e falha do workflow.
   • Os guardrails emitem GRL explícitos para input, output supervisor e output guardrails.

2. Suporte ao LLM_PROVIDER=oci_openai

   • src/core/config.py agora aceita oci_openai no validador local usado pelos nós do backoffice original.
   • .env.example usa LLM_PROVIDER=oci_openai por padrão e documenta as variáveis esperadas para OCI/OpenAI-compatible.

Eventos adicionados no workflow nativo

• IC.BACKOFFICE_WORKFLOW_STARTED
• IC.BACKOFFICE_WORKFLOW_COMPLETED
• IC.BACKOFFICE_NODE_STARTED
• IC.BACKOFFICE_NODE_COMPLETED
• NOC.001 workflow started
• NOC.006 workflow completed
• NOC.009 workflow/node failed
• GRL.001 input guardrails started
• GRL.002 input guardrails completed
• GRL.003 input blocked
• GRL.004 output supervisor started
• GRL.005 output supervisor completed
• GRL.006 output supervisor blocked/handover
• GRL.007 output guardrails started
• GRL.008 output guardrails completed
• GRL.009 output blocked/sanitized

Arquivos alterados

• app/workflows/backoffice_workflow_executor.py
• src/core/config.py
• .env.example
• tools/validate_parity.py