evrz hackathon

ทบทวนโทรเลขบอท

บอท Tython Telegram ที่ประมวลผลไฟล์เก็บถาวรแยกโครงสร้างโครงการรหัสแยกและสร้างรายงานการตรวจสอบตามฐานความรู้ที่ให้ไว้

คุณสมบัติ

• การสนับสนุนไฟล์: ยอมรับรูปแบบไฟล์ต่างๆ
• การสนับสนุนที่เก็บถาวร: ยอมรับรูปแบบ RAR, zip และ 7z
• รีวิวดูตัวอย่าง: ส่งตัวอย่างที่น่าสนใจของผลการตรวจสอบ
• ทบทวนดาวน์โหลด: ให้ปุ่มเพื่อดาวน์โหลดรายงานการตรวจสอบฉบับเต็มเป็นไฟล์ PDF
• RAG: ใช้ผ้าขี้ริ้วเพื่อให้บริบทสำหรับโมเดล
• LLM ขนาดเล็ก: ใช้โมเดล Mistral-Nemo 12B สำหรับการให้การตรวจสอบที่ครอบคลุมซึ่งต้องการ VRAM น้อยกว่า 20GB

การตั้งค่า

ข้อกำหนดเบื้องต้น

• Python 3.11+
• บทกวี สำหรับการจัดการการพึ่งพา ติดตั้งจากเว็บไซต์อย่างเป็นทางการของบทกวี
• Minio Server พร้อม DNS Record สำหรับ URL ที่กำหนดล่วงหน้า (จะให้ข้อมูลรับรองแยกต่างหาก)
• การพึ่งพาระบบ :
  • สำหรับการสกัด RAR ตรวจสอบให้แน่ใจว่ามีการติดตั้ง unrar ในระบบของคุณ:
    • Ubuntu: sudo apt-get install unrar
    • macOS (พร้อม homebrew): brew install unrar
    • Windows: ไม่ได้รับการสนับสนุนเนื่องจากขาดไลบรารีที่รองรับ

หมายเหตุสำคัญสำหรับการพัฒนาในท้องถิ่น

หากเรียกใช้บอทในเครื่อง (Docker นอก) คุณจะต้องจัดการการติดตั้ง Pytorch แยกกัน:

• RUN ทั้ง: pip install torch==2.1.2 --index-url https://download.pytorch.org/whl/cpu
• หรือไม่เกี่ยวกับการพึ่งพา torch ใน pyproject.toml และพยายามติดตั้ง แต่ อาจล้มเหลว

การติดตั้ง

1. โคลนที่เก็บ

   git clone https://github.com/isofinly/telegram_review_bot.git
   cd telegram_review_bot

2. กำหนดค่าตัวแปรสภาพแวดล้อม สร้างไฟล์ .env พร้อมตัวแปรที่จำเป็นต่อไปนี้:

    BOT_TOKEN=your_telegram_bot_token
   MINIO_ENDPOINT=your_minio_endpoint
   MINIO_ACCESS_KEY=your_minio_access_key
   MINIO_SECRET_KEY=your_minio_secret_key
   MINIO_SECURE=true_or_false
   MODEL_API_KEY=your_model_api_key
   

   หมายเหตุ: Minio Credentials จะได้รับผ่านทาง Manager และ Cloud Drive Document

3. เลือกวิธีการติดตั้งของคุณ

   นักเทียบท่า (แนะนำ) :

   docker-compose up -d

   สิ่งนี้จะเริ่มต้นทั้งคอนเทนเนอร์ Bot และ Minio Server

   การติดตั้งในพื้นที่ :

   poetry install
   poetry run telegram-review-bot

การใช้งาน

1. เริ่มต้นบอท

   เปิดโทรเลขและค้นหาบอทของคุณ เริ่มการสนทนาโดยส่ง /start

2. 2.1 ส่งไฟล์

   ส่งไฟล์ไปยังบอท

   2.2 ส่งคลังเก็บ

   หรือคุณสามารถส่งไฟล์เก็บถาวร (rar, zip, 7z) ไปยังบอท

3. รับเอาต์พุต

   • รีวิวดูตัวอย่าง: บอทจะตอบกลับด้วยการแสดงตัวอย่างของผลการตรวจสอบ
   • ทบทวนดาวน์โหลด: ใช้ปุ่มที่ให้ไว้เพื่อดาวน์โหลดรายงานการตรวจสอบฉบับเต็มเป็นไฟล์ PDF

ตรวจสอบท่อส่ง

1. RAG : สร้างฐานข้อมูลเวกเตอร์จากฐานความรู้เพื่อจัดเรียงโค้ดโค้ดกับตัวอย่างการตรวจสอบที่เกี่ยวข้อง
2. ทบทวน :
   • โครงสร้างโครงการแยกวิเคราะห์
   • วิเคราะห์โครงสร้างของแต่ละไฟล์
   • แบ่งไฟล์ออกเป็นชิ้นที่จัดการได้
   • ใช้ RAG เพื่อสร้างพรอมต์และข้อมูลตามบริบทสำหรับโมเดล
   • สร้างและจัดรูปแบบการตรวจสอบ

โครงสร้างแพ็คเกจ

• src/bot - รหัสบอทโทรเลข
• src/review - ลอจิกรีวิวรหัส
• • src/review/parsers - Code Chunking Logic

การบริจาค

ยินดีต้อนรับ! โปรดเปิดปัญหาหรือส่งคำขอดึงสำหรับการปรับปรุงหรือแก้ไขข้อผิดพลาดใด ๆ

ใบอนุญาต

มิกซ์