Возможности и требования
GigaAgent состоит из базового веб-интерфейса и набора подключаемых возможностей. Часть функций доступна сразу после запуска, но большинство полезных сценариев требует настроенных провайдеров.
Краткая таблица
| Возможность | Работает сразу? | Что нужно настроить |
|---|---|---|
| Вход в веб-интерфейс | Да | Ничего для локальной установки |
| Обычный чат | Нет | Коннектор и языковую модель |
| Потоковая выдача ответа | Да, после выбора модели | Языковую модель |
| Загрузка файлов | Да | Права пользователя; для обработки содержимого могут понадобиться модель или инструменты |
| RAG по документам | Нет | Векторные представления и хранилище векторов |
| Долговременная память | Нет | Векторные представления пользователя |
| Выполнение Python или команд | Нет | Изолированную среду выполнения |
| Генерация изображений | Нет | Провайдер генерации изображений |
| Анализ изображений | Нет | Модель с поддержкой изображений |
| Поиск в интернете | Нет | Провайдер поиска |
| GitHub | Нет | GITHUB_PERSONAL_ACCESS_TOKEN |
| VK | Нет | VK_TOKEN |
| Погода | Нет | OWM_API_KEY |
| Субагенты | Частично | Языковую модель и дополнительные секреты для отдельных сценариев |
| MCP-инструменты | Нет | Инструменты, переданные веб-интерфейсом в текущий диалог |
Минимальная рабочая настройка
Для первого полезного ответа достаточно:
- Создайте коннектор к провайдеру моделей.
- На его основе добавьте языковую модель.
- Выберите её моделью по умолчанию для пользователя.
После этого можно пользоваться обычным чатом.
Настройки для работы с документами
Для RAG нужны:
- модель векторных представлений;
- доступное хранилище векторов;
- коллекция документов;
- права пользователя на чтение коллекции.
Если коллекция создана, но поиск не работает, сначала проверьте, выбраны ли векторные представления у пользователя.
Настройки для выполнения кода
Инструменты выполнения кода и команд требуют изолированной среды. Такие инструменты получают широкие права: читают и создают файлы, запускают процессы, расходуют ресурсы машины.
Перед включением для других пользователей прочитайте Изолированная среда и безопасность.
Настройки для общего сервера
Если сервер открывается не только на вашей машине, минимально проверьте:
- длинный случайный
GIGA_AGENT_SECRET_KEY; - смену начального пароля администратора;
- закрытый доступ к панели администратора;
- осторожную настройку изолированной среды;
- что ключи и пароли не попадают в журналы сервера и в материалы, которыми вы делитесь: инструкции, снимки экрана, переписку.
Подробнее см. Совместный сервер.