phidatahq/phidata

Создание, запуск и управление платформами для агентов.

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

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

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

Зачем нужен

Инструмент позволяет разработчикам полностью контролировать стек агентов, включая данные, память и безопасность, превращая платформу в обучающуюся систему. Он упрощает развертывание агентов как сервиса через REST API и предоставляет готовые шаблоны для быстрого старта на различных облачных платформах.

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

  • Создание кастомной платформы для управления множеством AI-агентов с единым интерфейсом
  • Развертывание агентов с поддержкой многопользовательского доступа и изоляцией данных (multi-tenant)
  • Интеграция агентов с внешними сервисами через 100+ готовых инструментов (GitHub, Slack, Postgres)
  • Настройка планировщика задач (cron) и фоновых процессов для агентов без дополнительной инфраструктуры
  • Обеспечение безопасности через JWT-аутентификацию и контроль доступа (RBAC) на уровне платформы

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

  • Готовая production API с 50+ эндпоинтами, поддержкой SSE и websockets
  • Встроенная observability: мониторинг через OpenTelemetry, история запусков и аудит
  • Поддержка human-in-the-loop: возможность приостанавлить выполнение агента для подтверждения пользователем
  • Гибкое хранение данных: сессии, память, знания и трассировки сохраняются в собственной базе данных (Postgres)
  • Множество вариантов деплоя: Docker, Railway, AWS, GCP, Azure, Fly.io, Render, Modal, Helm

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

Релизы

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

Добавлены Azure OpenAI Responses, Elasticsearch и поддержка текстовых потоков; run_shell в CodingTools теперь требует явного разрешения.

  • Added: Добавлена поддержка Azure OpenAI Responses API и векторной базы данных Elasticsearch.
  • Added: Внедрен трансформер DocumentationMarkdown для конвертации Mintlify и Fumadocs в чистый Markdown.
  • Added: Читатели TextReader, MarkdownReader и FieldLabeledCSVReader теперь принимают текстовые потоки.
  • Breaking: Метод run_shell в CodingTools переведен в режим опционального включения (enable_run_shell=True).
  • Fixed: Исправлена работа RemoteAgent.role, сохранение аудио в MCP и сериализация булевых значений в DynamoDB.
v3.0.9patch
🕐 12 дн назад · релиз на GitHub ↗

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

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

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

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

v3.0.7: Page storage, PublicSurface, AIMLAPI, исправления Llama/Anthropic и утечек памяти.

  • Added: Добавлено Page storage для атомарной публикации знаний и PublicSurface для публичного обслуживания агентов и MCP.
  • Added: Поддержка AIMLAPI с новым заголовком атрибуции и базовой моделью gpt-5.6-terra.
  • Breaking: Аргументы конструктора Knowledge теперь только именованные; positional вызовы больше не поддерживаются.
  • Fixed: Исправлены краши Meta Llama и AIMLAPI из-за несовместимости сигнатуры _format_message.
  • Fixed: Устранена утечка памяти в Python 3.13, связанная с кэшированием обёрток инструментов.
v3.0.6minor
🕐 17 дн назад · релиз на GitHub ↗

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

  • Added: Бессессионный режим MCP (stateless) для масштабирования без привязки сессий.
  • Added: Поддержка загрузки .zip и .eml файлов в AgentOS.
  • Added: Новый эндпоинт /mcp/server-card с метаданными и списком инструментов.
  • Fixed: Исправлен отброс блоков размышления у Anthropic и MIME-типов изображений в Gemini.
  • Fixed: Исправлена дублирующая генерация чанков в RecursiveChunking и ошибки потоковой передачи в AG-UI.
v3.0.5majorbreaking
🕐 20 дн назад · релиз на GitHub ↗

v3.0.5: явное отображение ошибок эмбеддинга, статус partial, ретраи и новые GandrTools/llmman.

  • Breaking: Ошибки эмбеддинга теперь явно возвращаются, а не маскируются как успех; добавлен статус partial.
  • Breaking: Векторные БД и Bedrock теперь выбрасывают EmbeddingError вместо пустых результатов или ModelProviderError.
  • Added: Добавлена опциональная поддержка ретраев при эмбеддинге через параметры Knowledge.
  • Added: Появились новые инструменты GandrTools для TTS и провайдер моделей llmman.
  • Fixed: Исправлена логика re-ingest: защита embed_before_replace предотвращает потерю данных при сбоях.
v3.0.4majorbreaking
🕐 21 дн назад · релиз на GitHub ↗

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

  • Breaking: В KnowledgeManagementTools переименованы флаги конструктора (ingest_url, ingest_path и др.), старые имена больше не поддерживаются.
  • Breaking: Изменён путь импорта: KnowledgeManagementTools теперь находится в agno.tools.knowledge, старый модуль удалён.
  • Added: agno.tools.file и agno.tools.knowledge оформлены как пакеты с ленивой загрузкой зависимостей для ускорения импорта.
  • Added: AtomicMail кэширует результаты аутентификации и распараллеливает вычисление proof-of-work, что значительно ускоряет работу.
  • Fixed: Исправлен баг в AtomicMail: list_inbox теперь корректно фильтрует собственные отправленные сообщения агента.
  • Fixed: Исправлена логика requires_confirmation_tools: теперь пользовательские списки объединяются с внутренними, сохраняя защиту remove_content.
v3.0.3major
🕐 21 дн назад · релиз на GitHub ↗

Переработано управление знаниями: постраничное индексирование сайтов, папок, новые инструменты и API.

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

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

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

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

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

Крупный релиз с ломающими изменениями: новая таблица runs, оффлоад результатов и медиа, CodeMode, изоляция по пользователям и улучшенный AgentOS.

  • Breaking: Требуется миграция базы данных: добавлена таблица agno_runs, что снижает нагрузку на запись и меняет структуру хранения сессий.
  • Added: Оффлоад результатов инструментов и медиа: длинные ответы и файлы сохраняются во внешние хранилища (S3, GCS, AgentFS) для оптимизации размера сообщений.
  • Added: CodeMode: новый режим работы, позволяющий модели писать и выполнять Python-код через IPython-ядро без лишних вызовов API.
  • Added: Изоляция по пользователям: данные, метрики, знания и векторные базы теперь разделяются на уровне пользователей.
  • Added: AgentOS: добавлена надежная фоновая очередь выполнения (durable background execution) с поддержкой idempotency и отменой задач.
v2.9.0majorbreaking
🕐 1 мес назад · релиз на GitHub ↗

В Phidata v2.9.0 добавлен StudioRunnerTools, усилен MCP-безопасность и кэширование, а загрузка компонентов стала строгой.

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

Релиз v2.8.7: новые инструменты (Advisor, OpenRouteService, Studio), исправление ошибок SQLite, Cohere и аудио.

  • Added: Добавлены AdvisorTools для получения обратной связи от моделей-советников.
  • Added: Появился OpenRouteService Toolkit для точного маршрутизации.
  • Added: StudioTools получили инструменты планирования с учетом компонентов и параметры истории.
  • Fixed: Исправлен сбой Team.load в SQLite из-за аргумента label.
  • Fixed: Cohere теперь корректно обрабатывает нулевые значения параметров (temperature, top_k и др.).
  • Fixed: Улучшена обработка результатов аудио-инструментов и исключен конфликт с nltk 3.10.1.