Bernt
0b416b0f13
- Add agent orchestrator API (/api/v1/agents/*) - Connect frontend AgentContext to real backend - Add AgentLayerPage with full agent management - Implement specialist agents: finance, sales, hr, crm, legal, marketing, dashboard - Add authentication, RBAC, tenant isolation on agent endpoints - Add rate limiting and audit logging - Update sidebar with Agent Layer navigation - Build fresh web-v2 dist
143 lines
4.6 KiB
Markdown
143 lines
4.6 KiB
Markdown
# BOC Agent Layer — Activation Matrix
|
|
|
|
## Inventory Date: 2026-08-12
|
|
|
|
---
|
|
|
|
## WHAT ALREADY EXISTS
|
|
|
|
### Frontend (web-v2)
|
|
| Component | Status | Location |
|
|
|-----------|--------|----------|
|
|
| AgentContext.ts | ✅ EXISTS | `web-v2/src/components/agent/AgentContext.ts` |
|
|
| AgentChat.tsx | ✅ EXISTS | `web-v2/src/components/agent/AgentChat.tsx` |
|
|
| AgentButton.tsx | ✅ EXISTS | `web-v2/src/components/agent/AgentButton.tsx` |
|
|
|
|
**Agent Definitions Found:**
|
|
- `finance` — Finance AI
|
|
- `sales` — Sales AI
|
|
- `hr` — HR AI
|
|
- `crm` — CRM AI
|
|
- `legal` — Legal AI
|
|
- `marketing` — Marketing AI
|
|
- `dashboard` — AMOS Assistant (fallback)
|
|
|
|
**Missing Agent Definitions:**
|
|
- `accounting` — Accounting Agent
|
|
- `compliance` — Compliance Agent
|
|
- `support` — Support Agent
|
|
- `projects` — Projects Agent
|
|
- `automation` — Automation Agent
|
|
- `social` — Social Agent
|
|
|
|
### Backend (Go)
|
|
| Component | Status | Location |
|
|
|-----------|--------|----------|
|
|
| Agent API Endpoint | ❌ MISSING | No `/api/agent/*` routes |
|
|
| Agent Orchestrator | ❌ MISSING | No orchestrator service |
|
|
| Agent Handler | ❌ MISSING | No `handlers/agent.go` |
|
|
|
|
### API Endpoints (Existing Domain APIs)
|
|
| Domain | Status | Endpoints |
|
|
|--------|--------|-----------|
|
|
| CRM | ✅ OPERATIONAL | `/api/v1/crm/customers`, `/api/v1/crm/leads`, `/api/v1/crm/pipeline` |
|
|
| Sales | ✅ OPERATIONAL | `/api/v1/sales/deals`, `/api/v1/sales/mrr`, `/api/v1/sales/arr` |
|
|
| Finance | ✅ OPERATIONAL | `/api/v1/finance/balance`, `/api/v1/finance/income`, `/api/v1/finance/moms` |
|
|
| HR | ✅ OPERATIONAL | `/api/v1/hr/employees`, `/api/v1/hr/leaves`, `/api/v1/hr/timesheets` |
|
|
| Legal | ✅ OPERATIONAL | `/api/v1/legal/contracts`, `/api/v1/legal/templates` |
|
|
| Marketing | ✅ OPERATIONAL | `/api/v1/marketing/campaigns`, `/api/v1/marketing/content` |
|
|
| Support | ✅ OPERATIONAL | `/api/v1/support/tickets`, `/api/v1/support/csat` |
|
|
| Automation | ✅ OPERATIONAL | `/api/v1/automation/workflows`, `/api/v1/automation/jobs` |
|
|
| Briefing | ✅ OPERATIONAL | `/api/v1/briefing/daily`, `/api/v1/briefing/real` |
|
|
|
|
### Infrastructure
|
|
| Component | Status | Notes |
|
|
|-----------|--------|-------|
|
|
| Kubernetes Namespace | ❌ MISSING | No `boc` namespace found |
|
|
| Kubernetes Manifests | ❌ MISSING | No k8s/ directory |
|
|
| Docker Compose | ✅ EXISTS | `docker-compose.yml` |
|
|
| Backend Binary | ✅ EXISTS | `backend/boc-api` |
|
|
| Frontend Build | ✅ EXISTS | `web-v2/dist/` |
|
|
|
|
---
|
|
|
|
## WHAT WAS DISCONNECTED
|
|
|
|
1. **AgentChat.tsx** calls `/api/agent/chat` — endpoint doesn't exist
|
|
2. **AgentContext.ts** has agent definitions but no backend integration
|
|
3. **AgentButton.tsx** exists but not integrated in sidebar/layout
|
|
4. **Frontend agents** have mock responses only (fallback when API fails)
|
|
|
|
---
|
|
|
|
## WHAT WAS NOT DEPLOYED
|
|
|
|
1. **Agent API Layer** — No backend support for agent operations
|
|
2. **Agent Orchestrator** — No central routing/coordination
|
|
3. **Agent-to-Agent Communication** — No inter-agent protocol
|
|
4. **Agent Observability** — No metrics/audit for agents
|
|
|
|
---
|
|
|
|
## GAP ANALYSIS
|
|
|
|
### Critical Gaps (BLOCKING)
|
|
1. ❌ No `/api/agent/chat` endpoint
|
|
2. ❌ No agent orchestrator
|
|
3. ❌ No agent authentication/authorization
|
|
4. ❌ No agent audit trail
|
|
5. ❌ No Kubernetes deployment for agent services
|
|
|
|
### Medium Gaps
|
|
1. ❌ Missing 5 agent definitions (accounting, compliance, support, projects, automation, social)
|
|
2. ❌ Agent button not in sidebar
|
|
3. ❌ No agent status/health monitoring
|
|
4. ❌ No agent-to-agent communication protocol
|
|
|
|
### Low Gaps
|
|
1. ❌ No agent-specific observability metrics
|
|
2. ❌ No agent memory/state persistence
|
|
3. ❌ No agent tool registry
|
|
|
|
---
|
|
|
|
## IMPLEMENTATION PLAN
|
|
|
|
### Phase 1: Backend Agent API (CRITICAL)
|
|
1. Create `handlers/agent.go` — Agent chat endpoint
|
|
2. Create `service/agent/` — Agent orchestrator
|
|
3. Wire `/api/agent/chat` in `main.go`
|
|
4. Add agent authentication middleware
|
|
|
|
### Phase 2: Frontend Integration
|
|
1. Add AgentButton to sidebar
|
|
2. Create Agent Layer page
|
|
3. Connect AgentChat to real API
|
|
4. Add missing agent definitions
|
|
|
|
### Phase 3: Kubernetes Deployment
|
|
1. Create k8s namespace
|
|
2. Create deployment manifests
|
|
3. Create service/ingress
|
|
4. Deploy and verify
|
|
|
|
### Phase 4: Observability & Audit
|
|
1. Add agent metrics
|
|
2. Add audit logging
|
|
3. Add health checks
|
|
4. Add status dashboard
|
|
|
|
---
|
|
|
|
## DEFINITION OF DONE
|
|
|
|
- [ ] `/api/agent/chat` endpoint responds correctly
|
|
- [ ] All 12 agents have definitions
|
|
- [ ] Agent button visible in sidebar
|
|
- [ ] Agent chat connects to backend
|
|
- [ ] Agent responses use real domain data
|
|
- [ ] Kubernetes deployment active
|
|
- [ ] Agent audit trail working
|
|
- [ ] Agent health/status visible
|
|
- [ ] E2E test passes for each agent
|