Конфигурация
Названия переменных оставлены без перевода, потому что они используются в командах и файлах окружения.
Базовые настройки
| Переменная | Значение по умолчанию | Назначение |
|---|---|---|
GIGA_AGENT_PREFIX_API | /agent | Внутренний префикс маршрутов GigaAgent. При запуске через giga_agent dev внешний путь обычно начинается с /api/agent. |
GIGA_AGENT_BASE_URL | пусто | Публичный базовый адрес, если интерфейс должен строить ссылки не от текущего домена. |
GIGA_AGENT_FRONTEND_DIR | пусто | Переопределение каталога веб-интерфейса. Обычно не требуется. |
GIGA_AGENT_UI | true | Включает отдачу веб-интерфейса серверной частью. |
GIGA_AGENT_UI_PREFIX | пусто | Префикс веб-интерфейса, если он размещается не в корне. |
GIGA_AGENT_RUNTIME | local | Режим выполнения. |
GIGA_AGENT_DATABASE_URL | пусто | Адрес базы данных SQLAlchemy; без переопределения используется локальная SQLite-база. |
GIGA_AGENT_PROJECT_ROOT | cwd/.giga_agent | Рабочий каталог данных GigaAgent. |
GIGA_AGENT_HOST_PROJECT_PATH | пусто | Путь на машине для сценариев с локальной изолированной средой. |
GIGA_AGENT_SECRET_KEY | пусто | Секретный ключ авторизации. Для общего сервера задавайте явно. |
GIGA_AGENT_ADMIN_EMAIL | admin@example.com | Почта начального администратора. |
GIGA_AGENT_ADMIN_PASSWORD | giga_agent_admin | Пароль начального администратора. |
GIGA_AGENT_LANGGRAPH_DEV_HOST | 127.0.0.1 | Адрес, на котором слушает сервер разработки. |
GIGA_AGENT_LANGGRAPH_DEV_PORT | 9090 | Порт сервера разработки. |
GIGA_AGENT_SKIP_ONBOARDING | false | Управляет показом начальной настройки. |
GIGA_AGENT_SKIP_STARTUP_MIGRATIONS | false | Если true, миграции не запускаются при старте. |
Ограничения инструментов
| Переменная | Значение по умолчанию | Назначение |
|---|---|---|
GIGA_AGENT_TOOL_MAX_SIZE | 25000 | Максимальный размер результата инструмента. |
GIGA_AGENT_GIGACHAT_FROM_ENV | false | Разрешает брать параметры GigaChat из окружения. |
GIGA_AGENT_GIGACHAT_SKIP_CACHE_TOKEN | false | Управляет кэшированием токена GigaChat. |
RAG и поиск
| Переменная | Значение по умолчанию | Назначение |
|---|---|---|
GIGA_AGENT_SCRAPER_JINA_BASE_URL | https://r.jina.ai/ | Базовый адрес сервиса чтения веб-страниц. |
GIGA_AGENT_SCRAPER_TOTAL_CONCURRENCY | 8 | Общий предел параллельных запросов чтения. |
GIGA_AGENT_SCRAPER_DISABLED | false | Отключает инструмент чтения веб-страниц. |
QDRANT_URL | внешний параметр | Адрес Qdrant для RAG и памяти. |
GIGA_AGENT_QDRANT_POOL_SIZE | пусто | Размер пула клиента Qdrant. |
GIGA_AGENT_MEM0_QDRANT_ENSURE_CACHE | true | Настройка кэша для памяти Mem0 и Qdrant. |
Изолированная среда
| Переменная | Значение по умолчанию |
|---|---|
GIGA_AGENT_LOCAL_SANDBOX_ENABLED | true |
GIGA_AGENT_LOCAL_DOCKER_IMAGE | mikelarg/code-interpreter:0.0.5 |
GIGA_AGENT_LOCAL_DOCKER_MEMORY_LIMIT_MB | 512 |
GIGA_AGENT_LOCAL_DOCKER_MEMORY_RESERVATION_MB | 512 |
GIGA_AGENT_LOCAL_DOCKER_VCPU | 0.3 |
GIGA_AGENT_LOCAL_DOCKER_PIDS_LIMIT | 256 |
GIGA_AGENT_LOCAL_DOCKER_MAX_ACTIVE_SANDBOXES | 3 |
GIGA_AGENT_LOCAL_JUPYTER_STARTUP_TIMEOUT_SEC | 20 |
GIGA_AGENT_LOCAL_JUPYTER_GRACEFUL_SHUTDOWN_TIMEOUT_SEC | 5 |
Подробнее см. Изолированная среда и безопасность.
Адреса программного интерфейса
При 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 явно и используйте длинное случайное значение. Не переиспользуйте демонстрационные значения и не публикуйте секреты в документации или журналах.