Перейти к основному содержимому
Версия: main

Конфигурация

Названия переменных оставлены без перевода, потому что они используются в командах и файлах окружения.

Базовые настройки​

ПеременнаяЗначение по умолчаниюНазначение
GIGA_AGENT_PREFIX_API/agentВнутренний префикс маршрутов GigaAgent. При запуске через giga_agent dev внешний путь обычно начинается с /api/agent.
GIGA_AGENT_BASE_URLпустоПубличный базовый адрес, если интерфейс должен строить ссылки не от текущего домена.
GIGA_AGENT_FRONTEND_DIRпустоПереопределение каталога веб-интерфейса. Обычно не требуется.
GIGA_AGENT_UItrueВключает отдачу веб-интерфейса серверной частью.
GIGA_AGENT_UI_PREFIXпустоПрефикс веб-интерфейса, если он размещается не в корне.
GIGA_AGENT_RUNTIMElocalРежим выполнения.
GIGA_AGENT_RUNTIME_LOCALfalseПризнак локального режима для рабочей конфигурации интерфейса.
GIGA_AGENT_DATABASE_URLпустоАдрес базы данных SQLAlchemy; без переопределения используется локальная SQLite-база.
GIGA_AGENT_PROJECT_ROOTcwd/.giga_agentРабочий каталог данных GigaAgent.
GIGA_AGENT_HOST_PROJECT_PATHпустоПуть на машине для сценариев с локальной изолированной средой.
GIGA_AGENT_SECRET_KEYпустоСекретный ключ авторизации. Для общего сервера задавайте явно.
GIGA_AGENT_ADMIN_EMAILadmin@example.comПочта начального администратора.
GIGA_AGENT_ADMIN_PASSWORDgiga_agent_adminПароль начального администратора.
GIGA_AGENT_LANGGRAPH_DEV_HOST127.0.0.1Адрес, на котором слушает сервер разработки.
GIGA_AGENT_LANGGRAPH_DEV_PORT9090Порт сервера разработки.
GIGA_AGENT_SKIP_ONBOARDINGfalseУправляет показом начальной настройки.
GIGA_AGENT_SKIP_STARTUP_MIGRATIONSfalseЕсли true, миграции не запускаются при старте.

Ограничения инструментов​

ПеременнаяЗначение по умолчаниюНазначение
GIGA_AGENT_TOOL_MAX_SIZE25000Максимальный размер результата инструмента.
GIGA_AGENT_ENABLE_THINK_TOOLtrueВключает служебный инструмент think, если выбранный провайдер разрешён.
GIGA_AGENT_ENABLE_MULTI_TOOL_USEtrueВключает параллельное использование инструментов, если выбранный провайдер разрешён.
GIGA_AGENT_GIGACHAT_FROM_ENVfalseРазрешает брать параметры GigaChat из окружения.
GIGA_AGENT_GIGACHAT_SKIP_CACHE_TOKENfalseУправляет кэшированием токена GigaChat.

RAG, память и поиск​

ПеременнаяЗначение по умолчаниюНазначение
GIGA_AGENT_SCRAPER_JINA_BASE_URLhttps://r.jina.ai/Базовый адрес сервиса чтения веб-страниц.
GIGA_AGENT_SCRAPER_TOTAL_CONCURRENCY3Общий предел параллельных запросов чтения.
GIGA_AGENT_SCRAPER_DISABLEDfalseОтключает инструмент чтения веб-страниц.
QDRANT_URLвнешний параметрАдрес Qdrant для RAG и памяти.
GIGA_AGENT_QDRANT_POOL_SIZEпустоРазмер пула клиента Qdrant.
GIGA_AGENT_MEM0_QDRANT_ENSURE_CACHEtrueНастройка кэша для памяти и Qdrant.

Изолированная среда​

ПеременнаяЗначение по умолчанию
GIGA_AGENT_LOCAL_SANDBOX_ENABLEDtrue
GIGA_AGENT_LOCAL_DOCKER_IMAGEmikelarg/code-interpreter:0.0.5
GIGA_AGENT_LOCAL_DOCKER_MEMORY_LIMIT_MB2048
GIGA_AGENT_LOCAL_DOCKER_MEMORY_RESERVATION_MB512
GIGA_AGENT_LOCAL_DOCKER_VCPU1.0
GIGA_AGENT_LOCAL_DOCKER_PIDS_LIMIT256
GIGA_AGENT_LOCAL_DOCKER_SHM_SIZE_MB128
GIGA_AGENT_LOCAL_DOCKER_MAX_ACTIVE_SANDBOXES3
GIGA_AGENT_LOCAL_DOCKER_READONLY_ROOTFSfalse
GIGA_AGENT_LOCAL_JUPYTER_STARTUP_TIMEOUT_SEC20
GIGA_AGENT_LOCAL_JUPYTER_GRACEFUL_SHUTDOWN_TIMEOUT_SEC5
GIGA_AGENT_LOCAL_JUPYTER_SECURE_EXEC_DEFAULTfalse
GIGA_AGENT_LOCAL_JUPYTER_SECURE_EXEC_BACKENDauto
GIGA_AGENT_LOCAL_JUPYTER_NETWORK_MODEhost

Подробнее см. Изолированная среда и безопасность.

Лимиты на пользователя​

ПеременнаяЗначение по умолчаниюНазначение
GIGA_AGENT_MAX_ACTIVE_THREADS_PER_USER5Максимум одновременно активных (выполняющихся) диалогов графа на пользователя. Значение 0 или меньше отключает лимит.
GIGA_AGENT_LOCAL_JUPYTER_MAX_KERNELS_PER_USER5Максимум одновременных локальных Jupyter-ядер на пользователя. При достижении лимита перед созданием нового ядра вытесняется наименее недавно использованное ядро того же пользователя. 0 отключает лимит.

OAuth-приложение Яндекса​

Интеграции Яндекса (Почта, Календарь, Диск) подключаются пользователями по OAuth. Для этого администратор один раз регистрирует приложение на oauth.yandex.ru и задаёт его данные переменными окружения:

ПеременнаяНазначение
YANDEX_OAUTH_CLIENT_IDИдентификатор приложения; общий для Календаря и Диска.
YANDEX_OAUTH_CLIENT_SECRETСекрет приложения.
YANDEX_OAUTH_REDIRECT_URIНеобязательный явный адрес обратного вызова; без него собирается из GIGA_AGENT_BASE_URL и префикса программного интерфейса.
YANDEX_OAUTH_CLIENT_ID_YANDEX_MAILОтдельное приложение для Почты: Яндекс требует под почтовую область доступа своё приложение. Без этой пары Почта использует общие данные выше.
YANDEX_OAUTH_CLIENT_SECRET_YANDEX_MAILСекрет почтового приложения.

Пока переменные не заданы, кнопка подключения по OAuth в каталоге коннекторов неактивна, а карточки сервисов подсказывают, как включить приложение. Интеграции при этом работают на ручных токенах.

Каналы​

Боты каналов (Telegram) создаются в Настройки → Каналы: тип канала и токен бота задаются в форме, храниться в переменных окружения им не нужно. Доступ контактам открывается вручную — до одобрения бот не отвечает.

Адреса программного интерфейса​

При giga_agent dev веб-интерфейс получает рабочую конфигурацию из /app-config.js. Обычно она указывает:

{"basePath":"/","apiBasePath":"/api","apiAgentBasePath":"/api/agent"}

Поэтому для запросов из браузера или curl используйте /api/agent/..., хотя внутренние маршруты GigaAgent начинаются с /agent/....

Docker Compose​

docker-compose.yml поднимает nginx, серверную часть, PostgreSQL, Redis, Qdrant и использует .env. Для простого локального запуска обычно достаточно giga_agent dev.

Секретный ключ​

Для общего сервера всегда задавайте GIGA_AGENT_SECRET_KEY явно и используйте длинное случайное значение. Не переиспользуйте демонстрационные значения и не публикуйте секреты в документации или журналах.