NanSOS Docs

AI Architecture

AI เป็นชั้นช่วยเหลือ (assistive) ไม่ใช่ผู้ตัดสินใจอัตโนมัติ — ครอบคลุม chat, สกัดข้อมูลจากข้อความ/เสียง และสรุปเหตุ

หลักการ Guardrails

  • ห้าม auto-submit รายงานเหตุ
  • ห้าม auto-dispatch / มอบหมายทีมอัตโนมัติ
  • ตำแหน่งที่ AI ประมาณต้องติดป้าย AI_ESTIMATE
  • คำตอบ AI เป็นข้อเสนอ — มนุษย์ยืนยันเสมอ

องค์ประกอบ

ส่วนเส้นทางหน้าที่
Citizen AssistantUI + /api/ai/*เล่าเหตุ → สกัดร่างฟอร์ม
Console AssistantUI + /api/ai/chatสรุปสถานการณ์ ค้นเหตุ คิวงาน
Voice STT/api/ai/transcribeถอดเสียง → ข้อความ → สกัด
Extract/api/ai/extractโครงสร้างฟิลด์เหตุจากข้อความ

โมเดลและการตั้งค่า

คีย์ API เก็บใน integration_secrets (ไม่ฝังใน client) ตั้งค่าได้ที่ /settings/integrations และ /settings/ai — รองรับ fallback โมเดลเมื่อ provider ไม่พร้อม

สถาปัตยกรรมนี้ทำให้เปลี่ยน provider/model ได้โดยไม่ต้องรื้อ UI หน้าประชาชนหรือคอนโซล