Zvec Agent Skills
Скилл Zvec ведет агента по встроенной векторной базе: схема коллекции, гибридный поиск, RAG и мультимодальные запросы
- 21 ★ репозитория
- Последний коммит
- Apache-2.0
Минимальный доступ
Почему такой уровень
- Скилл состоит из справочных файлов и примеров кода и сам ничего не запускает
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/zvec-agent-skillsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Скилл состоит из справочных файлов и примеров кода и сам ничего не запускает
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл `zvec` собран из документации векторной базы Zvec и рассчитан на Python 3.10 и новее и на Node.js 16 и новее. Zvec работает внутри процесса приложения на движке Proxima от Alibaba и не требует отдельного сервера. Агент получает справочники по созданию коллекции, операциям с документами, поиску по одному и нескольким векторам, гибридному поиску с фильтрами, построению RAG и поиску по картинке вместе с текстом. Для каждой темы лежат примеры отдельно на Python и на TypeScript. Общие файлы описывают модель данных, содержат шпаргалку по API и разбор типичных проблем. Если указать язык и сценарий, например журнал сбоев на 100 тысяч записей, агент подберет под них схему, индекс и способ ранжирования.
Для кого. Разработчикам на Python и Node.js, которые строят поиск по документам или рекомендации на встроенной базе Zvec и хотят, чтобы агент знал ее API.
Подходит, если
- Для базы знаний техподдержки в формате Markdown собирают RAG с семантическим поиском
- В интернет-магазине ищут товары по смыслу описания и режут выдачу по цене, категории и бренду
- Поиск ведут сразу по картинке и тексту, а `WeightedReRanker` смешивает оценки с заданными весами
- Логи сбоев хранят как векторы, чтобы находить похожие случаи
- Запрос в Zvec падает с ошибкой, и агент разбирает ее по файлу `troubleshooting.md`
Не подходит, если
- Вы работаете с другой векторной базой, например Qdrant или Pinecone: скилл знает только Zvec
- Нужен распределенный кластер с отдельным сервером: Zvec работает внутри процесса приложения
- Язык проекта не Python и не Node.js: примеры есть только для этих двух
Пример запроса к агенту
Сделай на Python с Zvec поиск по базе знаний из Markdown-файлов: схема коллекции с вектором на 768 измерений, загрузка и запрос с фильтром по категорииОграничения
- Скилл содержит документацию и примеры, а сам пакет Zvec ставится отдельно: `pip install zvec` для Python и `npm install @zvec/zvec` для Node.js.
- Примеры написаны на Python и TypeScript, других языков нет.
- Агенту стоит сразу сообщить язык и сценарий, иначе советы выйдут общими.
- Последний коммит в репозитории сделан в апреле 2026 года, и свежие изменения API могут не попасть в справочники.
- Скилл собирается из каталога `src/` командой на Bun, а готовый результат лежит в `skills/zvec/`.
Как отключить. Удалите папку `zvec` из каталога скиллов агента. Пакет Zvec в проекте убирают отдельно: `pip uninstall zvec` или `npm uninstall @zvec/zvec`.
Частые вопросы
Как поставить скилл Zvec в Claude Code?
Выполните `npx skills add github:zvec-ai/zvec-agent-skills --skill "zvec"`. Затем поставьте сам пакет: `pip install zvec` для Python или `npm install @zvec/zvec` для Node.js. Скилл только объясняет агенту, как работать с базой.
Нужен ли для Zvec отдельный сервер?
Нет. Zvec работает внутри процесса приложения, как библиотека, и ставится одним пакетом без настройки. Поэтому подходит для локальных инструментов и сервисов, где отдельная база избыточна.
Какие сценарии покрывает скилл?
RAG для документов, семантический поиск, рекомендации, поиск по картинке вместе с текстом и гибрид полнотекстового BM25 с эмбеддингами. Для каждого есть пример на Python и на TypeScript.
Как совместить векторный поиск с фильтрацией?
Запрос получает вектор и условие `filter`, например `price >= 100 AND price <= 500 AND in_stock == true`, а база возвращает `topk` ближайших документов среди подходящих. Раздел про гибридный поиск разбирает это подробно.
Чем скилл отличается от самой документации Zvec?
Это та же документация, собранная в формат скилла с примерами по сценариям. Агент подгружает нужный файл по теме запроса. Полную справку по API и рекомендации разработчиков ищите на zvec.org.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыZvec MCP — векторная база для агента
Zvec MCP Server
17 инструментов MCP дают агенту создавать коллекции Zvec, писать документы и искать по смыслу с индексами HNSW, IVF и FLAT
Официальные скиллы Weaviate: поиск по векторной базе, импорт данных и готовые схемы RAG-приложений для Claude Code и Cursor
Девять скиллов Pinecone: агент создает векторный индекс, загружает данные, ищет по ним и собирает ассистента для документов
Скилл подбирает научный график под цель и данные CSV или Excel из почти сотни шаблонов и выдает PNG, SVG, PDF и код на Python.
Скиллы Voxel51 для компьютерного зрения: импорт датасетов, поиск дублей, инференс и оценка моделей в FiftyOne
VisActor Skills — графики, дашборды и постеры
VisActor Skills
Девять скиллов VisActor: бизнес-графики, истории из данных, дашборды с картами и постеры, которые собирает агент
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Zvec Agent Skills (эта карточка) | да | 21 | ||
| zvec-grep | нет | не нужна | 4 229 | локальный поиск `zg` по рабочему пространству, а этот скилл учит агента писать код на самой базе Zvec |
| Qdrant Skills | нет | 267 | советы по векторной базе Qdrant, а здесь справочники и примеры для встроенной базы Zvec без сервера |
Коротко о README
Страница рассказывает, что такое Zvec, перечисляет сценарии и дает команды установки скилла и пакетов. Затем идут краткие примеры на Python и Node.js, дерево папок скилла, инструкция по сборке и примеры запросов к агенту. Внизу собраны темы по языкам и ссылки на документацию.