Agent Data — SSOT

v1.0 | 2026-02-28 Agent Data là BỘ NÃO TRUNG TÂM của toàn hệ thống. Đọc: search_knowledge("agent data SSOT")

---

Tổng quan

Agent Data = FastAPI + Qdrant + MCP Server + Event System. Phục vụ:

• Knowledge Base (128+ documents, 315+ vectors)
• Vector Search (RAG) cho mọi AI agent
• MCP tools (11 tools) cho CRUD documents
• Event System → Directus sync (webhook)
• Directus MCP tools (8 tools) cho CRUD collections

---

Kiến trúc

┌──────────────────────────────────────────────────┐
│              AGENT DATA (port 8000)              │
│                                                  │
│  ┌──────────┐  ┌──────────┐  ┌───────────────┐  │
│  │ FastAPI   │  │ MCP      │  │ Event System  │  │
│  │ REST API  │  │ Server   │  │ (webhooks)    │  │
│  └─────┬────┘  └────┬─────┘  └──────┬────────┘  │
│        │            │               │            │
│  ┌─────┴────────────┴───────────────┴─────────┐  │
│  │           Document Manager                  │  │
│  └─────┬───────────────────┬──────────────────┘  │
│        │                   │                     │
│  ┌─────┴─────┐       ┌────┴────┐                │
│  │  Qdrant   │       │  GCS    │                │
│  │  (6333)   │       │ Bucket  │                │
│  │  vectors  │       │ storage │                │
│  └───────────┘       └─────────┘                │
└──────────────────────────────────────────────────┘
        │                           │
        │ sync webhook              │ REST/MCP
        ▼                           ▼
┌──────────────┐           ┌──────────────────┐
│  Directus    │           │  AI Agents       │
│  (8055)      │           │  (5 platforms)   │
└──────────────┘           └──────────────────┘

---

URLs

Environment	URL	Dùng khi
VPS Production	https://vps.incomexsaigoncorp.vn/api/	Production
VPS MCP	https://vps.incomexsaigoncorp.vn/api/mcp	HTTP MCP
Local Dev	http://localhost:8000	Development
Cloud Run	https://agent-data-test-pfne2mqwja-as.a.run.app	CI/CD test only

---

MCP Tools — Agent Data (11 tools)

Tool	Mục đích
search_knowledge	Vector search toàn bộ KB
list_documents	Liệt kê docs theo path
get_document	Đọc doc (truncated + related vectors)
get_document_for_rewrite	Đọc full content
upload_document	Tạo doc mới
update_document	Ghi đè toàn bộ doc
patch_document	Sửa section (old_str → new_str)
delete_document	Xóa doc
batch_read	Đọc nhiều docs (max 20)
move_document	Di chuyển doc
ingest_document	Ingest từ GCS/URL

MCP Tools — Directus (10 tools via directus_stdio_server.py)

Tool	Mục đích
directus_health	Health check
directus_list_collections	Liệt kê collections
directus_get_schema	Schema collection
directus_get_items	List items (filter, sort, limit)
directus_get_item	Get item by ID
directus_create_item	Tạo item
directus_update_item	Cập nhật item
directus_delete_item	Xóa item
directus_list_flows	Liệt kê automation flows
directus_trigger_flow	Trigger flow thủ công

---

Mục lục SSOT

File	Nội dung
index.md	Tổng quan (file này)
connections.md	Ai có tool nào? — Ma trận kết nối Agent Data

Cross-reference: Bảng tương tự cho Directus → search_knowledge("directus SSOT connections tools") Path: knowledge/dev/ssot/directus/directus-connections.md

---

v1.0 | 2026-02-28 | Tạo từ Integration Audit S 89