From bc6f88c68daaffb550f8080d24259ce31465a5c4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=A0=D0=B8=D0=BD=D0=B0=D1=80=20=D0=9C=D0=B8=D1=80=D0=B7?=
 =?UTF-8?q?=D0=B0=D0=B3=D0=B8=D1=82=D0=BE=D0=B2?= <mirzagitov03@mail.ru>
Date: Tue, 16 Jun 2026 11:22:54 +0000
Subject: [PATCH] Solution published: update README.md

---
 README.md | 49 ++++++++++++++++++++++++++-----------------------
 1 file changed, 26 insertions(+), 23 deletions(-)

diff --git a/README.md b/README.md
index 73b9f89..c46f5a1 100644
--- a/README.md
+++ b/README.md
@@ -1,30 +1,33 @@
-# FAQ-бот (ChromaDB + MCP-tool)
+# FAQ‑бот (ChromaDB + MCP‑tool)
 
-## Что это
-
-Агент, отвечающий на вопросы по локальным конспектам курса, используя ChromaDB, и при необходимости вызывающий внешний MCP‑подобный инструмент (mock‑сервер).
-
-## Установка
+## Что делает
+- Загружает локальные `.md` файлы в ChromaDB.
+- Предоставляет два инструмента:
+  1. `search_course_docs` – поиск по FAQ.
+  2. `fetch_course_meta` – получение метаданных курса (расписание, преподаватель).
+- Агент на основе LangChain‑Agent использует только нужный инструмент и указывает источник ответа.
 
+## Как запустить
 ```bash
+# Установить зависимости
 pip install -r requirements.txt
+
+# Подготовить базу FAQ
+python -c "from src.utils import load_faq_to_chroma; load_faq_to_chroma()"
+
+# Запустить mock‑сервер метаданных (если нужен HTTP‑tool)
+python -m http.server 8000  # или используйте встроенный сервер в src/mcp_tool.py
+
+# Запустить CLI‑бота
+python src/agent.py --question "Какой у нас график занятий?"
 ```
 
-## Запуск
+## Тестовые вопросы
+1. `Какой у нас график занятий?` – должен использовать `fetch_course_meta`.
+2. `Что такое ChromaDB?` – должен использовать `search_course_docs`.
+3. `Кто преподаватель?` – должен использовать `fetch_course_meta`.
 
-```bash
-python -m src.agent
-```
-
-## Примеры вопросов
-
-1. **Chroma** – `Что такое ChromaDB?`
-2. **Chroma** – `Как подключить Ollama embeddings?`
-3. **MCP** – `Какой у нас расписание?`
-
-## Структура
-
-- `data/` – Markdown‑файлы FAQ.
-- `src/utils.py` – загрузка в Chroma и поиск.
-- `src/mcp_tool.py` – mock‑сервер и клиент MCP‑стиля.
-- `src/agent.py` – основной агент.
+## Структура репозитория
+- `data/` – исходные `.md` и `course_meta.json`.
+- `src/` – код бота.
+- `requirements.txt` – зависимости.