Haystack
Haystack — фреймворк для модульных pipeline и агентных workflow с явным контролем retrieval, routing, памяти и генерации; масштабируемый RAG и автономные агенты.
Что это
Haystack — фреймворк для модульных pipeline и агентных workflow с явным контролем retrieval, routing, памяти и генерации; масштабируемый RAG и автономные агенты.
Установка
Готовый пример запуска и обязательные переменные окружения смотрите в официальном репозитории.
Что нового в версиях
Haystack v3.5.0: роутеры на OpenAI Decisions API, структурированный вывод для агентов, ранкер MaxSimRanker и смена модели по умолчанию.
- НовоеДобавлены компоненты OpenAIDecisionsTextRouter, OpenAIDecisionsImageRouter и OpenAIDecisionsDocumentClassifier для маршрутизации и классификации данных через OpenAI Decisions API.
- НовоеВнедрен StructuredOutputHook для валидации ответов агентов по Pydantic-моделям с автоматическим исправлением ошибок, а также экспериментальный StepBudgetReminderHook.
- НовоеПоявилась поддержка мультивекторных эмбеддингов в Document и новый ранкер MaxSimRanker для late-interaction моделей, таких как ColBERT.
- Ломает совместимостьМинимальная версия SDK openai повышена до 3.26.0, а Pydantic — до 2.12 (2.14 для Python 3.15).
- УстарелоМодель gpt-5-mini заменена на gpt-5.6-terra по умолчанию; gpt-5-mini будет отключена OpenAI 11 декабря 2026 года.
Выпуск v2.31.1: обновление зависимостей anyio и certifi для устранения уязвимостей CVE-2026-63374 и GHSA-6q48-6c7w-9gw2.
- ИсправленоОбновлён минимальный required-версии anyio до 4.14.2 для устранения уязвимости CVE-2026-63374.
- ИсправленоОбновлён минимальный required-версии certifi до 2026.10.19 для устранения риска компрометации CA eMudhra/emSign.
Исправлена уязвимость в certifi: требуется версия >=2026.10.19 из-за компрометации ключей CA eMudhra/emSign.
- Ломает совместимостьТребование certifi>=2026.10.19: старые версии доверяют скомпрометированным CA eMudhra/emSign (GHSA-6q48-6c7w-9gw2).
- ИсправленоОбновлён транзитивный зависимости certifi через httpx и posthog для устранения риска компрометации.
- НовоеРекомендация: если вы фиксируете (pin) certifi, обновите версию до 2026.10.19 или новее.
Haystack v3.4.0: поддержка Python 3.15, новый инструмент для агентов и исправления сплиттеров документов.
- Ломает совместимостьУдалена поддержка Python 3.10; минимальная версия теперь 3.11.
- НовоеДобавлен ToolResultOffloadCompactor для компактного хранения контекста агентов без потери результатов инструментов.
- ИсправленоИсправлено поведение сплиттеров: теперь корректно обрабатываются разрывы страниц, пробелы и символы перевода страницы.
- Ломает совместимостьИзменена логика FilterPolicy.MERGE: теперь фильтры пересекаются, а не объединяются.
Ускорен SentenceWindowRetriever, исправлена BM25-токенизация для CJK, устранены баги в конвейерах и добавлены ограничения безопасности.
- НовоеSentenceWindowRetriever теперь делает один запрос к хранилищу на вызов, что снижает задержку без изменений в коде.
- Ломает совместимостьBM25L и BM25Plus теперь возвращают только документы с совпадениями по терминам запроса, что может уменьшить количество результатов.
- ИсправленоИсправлена токенизация BM25 для китайского, японского и корейского языков с нормализацией NFC.
- ИсправленоУстранены баги в ChatPromptBuilder (потеря контента), DOCXToDocument (таблицы и ссылки) и ConditionalRouter (мутация данных).
- НовоеДобавлено требование anyio>=4.14.2 для устранения уязвимости CVE-2026-63374.
Haystack v3.2.0: новые хуки для агентов, компактный контекст, удобный API пайплайнов и ломающие изменения в сериализации.
- НовоеSummarizationCompactor: стратегия сжатия контекста агента через LLM-резюме для экономии токенов.
- НовоеTokenBudgetHook: ограничение бюджета токенов и новый механизм stop_run для безопасной остановки агентов.
- НовоеFluent Pipeline: цепочечное добавление компонентов и связей через add_components и connect_many.
- Ломает совместимостьУдален оператор + для Toolset; теперь инструменты передаются списком, старые YAML-файлы не загрузятся.
- Ломает совместимостьЗагрузка сериализованных OutputAdapter и ConditionalRouter с Jinja-фильтрами теперь требует unsafe=True.
Исправлена ошибка, из-за которой конвертеры сообщений OpenAI и Hugging Face падали при обработке пустого контента от ассистента.
- ИсправленоКонвертеры OpenAI Chat Completions и Responses больше не вызывают ошибку при получении сообщения ассистента с пустым контентом, что позволяет корректно обрабатывать отброшенные некорректные вызовы инс
- ИсправленоКонвертер Hugging Face теперь также корректно обрабатывает сообщения ассистента без контента, отправляя их с пустым значением вместо падения.
- ИсправленоМетод ChatMessage.from_openai_dict_format поддерживает пустой контент, обеспечивая корректный round-trip для таких сообщений.
Haystack v3.1.0: экспериментальная компактизация контекста агентов, новые токено-счётчики и exit_reason.
- НовоеДобавлен экспериментальный CompactionHook для агентов: сокращает историю диалога через SlidingWindowCompactor при достижении порога контекстного окна.
- НовоеАгент теперь возвращает exit_reason, объясняющий причину завершения (текст, инструмент или лимит шагов), что упрощает маршрутизацию вывода.
- НовоеВнедрён модуль haystack.token_counters с протоколом TokenCounter и реализациями ApproximateTokenCounter и TiktokenCounter для оценки количества токенов.
- НовоеДобавлен OpenAITokenCounter, использующий API OpenAI для точного подсчёта токенов с учётом форматирования, изображений и инструментов.
- НовоеВ компоненты PyPDFToDocument и PDFMinerToDocument добавлен параметр link_format для парсинга ссылок из аннотаций PDF.
Все релизы на GitHub → Пересказ на русском — по заметкам к релизам и коммитам.