agno-agi/agno

Build, run, and manage agent platforms.

Агенты⭐ 42 275Pythonпоследний релиз: v3.0.10
Открыть на GitHub ↗Сайт проекта ↗

Что это за инструмент

Agno — это SDK для создания платформ на базе AI-агентов, позволяющая запускать их как production-сервисы с единой панелью управления.

Зачем нужен

Инструмент решает задачу полного контроля над стеком агентов: данными, контекстом, инструментами и правами доступа. Он позволяет развернуть платформу в своем облаке, обеспечивая безопасность, наблюдаемость (tracing) и управление через UI, вместо использования сторонних SaaS-решений.

Что можно реализовать

  • Создание командных ассистентов, интегрированных в Slack (например, Coda).
  • Построение самообучающихся агентов для работы с данными с многоуровневым контекстом (Dash).
  • Разработка агентов для навигации по корпоративным хранилищам, таким как Google Drive и Slack (Scout).
  • Сборка собственной платформы агентов с циклом автоулучшения, управляемой через UI.

Ключевые возможности

  • 50+ production API-эндпоинтов с поддержкой SSE и websockets.
  • Встроенная observability: OpenTelemetry tracing, история запусков и аудит.
  • Безопасность: JWT-based RBAC, изоляция пользователей и мульти-тенантность.
  • 100+ готовых интеграций (toolkits) и поддержка контекстных провайдеров (MCP, Slack, Drive).
  • Возможность развертывания на любом контейнерном хостинге (Docker, AWS, GCP, Railway).

👤 Кому подойдёт: разработчики и технические лиды, строящие собственные AI-платформы с требованиями к безопасности и контролю данных

Релизы

v3.0.10majorbreaking
🕐 4 дн назад · релиз на GitHub ↗

Добавлены Azure OpenAI Responses, Elasticsearch и DocumentationMarkdown; улучшен MCP; исправления багов и ломающие изменения в CodingTools.

  • Added: Добавлена поддержка Azure OpenAI Responses, векторной базы Elasticsearch и трансформации DocumentationMarkdown.
  • Breaking: CodingTools: запуск команд оболочки теперь требует явного разрешения enable_run_shell=True.
  • Breaking: PublicSurface: MCP по умолчанию принимает запросы только с localhost, требуется явное указание доменов.
  • Fixed: Исправлены RemoteAgent.role (теперь свойство), сохранение аудио в MCP, дедупликация событий Slack и чтение потоков.
  • Added: MCPConfig: добавлена настройка root_host, path и path_aliases для маршрутизации.
v3.0.9patch
🕐 12 дн назад · релиз на GitHub ↗

Исправлены логи запуска, инициализация очереди и доступ к Control Plane.

  • Fixed: Очищены логи при запуске и исправлена инициализация хранилища durable queue.
  • Fixed: Восстановлен доступ к Control Plane при использовании публичных поверхностей.
v3.0.8minor
🕐 12 дн назад · релиз на GitHub ↗

Релиз v3.0.8: добавлены полные чтения страниц, фабрики движков PostgreSQL, исправлена целостность сессий SQLite и валидация MCP.

  • Added: Появились методы read_full_page и aread_full_page для чтения целых страниц с ограничением ресурсов и поддержкой пиннинга ревизий.
  • Added: Добавлены фабрики create_postgres_engine и create_async_postgres_engine с настройками пула соединений и сериализации JSON по умолчанию.
  • Added: Опубликован пример использования Magic Hour для генерации изображений и видео через MCP с поддержкой bearer-аутентификации.
  • Fixed: Исправлена ошибка в SQLite, когда массовая вставка сессий могла перезаписать данные чужой сессии из-за отсутствия проверки владельца.
  • Fixed: Устранена проблема валидации публичных MCP: теперь конфигурации с пользовательскими функциями работают без лишних переопределений.
v3.0.7majorbreaking
🕐 13 дн назад · релиз на GitHub ↗

Agno v3.0.7: новые Page Storage, PublicSurface и AIMLAPI, исправления критических багов и ломающие изменения в API Knowledge.

  • Added: Появились Page Storage для работы с документами, PublicSurface для публичного обслуживания агентов и поддержка AIMLAPI с новой моделью gpt-5.6-terra.
  • Added: Зависимости агентов теперь могут принимать run_input и session, а команды PageFileSystem работают в безопасном режиме без доступа к shell.
  • Fixed: Исправлены критические сбои в Meta Llama и AIMLAPI, сохранение пустых аргументов инструментов в Anthropic и утечка диагностических данных в JSON-ответах.
  • Fixed: Устранена утечка памяти в Python 3.13 из-за кэширования обёрток инструментов и улучшена обработка ошибок шагов в Workflows.
  • Breaking: Аргументы конструктора Knowledge теперь должны передаваться только как именованные параметры, а positional вызовы больше не поддерживаются.
v3.0.6minor
🕐 17 дн назад · релиз на GitHub ↗

Релиз v3.0.6: добавлена безсессионная работа MCP, поддержка .zip/.eml и исправления для Anthropic и Gemini.

  • Added: Добавлена безсессионная работа MCP (Stateless MCP serving) для упрощения масштабирования.
  • Added: Появилась возможность загружать архивы .zip и файлы .eml в AgentOS.
  • Added: Внедрен MCP Server Card для публикации метаданных и списка доступных инструментов.
  • Added: Добавлена поддержка передачи собственного async-клиента для моделей Bedrock.
  • Fixed: Исправлена ошибка отклонения блоков размышления (thinking blocks) в моделях Anthropic.
  • Fixed: Исправлено определение MIME-типа изображений для Gemini и устранены дубликаты в RecursiveChunking.
v3.0.5majorbreaking
🕐 20 дн назад · релиз на GitHub ↗

v3.0.5: явная обработка ошибок эмбеддинга, статус partial, новые провайдеры и инструменты, исправления безопасности.

  • Breaking: Ошибки эмбеддинга теперь явно возвращаются, а не маскируются; добавлен статус ContentStatus.PARTIAL.
  • Breaking: Изменена обработка исключений: Bedrock теперь вызывает EmbeddingError, а не ModelProviderError.
  • Added: Добавлены новые провайдеры моделей llmman и инструменты GandrTools для синтеза речи.
  • Fixed: Исправлена логика повторного импорта: документ больше не теряет данные при сбое эмбеддинга.
  • Added: Добавлена опциональная настройка повторов при ошибках эмбеддинга во время ingestion.
v3.0.4minorbreaking
🕐 21 дн назад · релиз на GitHub ↗

v3.0.4: переименование флагов KnowledgeManagementTools, оптимизация AtomicMail и исправление багов.

  • Breaking: Переименованы флаги конструктора KnowledgeManagementTools; ingest_path теперь отключен по умолчанию.
  • Added: AtomicMail кэширует авторизацию и распараллеливает proof-of-work, что ускоряет вызовы с 35 с до 0,4–3 с.
  • Fixed: Исправлен list_inbox в AtomicMail: теперь фильтруются собственные черновики агента.
  • Fixed: Исправлено игнорирование requires_confirmation_tools для remove_content в KnowledgeManagementTools.
  • Added: Модули agno.tools.file и agno.tools.knowledge теперь являются пакетами с ленивой загрузкой зависимостей.
v3.0.3major
🕐 21 дн назад · релиз на GitHub ↗

В Agno v3.0.3 добавлено постраничное и файловое индексирование с умным обновлением, а также инструменты управления знаниями.

  • Added: Постраничное индексирование сайтов: каждая страница хранится отдельно, поддерживается инкрементальное обновление и точечное удаление.
  • Added: Индексация папок и файлов: структура каталогов сохраняется в виде иерархии строк с изоляцией ошибок и автоматическим удалением исчезнувших файлов.
  • Added: Новые инструменты KnowledgeManagementTools: добавлены функции для управления базой знаний, включая ingest, list, refresh и remove.
  • Added: Добавлены SitemapReader и PageFetcher для надежной обхода сайтов с поддержкой параллельных запросов, отложенных повторов и обработки PDF.
  • Fixed: Исправлено удаление векторов при удалении страниц сайта и устранены ошибки при повторной попытке продвижения устаревших записей.
v3.0.2majorbreaking
🕐 22 дн назад · релиз на GitHub ↗

v3.0.2: новые провайдеры и инструменты, интеграция компонентов в MCP, строгая валидация конфигураций и обновлённая логика определения reasoning.

  • Breaking: Изменён приоритет метаданных: аргумент run() теперь важнее атрибута компонента, а сессия больше не перезаписывает общие значения.
  • Added: Добавлены провайдеры Synthorai и инструменты WaveSpeed (генерация медиа), Serply (поиск) и AtomicMail (почта).
  • Added: Agent, Team и Workflow теперь можно публиковать как именованные MCP-инструменты, а Toolkit-ы автоматически разворачиваются в отдельные методы.
  • Breaking: MCPConfig и MCPServerConfig теперь строго проверяют поля: неизвестные аргументы вызывают ошибку при инициализации.
  • Fixed: Обновлена логика определения reasoning-моделей: теперь запрашивается провайдер, а не только сравнивается ID модели.
v3.0.1patch
🕐 26 дн назад · релиз на GitHub ↗

Agno v3.0.1: ускорены запуски агентов и длинные диалоги, исправлены ошибки Gemini, MCP и зависимостей.

  • Added: Кэширование схем инструментов и инкрементальная загрузка истории сессии значительно ускорили работу агентов с большим набором инструментов и в длинных диалогах.
  • Fixed: Исправлена ошибка KeyError при обработке строгих схем инструментов без свойства properties, например в MCP-серверах.
  • Fixed: Время ожидания запросов к PubMed теперь настраивается, предотвращая зависание вызовов инструментов.
  • Fixed: Исправлена передача медиафайлов (изображений, документов) в ответах инструментов для моделей Gemini 3+ и новее.
  • Fixed: Заменена зависимость requests на httpx для определения геолокации, что устраняет ошибки при установке без дополнительных пакетов.
v3.0.0majorbreaking
🕐 28 дн назад · релиз на GitHub ↗

Breaking v3.0: изоляция по пользователям, таблица runs, offload результатов и медиа, CodeMode, Studio 3.0 и фоновые задачи.

  • Breaking: Требуется миграция БД: запуск до обновления сломает работу, так как требуется обновление схемы.
  • Added: Полная изоляция по пользователям: метрики, расписания, знания и 17 векторных баз теперь разделены для каждого пользователя.
  • Added: Новая таблица agno_runs: оптимизация записи сессий, прямые API для ранов и автоматическая миграция.
  • Added: Offload результатов и медиа: большие ответы инструментов и файлы сохраняются во внешние хранилища, экономя место.
  • Added: CodeMode: выполнение Python-кода через IPython-ядро внутри сессии без лишних вызовов модели.
  • Added: AgentOS и Studio 3.0: надежные фоновые задачи с гарантией доставки и каталог компонентов с версионированием.
v2.9.0majorbreaking
🕐 1 мес назад · релиз на GitHub ↗

В Agno v2.9.0 добавлен StudioRunnerTools, усилены безопасность кэширования и валидация при десериализации компонентов.

  • Added: Появился StudioRunnerTools для безопасного запуска агентов Studio с привязкой к пользователю.
  • Breaking: Запрещено переопределение имени MCP-инструмента во время вызова для предотвращения обхода проверок безопасности.
  • Breaking: Кэширование результатов инструментов теперь использует ключи на основе user_id, что устраняет утечку данных между пользователями.
  • Breaking: Десериализация компонентов с неразрешимыми ссылками теперь вызывает ошибку 422 вместо тихого падения.
  • Fixed: Исправлена потеря метаданных в A2A, сохранение состояния HITL при перезагрузке сессии и honor версии воркфлоу через WebSocket.
v2.8.7minor
🕐 1 мес назад · релиз на GitHub ↗

Релиз v2.8.7: новые инструменты AdvisorTools, OpenRouteService и StudioTools, исправления для Cohere, SQLite и аудио.

  • Added: Добавлены AdvisorTools для получения обратной связи от моделей-советников.
  • Added: Появился OpenRouteService Toolkit для точного маршрутизации.
  • Added: StudioTools получили инструменты планирования с учетом компонентов и параметры истории.
  • Fixed: Исправлено игнорирование нулевых значений параметров семплирования в Cohere (temperature, top_k и др.).
  • Fixed: Устранен сбой Team.load в SQLite из-за аргумента label и улучшена обработка результатов аудио-инструментов.
v2.8.6minor
🕐 1 мес назад · релиз на GitHub ↗

Добавлена поддержка Smallest AI TTS и OpenSearch, исправлено блокирование воркеров при обновлении метрик.

  • Added: Добавлен SmallestTools для синтеза речи (TTS) с поддержкой моделей lightning_v3.1 и lightning_v3.1_pro.
  • Added: Реализована поддержка векторной базы данных OpenSearch с синхронным и асинхронным поиском.
  • Added: В AgentOS добавлен эндпоинт для отслеживания статуса фоновых обновлений метрик.
  • Fixed: Исправлено блокирование воркеров uvicorn при обновлении метрик на больших наборах данных.
  • Fixed: Указано явное кодирование UTF-8 для файлов, чтобы обеспечить кроссплатформенную совместимость.
v2.7.1patch
🕐 2 мес назад · релиз на GitHub ↗

Выпуск версий agno 2.7.1 и agnoctl 0.1.1.

  • Обновлены версии пакетов agno до 2.7.1 и agnoctl до 0.1.1.
v2.7.0majorbreaking
🕐 2 мес назад · релиз на GitHub ↗

Релиз v2.7.0: запуск CLI agnoctl, сервисные аккаунты, MCP v2 с 8 инструментами и улучшенная авторизация.

  • Added: Новый CLI agnoctl для управления AgentOS, создания проектов и подключения клиентов через MCP.
  • Added: Сервисные аккаунты (PAT) с автоматической выдачей токенов и безопасным хранением.
  • Added: MCP Interface v2: сокращение поверхности до 8 инструментов и поддержка HITL-жизненного цикла.
  • Added: Пакет eval_suite_runner для запуска тестов с числовой оценкой и CLI-интеграцией.
  • Breaking: MCP-инструменты для работы с памятью удалены; клиенты должны использовать REST-эндпоинты.
  • Breaking: AgentOS с authorization=True теперь требует явного указания JWT-ключей при инициализации.
v2.6.22minor
🕐 2 мес назад · релиз на GitHub ↗

Добавлены инструменты TwelveLabs, Sofya и SearchAPI; улучшена работа таймаутов и исправлены ошибки безопасности.

  • Added: Добавлены инструменты TwelveLabs для анализа видео, Sofya для поиска и исследований, а также SearchAPI с поддержкой Google, новостей, изображений и YouTube.
  • Added: В базовый класс Toolkit добавлен параметр timeout, который теперь применяется ко многим инструментам для управления HTTP-запросами.
  • Fixed: Исправлена ошибка безопасности: устранена возможность обхода путей (path traversal) в инструментах AirflowTools.
  • Fixed: Поле created_at в ModelResponse теперь формируется для каждого экземпляра, а не при импорте; исправлен поиск по полнотекстовому индексу в DuckDbTools.
  • Fixed: Ответы от модели-запасного варианта теперь корректно сохраняются в истории сессии.
v2.6.21patch
🕐 2 мес назад · релиз на GitHub ↗

Исправлены критические баги MCP, асинхронных сессий и безопасности; улучшена работа с файлами и Google Drive.

  • Fixed: Устранена потеря инструментов MCP в Registry и исправлены ошибки при переподключении.
  • Fixed: Исправлено падение сессий Workflow при использовании асинхронных баз данных.
  • Fixed: Устранена утечка заголовков аутентификации в CustomApiTools.
  • Added: В LocalFileSystemTools добавлено чтение файлов и ограничение операций целевой директорией.
  • Fixed: Исправлено экранирование кириллицы в JSON и проблемы с именами файлов в Google Drive и CSV.
v2.6.20minor
🕐 2 мес назад · релиз на GitHub ↗

Добавлена поддержка ClickHouse для трассировок, интеграция Scavio, улучшения OpenAI и LiteLLM, ряд исправлений.

  • Added: Добавлена поддержка ClickHouse для высоконагруженной загрузки трасс и OLAP-аналитики.
  • Added: Появился новый поисковый тулкит Scavio.
  • Added: OpenAI теперь возвращает цитаты из веб-поиска через response.citations.
  • Added: LiteLLM поддерживает нативные структурированные выводы и JSON-схемы.
  • Fixed: Исправлен подсчет токенов для сжатия результатов с числовыми enum-параметрами.
  • Fixed: Устранена проблема с переиспользованием изменяемого списка по умолчанию в Toolkit и Searxng.