README.md

metadata

title: Agent Laba
emoji: 🔥
colorFrom: green
colorTo: blue
sdk: gradio
sdk_version: 6.1.0
app_file: app.py
pinned: false
short_description: AI LPNU assistant

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

Markdown

LPNU AI Assistant 🎓

LPNU AI Assistant — це інтелектуальний помічник для студентів Національного університету «Львівська політехніка». Агент використовує OpenAI API для обробки запитів та локальну базу даних для надання актуальної інформації про навчання та розташування корпусів.

---

Основні Інструменти (Tools)

Робота асистента базується на двох ключових функціях, які дозволяють йому взаємодіяти з даними університету:

search_university_info

Призначення: Пошук інформації в базі знань університету. Використовується для відповідей на питання про викладачів, кафедри (зокрема СШІ), факультети (ІКНІ) та загальні правила для студентів.

• Логіка роботи:
  1. Сканує текстові файли у папці data/.
  2. Виконує пошук за ключовими словами (keyword matching).
  3. Повертає найбільш релевантні параграфи тексту.
• Вхідні дані: Рядок із питанням або ключовими словами.
• Джерела даних: ai_department_staff.txt, ikni_faculty.txt, lpnu_student_guide_2025.txt.

get_building_location

Призначення: Надання адреси та геолокації навчальних корпусів.

• Логіка роботи:
  1. Шукає назву корпусу у файлі addresses.txt.
  2. Формує посилання на Google Maps для швидкої навігації.
• Вхідні дані: Назва або номер корпусу (наприклад, "4 корпус").
• Результат: Текстова адреса та згенероване URL-посилання.

---

Структура Даних

Для коректної роботи скрипта необхідно створити папку data/ в корені проєкту та додати наступні файли:

data/
├── addresses.txt               # Формат: "Назва [TAB] Адреса"
├── ai_department_staff.txt     # Інформація про персонал кафедри
├── ikni_faculty.txt            # Інформація про інститут
└── lpnu_student_guide_2025.txt # Довідник студента

Налаштування та Запуск

Клонування репозиторію:

git clone <ваш-репо> cd lpnu-ai-assistant

Встановлення залежностей:

pip install openai python-dotenv litellm

Фрагмент коду OPENAI_API_KEY=sk-proj-...

Запуск:

З терміналу: python main.py

Приклад роботи

User: Де знаходиться 1 корпус? Agent: [Викликає tool get_building_location] 1-й навчальний корпус знаходиться за адресою: вул. Карпінського 2/4. Ось карта: []...

Запустити демо gradio: python app.py