Модули
Модуль — единица расширения GigaAgent. Он может добавлять маршруты, модели базы данных, миграции, инструменты, системные инструкции, секреты, промежуточные обработчики, подграфы и обработчики запуска.
Контракт BaseModule
Основные поля и методы:
id— уникальный идентификатор модуля;label,description,icon— сведения для интерфейса;get_api_router()— маршруты FastAPI;get_models()— модели SQLAlchemy для миграций;_get_tools()/get_tools()— инструменты модуля;get_instructions()— добавления к системной инструкции;extend_task()— расширение пользовательской задачи перед запуском;get_secrets()— сведения о нужных секретах;get_middleware()— промежуточные обработчики агента;get_subgraphs()— точки входа подграфов LangGraph;is_enabled()— доступность модуля для пользователя;on_startup()— обработчик запуска.
Если у модуля непустой label, обёртка get_tools() помечает пользовательские инструменты через extras["module_id"], чтобы граф мог фильтровать инструменты отключённых модулей.
Активные модули
giga_agent dev загружает 21 модуль (порядок соответствует GigaAgent.get_modules()):
AuthModule— авторизация, пользователи и токены.ClarifyModule— уточняющие вопросы: инструментask_questionsпоказывает пользователю вопросы с вариантами ответа.ReplModule— выполнение кода в изолированной среде.ImageModule— генерация изображений.AnalyzeImagesModule— анализ изображений.IOModule— чтение, запись, редактирование и удаление файлов через инструменты агента.ProjectsModule— проекты: маршруты управления проектами и подстановка инструкций проекта в системную инструкцию.ScraperModule— чтение веб-страниц.SearchModule— поиск.RagModule— коллекции документов и поиск по ним.MemoryModule— долговременная память и поиск по записям памяти; живёт в пакетеgiga_agent/memory.SkillsModule— пользовательские навыки агента и чтение манифестов навыков.McpModule— подключение внешних MCP-серверов и вызов их инструментов; включает каталог готовых серверов (modules/mcp/catalog.json).VKModule— интеграция с VK.YandexDiskModule— работа с файлами и папками на Яндекс.Диске.YandexMailModule— чтение и отправка писем в Яндекс.Почте.YandexCalendarModule— просмотр и создание событий в Яндекс.Календаре.WeatherModule— прогноз погоды.DeepResearchModule— глубокое исследование: план, поиск, чтение и отчёт с источниками.SchedulerModule— задачи по расписанию: создание и отмена из чата, доставка результата в выбранный чат.SubAgentLegacyModule— субагенты совместимости и их подграфы.
Модули внешних сервисов собраны в пакете modules/integrations/. Каждый из них несёт собственную авторизацию OAuth (auth.py, provider.py); пользователь включает такой сервис через каталог подключений в интерфейсе. Прежний GitHubModule удалён из репозитория: интеграция с GitHub выполняется через сервер GitHub из каталога MCP.
Маршруты модулей
Если get_api_router() возвращает маршрутизатор, BaseAgent монтирует его под:
{GIGA_AGENT_PREFIX_API}/{module.id}
При стандартном префиксе внутри приложения это /agent/{module.id}. При запуске через giga_agent dev внешний путь обычно:
/api/agent/{module.id}
Примеры:
/api/agent/auth/token;/api/agent/rag/collections;/api/agent/memory/...;/api/agent/skills/....
Точный набор маршрутов зависит от того, какие модули возвращают get_api_router(), а набор инструментов — от настроенных провайдеров, секретов и прав пользователя.