AIKraft Agents

phidatahq/phidata

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

Агенты⭐ 43 076Pythonпоследний релиз: v3.1.12
Открыть на 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.1.12minor
🕐 7 дн назад · релиз на GitHub ↗

В Phidata v3.1.12 добавлены нативные аппрувы для Harness, отключаемые рутины и графики с заголовками, а также исправлены трассировка FastAPI и ошибки в оценках.

  • Added: Нативные аппрувы для Harness Agents: запросы разрешений от Claude и Codex теперь интегрированы в UI, поддерживая сохранение состояния, отмену и работу в песочнице без перезапуска промптов.
  • Added: Отключаемые Company Routines: теперь можно создавать рутины с enabled=False, которые видны в интерфейсе, но пропускаются планировщиком, пока пользователь не включит их вручную.
  • Added: Заголовки на графиках: ChartTools.create_chart() теперь поддерживает отображение итогового значения (например, суммы или процента) рядом с заголовком диаграммы.
  • Fixed: Исправлена трассировка FastAPI: приложение больше не конфликтует с собственным OpenTelemetry-трейсингом фреймворка, что восстанавливает корректное отображение Runs в интерфейсе.
  • Fixed: Исправлена логика отмены рутин: статус cancelled теперь фиксируется только на основе достоверных данных, предотвращая некорректные действия с архивом или исполнителем во время работы агента.
  • Fixed: Исправлен AccuracyEval Judge: устранена ошибка 404 при использовании модели o4-mini, которая была отключена провайдером, позволяя оценкам корректно завершаться.
v3.1.11minor
🕐 9 дн назад · релиз на GitHub ↗

Агенты Claude и Codex теперь поддерживаются в командах и рабочих процессах, добавлен поиск сессий и улучшено управление задачами.

  • Added: ClaudeAgent и CodexAgent можно использовать как участников команд и шаги рабочих процессов, включая параллельные и условные ветвления.
  • Added: Добавлен поиск сессий с поддержкой вложенных фильтров (AND/OR/NOT) по имени, ID, типу и временным меткам.
  • Added: Расширены возможности управления задачами: теперь можно создавать задачи в статусе Backlog, Ready или Cancelled и редактировать их заголовок.
  • Fixed: Исправлено сохранение типов данных (int, bool) в результатах шагов рабочих процессов после перезагрузки сессии.
  • Fixed: Устранена ошибка в ReaderFactory, из-за которой кэшированный ридер игнорировал параметры конфигурации.
v3.1.10patch
🕐 13 дн назад · релиз на GitHub ↗

Исправления в CodexAgent, OS Manager, загрузке знаний и трассировке.

  • Fixed: CodexAgent теперь автоматически авторизуется через OPENAI_API_KEY, сохраняя существующие сессии.
  • Fixed: OS Manager научился обнаруживать и запускать внешние агенты, зарегистрированные в AgentOS.
  • Fixed: POST /knowledge/content возвращает понятный 400-й код при отсутствии файла, текста или некорректного URL.
  • Fixed: Трассировка теперь сохраняет до 1024 атрибутов, что позволяет хранить полную историю сообщений.
v3.1.9minor
🕐 14 дн назад · релиз на GitHub ↗

Добавлен HTTP-запуск MCP-инструментов, исправлены ошибки в Mistral, AgenticChunking и Human-in-the-Loop.

  • Added: Появился MCP Tool Runner для запуска инструментов через HTTP без клиента.
  • Fixed: Исправлены параметры timeout, endpoint и safe_mode в MistralChat.
  • Fixed: AgenticChunking больше не зависает при некорректных значениях breakpoint.
  • Fixed: Human-in-the-Loop корректно обрабатывает типы параметров int | None.
  • Deprecated: Параметр safe_mode в Mistral устарел, используйте safe_prompt.
v3.1.8minorbreaking
🕐 15 дн назад · релиз на GitHub ↗

Добавлен PostgresCheckpointStore, изменено поведение по умолчанию для Claude и улучшено управление чекпоинтами песочниц.

  • Added: Появился PostgresCheckpointStore для хранения чекпоинтов песочниц в PostgreSQL без зависимости от S3.
  • Breaking: По умолчанию сохраняются только три последних чекпоинта сессии; для прежнего поведения нужен retain_checkpoints=None.
  • Added: Company Routines теперь могут использовать Product Manager или OS Manager в качестве исполнителей.
  • Deprecated: Claude() теперь по умолчанию использует claude-sonnet-5-5 вместо устаревающего claude-sonnet-4-5-20250929.
  • Fixed: Исправлено зависание сессий при потере чекпоинтов и ошибки в Company Routine Execution.
v3.1.7minor
🕐 16 дн назад · релиз на GitHub ↗

Ограничение вызовов инструментов в OS Manager, исправление миграции Postgres, стабильность чекпоинтов и обновление модели Cartesia.

  • Added: OS Manager теперь поддерживает лимиты tool_call_limit и member_tool_call_limit для контроля использования инструментов.
  • Added: CartesiaTools по умолчанию переключены на модель sonic-3.6 в связи с устареванием sonic-2.
  • Fixed: Исправлена миграция сессий в запуски на Postgres: теперь используется курсор, что исключает нехватку памяти.
  • Fixed: Решены проблемы с чекпоинтами: исправлен захват виртуальных окружений и корректное освобождение сессий при ошибках.
  • Fixed: Устранены ошибки в Company Routines и расчете метрик Postgres, превышающих лимит параметров драйвера.
v3.1.6minor
🕐 17 дн назад · релиз на GitHub ↗

v3.1.6: улучшены аргументы Case для eval, исправлена работа ParallelTools и поиск результатов OS Manager.

  • Added: Case в eval теперь принимает session_id, user_id, metadata и другие аргументы, а input поддерживает Message для прикрепления файлов.
  • Added: OS Manager теперь напрямую запрашивает документацию Agno, сохраняя контекст задачи строго в рамках вопроса.
  • Fixed: Исправлена ошибка копирования агентов с ParallelTools: теперь SDK-клиенты сохраняются корректно без ошибок RLock.
  • Fixed: Улучшен поиск и чтение результатов: search_result возвращает отдельные фрагменты, а read_result поддерживает ограничение по символам.
v3.1.5minor
🕐 17 дн назад · релиз на GitHub ↗

Релиз v3.1.5: добавлена поддержка репозиториев для песочниц, S3-чекпоинтов, поиск Keenable и исправления багов.

  • Added: Репозитории для песочниц: агенты теперь работают в изолированных репозиториях с фиксацией коммитов и поддержкой приватных репозиториев.
  • Added: S3 Checkpoint Store: сохранение чекпоинтов в S3-совместимые хранилища для работы агентов на нескольких репликах без общей файловой системы.
  • Added: KeenableTools: новый инструмент для веб-поиска и извлечения контента без необходимости API-ключа.
  • Added: Отложенные расписания: возможность создания задач, которые запускаются только по триггеру, без автоматического выполнения по cron.
  • Fixed: Исправлена работа с файлами внутри шагов Workflow (Parallel, Loop и др.) и поддержка FastAPI 0.147.
v3.1.4major
🕐 20 дн назад · релиз на GitHub ↗

Запуск песочниц для ClaudeAgent и CodexAgent с поддержкой Docker и Amazon Bedrock AgentCore, включая сохранение состояния и функции warm turns.

  • Added: Sandboxed Harness Agents: ClaudeAgent и CodexAgent теперь поддерживают параметр sandbox, запускаясь в изолированных сессиях с сохранением состояния.
  • Added: Docker Sandbox: реализован безопасный провайдер DockerSandbox с ограничением прав, изолированной сетью и поддержкой чекпоинтов.
  • Added: Amazon Bedrock AgentCore Sandbox: добавлена поддержка AgentCoreSandbox на базе Firecracker microVM с интеграцией чекпоинтов.
  • Added: Warm Sandbox Turns: координатор сохраняет компьютер сессии на время warm_computer_seconds для ускорения повторных запусков.
v3.1.3minor
🕐 24 дн назад · релиз на GitHub ↗

Внешние агенты (Claude, Codex) получили устойчивость сессий, фоновый запуск, откаты, метрики и структурированный вывод.

  • Added: Durable External Agent Sessions: сессии ClaudeAgent теперь сохраняются в БД (Postgres, SQLite) и могут быть возобновлены на любом реплике.
  • Added: Background Runs & Cancellation: добавлена поддержка фоновых задач и отмены через API для ClaudeAgent и CodexAgent.
  • Added: Step Replay: реализован механизм отката (continue_run) для ClaudeAgent с возможностью ветвления и сохранения чекпоинтов.
  • Added: Retries: внешние агенты теперь поддерживают автоматические повторные попытки с экспоненциальной задержкой и сохранением контекста.
  • Added: Metrics & Compaction: добавлена сборка метрик (токены, стоимость, задержка) и поддержка компрессии сессий для внешних агентов.
  • Added: Structured Output: внедрена поддержка структурированного вывода (Pydantic/JSON Schema) для ClaudeAgent и CodexAgent.
v3.1.2minor
🕐 28 дн назад · релиз на GitHub ↗

В Phidata v3.1.2 добавлена компактизация диалогов, агент Codex, HyDE-поиск и поддержка Heabsy/FlexAI.

  • Added: Conversation Compaction: сжатие длинных сессий в контекстном окне с возможностью восстановления и поиска по архиву.
  • Added: CodexAgent: новый адаптер для OpenAI Codex с поддержкой песочницы, одобрения и MCP-конфигурации.
  • Added: HyDE Query Transform: поиск по гипотетическому ответу для улучшения релевантности в Knowledge.
  • Added: Поддержка новых провайдеров Heabsy и FlexAI, а также инструментов SixtyDBTools для генерации речи.
  • Fixed: Исправлена работа кэша ответов и записей одобрений для нескольких вызовов в одном запуске.
v3.1.1minor
🕐 1 мес назад · релиз на GitHub ↗

v3.1.1: улучшена синхронизация знаний с прогрессом и отменой, исправлены ошибки при скачивании страниц и парсинге Mintlify.

  • Added: Добавлен живой прогресс и возможность отмены синхронизации страниц через stream_sync_pages и on_progress.
  • Added: В отчётах о синхронизации теперь указываются имена и причины ошибок для неудавшихся страниц.
  • Fixed: Исправлено повторное выполнение запросов с экспоненциальной задержкой для устранения сбоев соединения.
  • Fixed: Улучшена синхронизация сайтов на базе Mintlify: исправлено распознавание страниц, вложенных индексов и редиректов.
v3.1.0majorbreaking
🕐 1 мес назад · релиз на GitHub ↗

В Phidata v3.1.0 добавлены RBAC и файловая система, исправлены баги, изменена логика MCP-инструментов.

  • Added: Добавлен RBAC через пакет agno.os.authz и файловая система DbFileSystem с таблицей agno_fs.
  • Breaking: Таблица agno_fs переключена на составной ключ; требуется ручная миграция скриптами при остановленном приложении.
  • Breaking: MCP-инструменты по умолчанию отключены; теперь требуется явное указание в конфигурации.
  • Added: Появился набор инструментов AIMLAPITools для работы с изображениями, видео, речью и транскрипцией.
  • Fixed: Исправлены ошибки в HITL, OpenAIResponses, структурированном выводе, чтении CSV и работе с GithubTools.
v3.0.10minorbreaking
🕐 1 мес назад · релиз на 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
🕐 1 мес назад · релиз на GitHub ↗

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

  • Fixed: Очищены логи при запуске и инициализировано хранилище durable-очередей.
  • Fixed: Исправлено сохранение доступа к Control Plane при использовании публичных поверхностей.
v3.0.8minor
🕐 1 мес назад · релиз на 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
🕐 1 мес назад · релиз на 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
🕐 2 мес назад · релиз на 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
🕐 2 мес назад · релиз на 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
🕐 2 мес назад · релиз на 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
🕐 2 мес назад · релиз на GitHub ↗

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

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

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

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