Архитектура
GigaAgent состоит из серверной части на FastAPI, графа выполнения LangGraph, модульной системы и встроенного веб-интерфейса React.
Слои
Браузер и веб-интерфейс
├─ страница: /
├─ рабочая конфигурация: /app-config.js
└─ внешний префикс программного интерфейса: /api
Сервер разработки LangGraph (`giga_agent dev`)
├─ маршруты LangGraph: /api/...
└─ маршруты GigaAgent: /api/agent/...
Приложение GigaAgent на FastAPI
├─ внутренний префикс: /agent
├─ основные маршруты: /agent/files, /agent/connectors, /agent/llms, ...
├─ маршруты модулей: /agent/{module.id}/...
└─ BaseAgent + BaseModule + граф LangGraph
Провайдеры
├─ языковая модель и векторные представления
├─ изолированная среда
├─ поиск
└─ генерация изображений
Жизненный цикл BaseAgent
BaseAgent:
- Создаёт приложение FastAPI с обработчиками запуска и остановки.
- Проверяет
GIGA_AGENT_SECRET_KEY. - Подключает основные маршруты с префиксом
GIGA_AGENT_PREFIX_API(/agentпо умолчанию). - Собирает модули из
get_modules()и из переданного спискаmodules. - Проверяет уникальность
module.id. - Подключает маршруты модулей по пути
/agent/{module.id}. - Собирает промежуточные обработчики модулей и системные обработчики.
- Создаёт граф выполнения через
create_graph(). - Запускает миграции, обработчики старта, управление каналами и очистку изолированных сред.
Выполнение графа
create_graph() отвечает за:
- выбор провайдеров через слой разрешения выполнения;
- сбор инструментов агента и инструментов провайдеров;
- добавление MCP-инструментов из состояния диалога;
- привязку инструментов к выбранной языковой модели;
- цикл “модель → инструмент → модель”;
- защиту от повторяющихся циклов;
- промежуточные обработчики и обратные вызовы.
Набор конкретных инструментов зависит от пользователя, настроенных провайдеров, секретов и отключённых модулей.
Графы и подграфы
По умолчанию giga_agent dev использует путь:
giga_agent.agents.run:graph:app
Регистрируются основной граф giga_agent и подграфы субагентов совместимости: landing, presentation, meme, lean_canvas, podcast.
Внутренние и внешние маршруты
Внутри приложения FastAPI маршруты начинаются с /agent. При запуске через giga_agent dev внешний префикс — /api, поэтому из браузера чаще используются пути /api/agent/....
| Назначение | Внутренний путь | Внешний путь при giga_agent dev |
|---|---|---|
| Получить токен | /agent/auth/token | /api/agent/auth/token |
| Файлы | /agent/files | /api/agent/files |
| Коллекции RAG | /agent/rag/collections | /api/agent/rag/collections |
| Память Mem0 | /agent/mem_zero_memory/memories | /api/agent/mem_zero_memory/memories |
Связь с веб-интерфейсом
Веб-интерфейс читает /app-config.js. Обычная конфигурация:
{
"basePath": "/",
"apiBasePath": "/api",
"apiAgentBasePath": "/api/agent"
}
Это позволяет размещать интерфейс и программный интерфейс под разными префиксами без пересборки клиента.