Vkusvill Agent

VkusVill Shopping Agent

AI-агент для поиска товаров и создания корзины покупок в магазине ВкусВилл.

🚀 Быстрый старт

Вариант 1: Docker (рекомендуется)

# 1. Клонировать репозиторий
git clone git@github.com:vakovalskii/vkusvill-agent.git
cd vkusvill-agent

# 2. Настроить config.yaml (добавить свой API ключ)
nano config.yaml

# 3. Запустить через Docker Compose
docker-compose up -d

# 4. Проверить статус
curl http://localhost:8000/health

# 5. Использовать API
curl -X POST http://localhost:8000/task \
  -H "Content-Type: application/json" \
  -d '{"task": "Найди хлеб свежий"}'

**API Документация:** http://localhost:8000/docs

Вариант 2: Локальная установка

# 1. Создать виртуальное окружение
conda create -n vkusvill python=3.11
conda activate vkusvill

# 2. Установить зависимости
pip install -e .

# 3. Настроить config.yaml (добавить свой API ключ)
nano config.yaml

# 4. Запустить агента (CLI)
python main.py

# ИЛИ запустить API сервер
python api.py
# или
uvicorn api:app --host 0.0.0.0 --port 8000

📋 Возможности

Агент умеет:

• 🔍 Поиск товаров - находит товары по ключевым словам
• 📊 Сортировка - по популярности, рейтингу, цене
• 🛒 Создание корзины - автоматически создает ссылку на корзину с выбранными товарами
• 📝 Детали товара - показывает состав и КБЖУ (по запросу)

🛠️ Доступные инструменты

1. vkusvill_products_search

Поиск товаров по ключевым словам.

**Параметры:**

• q (string) - поисковый запрос
• page (int) - номер страницы (по умолчанию 1)
• sort (string) - сортировка: popularity, rating, price_asc, price_desc

**Возвращает:** список товаров с id, xml_id, названием, ценой, рейтингом и фото

2. vkusvill_product_details

Детальная информация о товаре.

**Параметры:**

• id (int) - ID товара из результатов поиска

**Возвращает:** состав, КБЖУ, детальное описание

3. vkusvill_cart_link_create

Создание ссылки на корзину.

**Параметры:**

• products (array) - массив объе