Перейти к основному содержимому
Версия: 0.1.9 (PyPI)

Архитектура

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:

  1. Создаёт приложение FastAPI с обработчиками запуска и остановки.
  2. Проверяет GIGA_AGENT_SECRET_KEY.
  3. Подключает основные маршруты с префиксом GIGA_AGENT_PREFIX_API (/agent по умолчанию).
  4. Собирает модули из get_modules() и из переданного списка modules.
  5. Проверяет уникальность module.id.
  6. Подключает маршруты модулей по пути /agent/{module.id}.
  7. Собирает промежуточные обработчики модулей и системные обработчики.
  8. Создаёт граф выполнения через create_graph().
  9. Запускает миграции, обработчики старта, управление каналами и очистку изолированных сред.

Выполнение графа​

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"
}

Это позволяет размещать интерфейс и программный интерфейс под разными префиксами без пересборки клиента.