Agent API Registry — Đ39 Knowledge Graph

Tạo: 2026-04-04 | Trạng thái: ĐĂNG KÝ. Triển khai Phase 2+. Hạ tầng: Langdroid + OpenRouter API Nguyên tắc: Mỗi Agent = 1 nhiệm vụ cụ thể. DOT dispatch theo execution_engine.

KIẾN TRÚC

PG trigger/cron → DOT dispatch →
  execution_engine = 'pg_function' → SQL function (Phase 1)
  execution_engine = 'agent_api'  → Langdroid Agent (Phase 2+)
  execution_engine = 'hybrid'     → SQL prep → Agent → SQL store

DANH SÁCH 22 DOT CẦN AGENT API

Nhóm A — Hình thành Knowledge (5 Agent)

DOT	Engine	Agent	Nhiệm vụ
DOT-KG-EXTRACT	agent_api	Agent Extract	Text/row → trích xuất entities + relations
DOT-KG-CLASSIFY	agent_api	Agent Classify	Entity mới → phân loại species + labels
DOT-KG-LINK	hybrid	Agent Link	Entity resolution via Qdrant + AI reasoning
DOT-KG-VALIDATE	agent_api	Agent Validate	Kiểm tra ngữ nghĩa (logic sai?)
DOT-KG-SIMILARITY	hybrid	Agent Similarity	Refresh Qdrant embeddings

Nhóm B — Kinh doanh (3 Agent)

DOT	Engine	Agent	Nhiệm vụ
DOT-KG-INTENT-CAPTURE	agent_api	Agent Intent	Chat/form → intent edge
DOT-KG-RECOMMEND	agent_api	Agent Recommend	Graph + intent → gợi ý
DOT-KG-FEEDBACK	hybrid	Agent Feedback	Phản hồi sai lệch → sửa/quarantine

Nhóm C — Kiến trúc (8 Agent)

DOT	Engine	Agent	Nhiệm vụ
DOT-KG-SCAFFOLD-BUILD	agent_api	Agent Scaffold	★ Ban hành luật text → tự tạo graph khung
DOT-KG-SCOPE-PROJECT	hybrid	Agent Scope	Person+Role+Goal → subgraph (AI filter)
DOT-KG-PRIORITY-DECOMPOSE	agent_api	Agent Priority	Goal → HTN decomposition tree
DOT-KG-DISCOVER+PROPOSE	agent_api	Agent Discover	Pattern recognition → đề xuất quan hệ mới
DOT-KG-CONSTRAINT-CHECK	hybrid	Agent Constraint	Policy Graph ↔ Context → PASS/FAIL
DOT-KG-PROVENANCE-TAG	hybrid	Agent Provenance	Gắn nguồn gốc cho edge
DOT-KG-EXPLAIN	agent_api	Agent Explain	XAI: giải thích quyết định
DOT-KG-CORRECT	hybrid	Agent Correct	Feedback → sửa edge/quarantine

Nhóm D — Tự học (2 Agent)

DOT	Engine	Agent	Nhiệm vụ
DOT-KG-SELF-SCORE	hybrid	Agent Score	Prediction vs reality → score
DOT-KG-SELF-LEARN	agent_api	Agent Learn	Scores → bounded weight update

Nhóm J — Conversational (2 Agent)

DOT	Engine	Agent	Nhiệm vụ
DOT-KG-CONVERSE-EXTRACT	agent_api	Agent Converse	Chat text → entities
DOT-KG-CONVERSE-VERIFY	hybrid	Agent ConvVerify	Extracted → verified (auto/APR)

Nhóm Kiểm tra Cấp A (2 Agent)

DOT	Engine	Agent	Nhiệm vụ
DOT-KG-EXPLAIN-VERIFY	agent_api	Agent ExplainVerify	Kiểm tra explanation path đúng logic
DOT-KG-SCOPE-VERIFY	hybrid	Agent ScopeVerify	Verify subgraph đủ/thiếu

14 DOT PG-ONLY (không cần Agent)

COMPLETENESS, CONSISTENCY, TIMELINESS, ORPHAN, HEALTH, INTENT-RECALC, PRIORITY-RECALC, EVICT-SCAN, EVICT-VERIFY, OVERRIDE-LOG, OVERRIDE-AUDIT, PROVENANCE-AUDIT, SCAFFOLD-VALIDATE, JOURNEY-UPDATE.

NỢ KỸ THUẬT AGENT API

TD	Mô tả	Phase	Priority
TD-AGENT-1	Langdroid infrastructure setup (base framework)	2	High
TD-AGENT-2	OpenRouter API integration + key management (GSM)	2	High
TD-AGENT-3	DOT dispatch: execution_engine routing logic	2	High
TD-AGENT-4	Agent Extract + Classify (first pair)	2	High
TD-AGENT-5	Agent Scaffold (ban hành → graph khung)	2	Medium
TD-AGENT-6	Qdrant integration cho Link + Similarity	2	Medium
TD-AGENT-7	Agent Intent + Recommend (kinh doanh)	3	Medium
TD-AGENT-8	Agent Self-Learn + guardrails	3	Medium
TD-AGENT-9	Agent Converse (chat acquisition)	3	Medium
TD-AGENT-10	Agent Explain (XAI)	3	Low

GHI CHÚ

• Phase 1: KHÔNG có Agent API. Chỉ hạ tầng PG. DOT đăng ký với execution_engine nhưng chưa dispatch.
• Phase 2: Agent Extract, Classify, Link, Scaffold — core KG.
• Phase 3: Agent kinh doanh + tự học + XAI.
• Mỗi Agent = 1 Langdroid worker. Config trên PG (kg_auto_approve_rules quyết định auto/manual).

Agent API Registry v1.0 | 22 DOT agent_api/hybrid | 10 TD | Langdroid + OpenRouter