> For the complete documentation index, see [llms.txt](https://docs.onerpa.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onerpa.ru/ai-platforma-oneapa/ustranenie-nepoladok/faq.md).

# 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. Справочник "Инструменты" → Создать
2. Напишите описание
3. Напишите код на 1С
4. Добавьте параметры
5. Добавьте инструмент в агента

### Почему агент не использует инструмент?

* Инструмент не добавлен в агента
* Не выполнен обмен с Proxy
* Плохое описание инструмента
* LLM не понимает когда использовать

### Как улучшить качество ответов?

* Используйте более мощную модель (GPT-4o)
* Улучшите системный промпт
* Добавьте примеры в промпт
* Используйте RAG для базы знаний

## Проблемы

### Агент не отвечает

1. Проверьте health check: `curl http://proxy:9000/health`
2. Проверьте логи: `docker logs oneapa-proxy`
3. Проверьте настройки модели
4. Выполните обмен с Proxy

### Ошибка 401

Неверный API ключ. Проверьте ключ в настройках модели.

### Таймаут

1. Увеличьте таймаут в настройках
2. Используйте более быструю модель
3. Упростите запрос

### Инструмент возвращает ошибку

1. Проверьте регистр APA\_ЛогИнструментов
2. Найдите текст ошибки
3. Исправьте код инструмента

## Безопасность

### Куда уходят данные?

При использовании облачных провайдеров (OpenAI, Yandex) данные передаются им. При использовании Ollama — данные остаются локально.

### Как защитить API ключи?

* Храните в справочнике 1С (не в коде)
* Используйте переменные окружения для Proxy
* Не публикуйте в репозиториях

### Соответствует ли OneAPA ФЗ-152?

При использовании Ollama (On-Premise) и хранении данных в РФ — да.

## Производительность

### Сколько пользователей поддерживается?

Зависит от оборудования и провайдера. Ориентировочно:

* 1 инстанс Proxy: 10-50 одновременных пользователей
* Кластер: 100+ пользователей

### Как ускорить ответы?

* Используйте более быструю модель (GPT-4o-mini)
* Оптимизируйте инструменты
* Добавьте ресурсы (CPU, RAM)
* Масштабируйте горизонтально