Binolarni ro‘yxatga olish uchun agentli jarayonlar platformasi
Opus Magnum — UMHackathon 2026 uchun AI Systems & Agentic Workflow Automation yo‘nalishida yaratilgan, binolarni SI yordamida ro‘yxatga oladigan platforma. U shahardagi bino hujjatlari bilan bog‘liq ishni bitta yo‘naltirilgan jarayonga aylantiradi: SI modeli ega topshirgan hujjatlarni o‘qiydi, ularni o‘sha shahar qoidalariga solishtiradi, qarama-qarshiliklarni ko‘rsatadi va hammasi o‘tgach, binoni ommaviy 3D e’lon sifatida chop etadi. Binolar — faqat demo sohasi, dvigatel esa yetkazib beruvchilardan tortib litsenziyalargacha istalgan tartibga solinadigan ro‘yxatga olish jarayoniga mos keladi.
Biz uni besh kishilik jamoa tarkibida uch kunda qurdik. Kod Apache-2.0 litsenziyasi ostida va GitHub’da ochiq, YouTube’da taqdimot videosi ham bor.
Uchta rol, bitta dvigatel
- Shahar administratori — shablonlarni interfeysda tuzadi; model bir qatorlik tavsifdan boshlang‘ich shablon qoralamasini tayyorlaydi va so‘ralsa, istalgan maydonni tushuntirib beradi.
- Bino egasi — shahar jarayonidan o‘tadi, formalarni to‘ldiradi va hujjatlarni yuklaydi: tekshiruv uchun muvofiqlik hujjatlari (ular hech qachon ommaga ko‘rsatilmaydi) va e’lon uchun kontent hujjatlari; so‘ng qarama-qarshiliklarni hal qiladi va binoni chop etadi.
- Tashrif buyuruvchi — chop etilgan binolarni 3D sahnada ko‘radi va yordamchiga savollar beradi; javoblar faqat egasining kontent hujjatlaridan olinadi.
Asosiy imkoniyatlar
- Ma’lumot sifatidagi shablonlar — jarayon oltita asosiy blokning tartiblangan ro‘yxatidan iborat: forma to‘ldirish, muvofiqlik hujjatini yuklash, kontent yuklash, o‘zaro tekshiruv, inson ko‘rib chiqishi va chop etish. Talablari qattiqroq shahar shunchaki qadamlar qo‘shadi, masalan, yong‘in xavfsizligi, zonalash va mulk huquqi hujjatlarini alohida yuklash.
- Davom ettirsa bo‘ladigan jarayonlar — shablonlar checkpointer’li LangGraph
StateGraph’ga kompilyatsiya qilinadi, shuning uchun jarayon o‘rtasida chiqib ketgan ega aynan o‘sha qadamdan davom etadi. - Sabablari ko‘rsatilgan tekshiruv — model har bir hujjatdan maydonlarni ajratib oladi va ularni shahar mezonlari bo‘yicha baholaydi, har bir mezon uchun hukm va dalil beradi; muvaffaqiyatsiz qadam qayta yuklashga qaytadi.
- Hujjatlararo tekshiruvlar — qarama-qarshilik chiqsa, masalan, formadagi va qavat rejasidagi qavatlar soni farq qilsa, jarayon izoh bilan to‘xtatiladi.
- Qarorlar jurnali — audit uchun har bir model chaqiruvi tegishli qadamning logiga yoziladi.
- Jonli jarayon kanvasi — egalar o‘z jarayonini React Flow grafi ko‘rinishida kuzatadi, har bir fayl esa Server-Sent Events orqali tahlil, ajratib olish va tekshiruv bosqichlaridan o‘tib boradi.
Arxitektura va texnologiyalar
Backend — FastAPI va Pydantic, SQLAlchemy esa production’da Postgres, ishlab chiqishda SQLite ustida ishlaydi. Model — ilmu-glm-5.1; u OpenAI bilan mos ILMU API’ga OpenAI SDK orqali chaqiriladi va JSON rejimi hamda function calling vositalaridan foydalanadi: shablon qoralamasini tuzish, hujjatlardan ma’lumot ajratib olish, mezonlar bo‘yicha tekshiruv, o‘zaro tekshiruvlar, ko‘rib chiqish xulosalari va tashrif buyuruvchilarga javoblar uchun.
Qayta ishlash mulohazadan ajratilgan: matn qatlami bor PDF’lar pypdf orqali o‘tadi, skanlar uchun esa Tesseract OCR ishlatiladi. Modelning imkoniyatlarini birinchi sinashimiz u rasmli so‘rovlarga faqat matn bilan javob berishini ko‘rsatdi, shuning uchun vizual tahlil o‘rniga OCR asosiy yo‘l bo‘ldi.
Frontend — Next.js 16.2, React 19.2, TypeScript, Tailwind CSS 4 va shadcn/ui; jarayon kanvasi uchun React Flow, 3D bino sahifalari uchun react-three-fiber va drei. Pytest shablon kompilyatsiyasi, jarayon grafi, HTTP oqimlari, hujjatlarni qayta ishlash va jonli model bilan smoke testni qamrab oladi. Stek Postgres, backend va frontend bilan bitta Render Blueprint sifatida joylashtiriladi va ishga tushganda demo shaharni qaytadan to‘ldiradi.
Demo ssenariy
Administrator Shah Alam shahrini yaratadi va modelga uning shablonini bitta gapdan tuzdiradi. Keyin ega demo minorani ro‘yxatga qo‘shadi: manzili noto‘g‘ri bo‘lgan yong‘in xavfsizligi sertifikati oddiy tilda tushuntirilgan holda rad etiladi, tuzatilgani esa o‘tadi; qavatlar sonidagi nomuvofiqlik o‘zaro tekshiruvda ushlanadi, chop etilgan bino esa tashrif buyuruvchilarning savollari uchun 3D’da ochiladi.
Bizning rolimiz
Backend va SI integratsiyasiga biz rahbarlik qildik: model mijozi va vositalar sxemalari, ma’lumotlar bazasi va boshlang‘ich ma’lumotlar, LangGraph dvigateli va uning asosiy bloklari, hujjatlar va OCR konveyeri hamda joylashtirish. Administrator, ega va tashrif buyuruvchi interfeyslarini birgalikda qurdik, topshirilgan talablar, tizim tahlili, arxitektura va QA hujjatlarining mazmunini yozdik.
Tegishli ishlar
SI qat’iy tekshiruv bosqichlari ichida ishlaydigan yana bir tizim — Keystone. Opus Magnum — sun’iy intellekt integratsiyasi va avtomatlashtirish hamda veb-ilovalar yaratish bo‘yicha ishlarimizdan biri.
