42 lines
1.3 KiB
Markdown
42 lines
1.3 KiB
Markdown
# 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.
|
|
|
|
|
|
## V10 - VAS response renderer
|
|
`consultar_vas` agora usa `response.mode: renderer` com `renderer: contas.vas`. O renderer inclui o valor de cada serviço quando a tool o fornece (por exemplo `details.valor`) e nunca inventa preço quando ausente.
|