agent_contas/README.md

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

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:

PYTHONPATH=".:agent_framework_oci/libs/agent_framework/src" python scripts/smoke_mcp.py

Regra de arquitetura

grep -R "agente_contas_tim" app mcp config

Deve retornar zero ocorrências.