Выпущен smolagents v1.26.0 daily

Hugging Face выпустила новую версию smolagents v1.26.0, которая вносит изменения в платформу для создания агентов на Python. Ключевыми нововведениями стали интеграция поискового движка Exa для расширенных возможностей веб-поиска и полное удаление удаленного WasmExecutor, что направлено на повышение общей безопасности системы. Эти обновления отражают стремление команды к улучшению функциональности и стабильности библиотеки, обеспечивая разработчиков более и надежными инструментами для своих проектов.

Ключевые изменения в smolagents v1.26.0

Последняя версия smolagents v1.26.0 от Hugging Face включает ряд важных обновлений, направленных на улучшение функциональности и стабильности библиотеки. Среди наиболее заметных изменений — добавление поискового движка Exa в WebSearchTool и полное удаление удаленного WasmExecutor. Эти изменения стали результатом активной работы над развитием платформы и откликом на потребности сообщества разработчиков.

Помимо крупных нововведений, релиз v1.26.0 также включает в себя множество мелких улучшений и исправлений. Была обновлена dev-версия до v1.26.0.dev0, добавлены новые сообщения об ошибках для провайдеров LiteLLM без ключей, а также исправлены опечатки в документации, примерах и тестах. Кроме того, устранены ошибки, связанные с экранированием f-строк в сообщениях об ошибках ToolSerializer.dumps, и обновлена строка документации для LocalPythonExecutor. Эти доработки способствуют повышению общей надежности и удобства использования smolagents, упрощая работу разработчиков.

Интеграция Exa для улучшенного поиска

Одним из центральных нововведений в smolagents v1.26.0 стала интеграция Exa как новой опции поискового движка в WebSearchTool. Exa позиционируется как поисковая система, специально разработанная для нужд ИИ-агентов, предлагая функции, оптимизированные для получения релевантной и структурированной информации из сети.

Exa предоставляет обширные возможности для агентов, включая интеллектуальный токеноэффективный поиск по документам и репозиториям. Согласно заявлениям Exa, их API способен сокращать токены до 90% за счет извлечения наиболее релевантных фрагментов с помощью функции «Highlights». Также система может извлекать обогащенные данные в виде структурированных результатов из более чем 70 миллионов компаний, что упрощает анализ и обработку информации для агентов. Эти возможности направлены на повышение интеллектуального потенциала агентов, позволяя им быстрее и точнее находить необходимую информацию.

Разработчики могут легко использовать Exa в своих инструментах WebSearchTool в smolagents. Для этого достаточно инициализировать WebSearchTool, указав engine="exa", как показано в примерах: tool = WebSearchTool(engine="exa"), а затем вызвать results = tool("latest AI research papers"). Для работы с Exa требуется переменная окружения EXA_API_KEY, которую необходимо предварительно настроить. Hugging Face интегрировал Exa через прямой доступ к REST API, не добавляя новых зависимостей.

Exa демонстрирует высокое качество поиска при различных задержках и лучшую в своем классе точность по самым сложным бенчмаркам, таким как FRAMES, Tip-of-Tongue и Seal0. Эти метрики подчеркивают эффективность Exa в обработке сложных поисковых запросов и предоставлении точных результатов. Интеграция с Exa предоставляет разработчикам smolagents доступ к поисковой технологии, превосходящей возможности других поисковых движков, особенно в контексте потребностей ИИ-агентов.

В источниках нет данных о планах по добавлению других поисковых движков или инструментов, помимо Exa.

Удаление WasmExecutor и причины

В рамках обновления smolagents v1.26.0 было принято решение о полном удалении удаленного WasmExecutor, который ранее использовал Pyodide и Deno для изолированного выполнения кода WebAssembly. Это изменение является прямым следствием обнаруженных рисков безопасности, связанных с этим исполнителем.

Основные причины удаления WasmExecutor связаны с потенциальными уязвимостями и угрозами безопасности. Отчеты о безопасности, такие как те, что представлены на Huntr, выявили ряд критических и высокоприоритетных уязвимостей в smolagents, включая возможности обхода песочницы (Sandbox Escape) и удаленного выполнения кода (Remote Code Execution, RCE) в различных исполнителях. Хотя конкретные детали уязвимостей, напрямую связанных с WasmExecutor, в публичных источниках не разглашаются, очевидно, что решение об удалении было продиктовано необходимостью обеспечения целостности и безопасности платформы smolagents.

С удалением WasmExecutor все ссылки на него в коде, документации и примерах были устранены. Это означает, что разработчики, ранее полагавшиеся на этот исполнитель, должны будут адаптировать свои рабочие процессы. Hugging Face предлагает несколько альтернативных песочниц для безопасного выполнения кода, которые по-прежнему поддерживаются в smolagents. Среди них Blaxel, E2B, Modal и Docker. Эти инструменты предоставляют разработчикам гибкие и безопасные варианты для изоляции и выполнения кода агентов, минимизируя риски, которые были связаны с WasmExecutor.

Выбор альтернативного исполнителя зависит от конкретных требований проекта и предпочтений разработчика. Например, Docker предлагает высокий уровень изоляции и контроля над окружением, в то время как Blaxel и E2B могут предоставлять более интегрированные решения для агентов. Modal также является платформой для выполнения кода в облаке. Документация не раскрывает полных деталей и технических последствий каждой из обнаруженных критических уязвимостей WasmExecutor, которые привели к его удалению.

Что это означает для разработчиков

Эти изменения в smolagents v1.26.0 требуют от разработчиков внимания к обновлению своих проектов. Для текущих пользователей, использующих WebSearchTool, необходимо рассмотреть возможность интеграции Exa для улучшения качества поиска. Это потребует получения EXA_API_KEY и соответствующего обновления кода для указания engine="exa" при инициализации WebSearchTool.

Наиболее существенные изменения коснутся разработчиков, которые ранее полагались на WasmExecutor. Поскольку этот исполнитель был полностью удален, все проекты, зависящие от него, потребуют миграции на одну из поддерживаемых альтернатив, таких как Blaxel, E2B, Modal или Docker. Это может включать пересмотр архитектуры выполнения кода и адаптацию зависимостей. Важно убедиться, что код агентов корректно работает с новым выбранным исполнителем.

Разработчикам рекомендуется внимательно изучить документацию по альтернативным исполнителям, чтобы выбрать наиболее подходящий вариант для своих нужд и обеспечить плавный переход. Проактивное тестирование и адаптация кода к новым стандартам безопасности и функциональности smolagents поможет избежать потенциальных проблем. В источниках не указано, будет ли предоставлена официальная инструкция по миграции для пользователей, зависящих от WasmExecutor.

Что это значит

Выпуск smolagents v1.26.0 включает интеграцию Exa для улучшенных возможностей веб-поиска и удаление WasmExecutor для повышения безопасности. Пользователям WasmExecutor потребуется адаптация к новым исполнителям.