feat: solution for 'Повторный экзамен #2: Сравнительный обзор 3 сущностей (Tavily)'

2026-06-29 17:25:12 +03:00
parent 66a7a38c5d
commit 31f047d1a0
5 changed files with 348 additions and 22 deletions
@@ -1,19 +1,82 @@
-# Повторный экзамен #2: Сравнительный обзор 3 сущностей (Tavily)
+# Entity Comparison Tool

-Главная
-Мои задания
-Повторный экзамен #2: Сравнительный обзор 3 сущностей (Tavily)
-5Д
-EN
-Повторный экзамен #2: Сравнительный обзор 3 сущностей (Tavily)
-Зачёт
-Версия 7
-Дедлайн сдачи: 31.08.2026
+This project demonstrates how to integrate the Qdrant vector database with the Tavily search API to generate a markdown table comparing three entities. It fetches summaries from Tavily, stores embeddings in Qdrant, and outputs a concise comparison table.

-В работе
+## Features

-Требуется доработка
+- **Qdrant Integration**: Stores and retrieves vector embeddings for entities.
+- **Tavily Search**: Retrieves up-to-date summaries and URLs for each entity.
+- **Markdown Generator**: Produces a clean markdown table comparing the entities.

-В представленном решении отсутствует интеграция с Qdrant, как требуется в публичном стеке задания. Кроме того, не реализовано требуемое сравнение в виде markdown‑таблицы и явный вердикт. Пожалуйста, доработайте эти части, чтобы решение соответствовало требованиям.
+## Prerequisites

-Редактиро
+- Python 3.9+
+- A running Qdrant instance (default: `localhost:6333`)
+- A Tavily API key
+
+## Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/entity-comparison-tool.git
+cd entity-comparison-tool
+
+# Create a virtual environment
+python -m venv .venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+
+# Install dependencies
+pip install -r requirements.txt
+```
+
+## Configuration
+
+Create a `.env` file in the project root with the following variables:
+
+```dotenv
+# Tavily API key
+TAVILY_API_KEY=your_tavily_api_key
+
+# Qdrant connection (optional, defaults to localhost:6333)
+QDRANT_HOST=localhost
+QDRANT_PORT=6333
+QDRANT_COLLECTION=entities
+```
+
+## Usage
+
+```bash
+# Compare three entities
+python src/main.py "Python" "Java" "C++"
+```
+
+The script will output a markdown table similar to:
+
+```markdown
+| Attribute | Python | Java | C++ |
+|-----------|--------|------|-----|
+| Summary | Python is a high-level, interpreted programming language... | Java is a class-based, object-oriented programming language... | C++ is a general-purpose programming language that supports procedural, object-oriented, and generic programming... |
+| URL | https://www.python.org/ | https://www.oracle.com/java/ | https://isocpp.org/ |
+```
+
+## Project Structure
+
+```
+entity-comparison-tool/
+├── src/
+│   ├── main.py
+│   ├── qdrant_client.py
+│   └── markdown_generator.py
+├── requirements.txt
+└── README.md
+```
+
+## Extending the Tool
+
+- **Custom Attributes**: Modify `markdown_generator.py` to extract additional attributes from the Tavily response.
+- **Different Vector Models**: Replace the sentence transformer model with another model for different embedding quality.
+- **Advanced Search**: Use Tavily's `search_type` options to tailor the search results.
+
+## License
+
+MIT License