FAQ
Часто задаваемые вопросы о OneAPA.
Общие вопросы
Что такое OneAPA?
OneAPA — платформа low-code разработки ИИ агентов на базе 1С:Предприятие с поддержкой множества LLM провайдеров.
Какие LLM провайдеры поддерживаются?
OpenAI (GPT-4o, o1, o3)
Yandex GPT
OpenRouter (множество моделей)
Ollama (локальные модели)
Sber GigaChat
Можно ли работать без интернета?
Да, при использовании Ollama все компоненты работают локально.
Установка
Какая версия 1С требуется?
1С:Предприятие 8.3.20 и выше.
Можно ли установить на Linux?
Да, Proxy-сервер работает на любой ОС. 1С должен быть установлен на поддерживаемой платформе.
Нужен ли GPU для Ollama?
Рекомендуется, но не обязательно. Без GPU модели работают на CPU (медленнее).
Настройка
Как часто обновлять IAM токен Yandex?
Каждые 12 часов. Рекомендуется настроить автоматическое обновление.
Сколько агентов можно создать?
Ограничений нет. Количество зависит от ваших задач.
Как ограничить доступ к агенту?
Добавьте пользователей на вкладку "Пользователи" агента. Пустой список означает доступ для всех.
Разработка
Как создать инструмент?
Справочник "Инструменты" → Создать
Напишите описание
Напишите код на 1С
Добавьте параметры
Добавьте инструмент в агента
Почему агент не использует инструмент?
Инструмент не добавлен в агента
Не выполнен обмен с Proxy
Плохое описание инструмента
LLM не понимает когда использовать
Как улучшить качество ответов?
Используйте более мощную модель (GPT-4o)
Улучшите системный промпт
Добавьте примеры в промпт
Используйте RAG для базы знаний
Проблемы
Агент не отвечает
Проверьте health check:
curl http://proxy:9000/healthПроверьте логи:
docker logs oneapa-proxyПроверьте настройки модели
Выполните обмен с Proxy
Ошибка 401
Неверный API ключ. Проверьте ключ в настройках модели.
Таймаут
Увеличьте таймаут в настройках
Используйте более быструю модель
Упростите запрос
Инструмент возвращает ошибку
Проверьте регистр APA_ЛогИнструментов
Найдите текст ошибки
Исправьте код инструмента
Безопасность
Куда уходят данные?
При использовании облачных провайдеров (OpenAI, Yandex) данные передаются им. При использовании Ollama — данные остаются локально.
Как защитить API ключи?
Храните в справочнике 1С (не в коде)
Используйте переменные окружения для Proxy
Не публикуйте в репозиториях
Соответствует ли OneAPA ФЗ-152?
При использовании Ollama (On-Premise) и хранении данных в РФ — да.
Производительность
Сколько пользователей поддерживается?
Зависит от оборудования и провайдера. Ориентировочно:
1 инстанс Proxy: 10-50 одновременных пользователей
Кластер: 100+ пользователей
Как ускорить ответы?
Используйте более быструю модель (GPT-4o-mini)
Оптимизируйте инструменты
Добавьте ресурсы (CPU, RAM)
Масштабируйте горизонтально
Last updated