# 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)
* Масштабируйте горизонтально


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.onerpa.ru/ai-platforma-oneapa/ustranenie-nepoladok/faq.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.