mirror of
https://github.com/hoshikawa2/compass_backoffice.git
synced 2026-07-09 13:54:20 +00:00
32 lines
2.1 KiB
Markdown
32 lines
2.1 KiB
Markdown
# Correções framework-native aplicadas no Compass Backoffice
|
|
|
|
Este pacote foi corrigido para reduzir forks locais e usar o máximo possível do `agent_framework_oci`.
|
|
|
|
## Correções principais
|
|
|
|
1. `app/agents/runtime.py` deixou de manter um runtime próprio.
|
|
- Agora reexporta `AgentRuntimeMixin`, `RuntimeContext` e `MessageBuilder` diretamente de `agent_framework.runtime.agent_runtime`.
|
|
- Isso ativa o comportamento nativo do framework para MCP, cache MCP por `args_schema`, deduplicação intra-turno, RAG, memória, cache LLM e eventos IC/NOC/GRL.
|
|
|
|
2. `BackofficeWorkflowExecutor` passou a carregar judges pelo profile do agente.
|
|
- Antes: `JudgePipeline()` usava o caminho global por padrão.
|
|
- Agora: `JudgePipeline(settings=settings, config_path=self.agent_profile.get("judges_config_path"))`.
|
|
- Com isso o agente `backoffice_anatel` usa `config/agents/backoffice_anatel/judges.yaml`.
|
|
|
|
3. `config/guardrails.yaml` foi alinhado com `config/agents/backoffice_anatel/guardrails.yaml`.
|
|
- Evita que estágios do framework que leem o arquivo global executem uma política mais fraca.
|
|
- Guardrails ativos: `INPUT_SIZE`, `MSK`, `PINJ`, `TOX`, `DLEX_IN`, `RAGSEC`, `VLOOP`, `REVPREC`, `DLEX_OUT`, `OOS`, `CMP`, `AOFERTA`.
|
|
|
|
4. `config/judges.yaml` foi alinhado com `config/agents/backoffice_anatel/judges.yaml`.
|
|
- Evita divergência entre execução global e execução por agente.
|
|
- Inclui judges de qualidade, groundedness e políticas específicas do domínio backoffice.
|
|
|
|
5. `config/tools.yaml` recebeu política declarativa de MCP.
|
|
- Tools de consulta: `tool_type: read` e `cache.enabled: true`.
|
|
- Tools mutáveis/de ação: `tool_type: action`, `requires` e `cache.enabled: false`.
|
|
- A chave de cache passa a ser controlada pelo runtime do framework usando `args_schema`.
|
|
|
|
## Regra arquitetural preservada
|
|
|
|
As regras genéricas de segurança, qualidade, vazamento, repetição, escopo, groundedness e revisão de resposta ficam no framework. As regras específicas do domínio ANATEL/Backoffice permanecem como workflow de domínio, porque representam etapas de negócio e não guardrails reutilizáveis.
|