Projeto do Agent Contas ORACLE

README.md

@@ -0,0 +1,37 @@
+# TIM Contas — agent_framework_oci
+
+Reconstrução framework-native do Agent Contas. O código executável em `app/`, `mcp/` e `config/` não depende do pacote anterior do Contas.
+
+## Comece aqui
+
+Leia **`docs/MANUAL_AGENT_CONTAS_MIGRADO.md`**.
+
+## Arquitetura
+
+- `app/`: backend e agentes de domínio sobre o LangGraph/framework.
+- `app/domain/contas/`: regras e integrações específicas do Contas, sem runtime de agente próprio.
+- `contas_mcp/servers/contas_mcp_server/`: exposição MCP das operações de domínio.
+- `config/`: intents, tools, policies, identity, guardrails, judges e prompts.
+- `agent_framework_oci/`: infraestrutura compartilhada reutilizada.
+
+## Smoke test
+
+```bash
+uv sync
+uv run uvicorn contas_mcp.servers.contas_mcp_server.main:app --port 8400
+uv run uvicorn app.main:app --port 8000
+```
+
+Em outro terminal:
+
+```bash
+PYTHONPATH=".:agent_framework_oci/libs/agent_framework/src" python scripts/smoke_mcp.py
+```
+
+## Regra de arquitetura
+
+```bash
+grep -R "agente_contas_tim" app mcp config
+```
+
+Deve retornar zero ocorrências.