> 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/bystryj-start/proverka-rabotosposobnosti.md).

# Проверка работоспособности

После установки и создания первого агента выполните проверку работоспособности всех компонентов системы.

## Чек-лист проверки

### 1. Proxy-сервер

* [ ] Proxy-сервер запущен
* [ ] Endpoint /health отвечает
* [ ] Web UI доступен

### 2. 1С конфигурация

* [ ] Справочники доступны
* [ ] Обмен с Proxy выполняется
* [ ] Чат открывается

### 3. Агент

* [ ] Агент создан и активен
* [ ] Агент отвечает на сообщения
* [ ] Инструменты работают (если добавлены)

## Проверка Proxy-сервера

### Проверка статуса

Откройте в браузере или выполните в командной строке:

```bash
curl http://localhost:9000/health
```

**Ожидаемый результат:**

```json
{
  "message": "OK",
  "version": "1.0.1",
  "build_date": "2025-12-03"
}
```

{% hint style="success" %}
Если вы видите такой ответ — Proxy-сервер работает корректно.
{% endhint %}

### Проверка Web UI

Откройте в браузере:

```
http://localhost:9000/ui
```

Должен открыться веб-интерфейс чата Chainlit.

### Проверка логов

**Docker:**

```bash
docker logs oneapa-proxy
```

**Python:**

Логи выводятся в консоль при запуске `python main.py`.

**Что искать в логах:**

```
INFO:     Started server process
INFO:     Waiting for application startup
INFO:     Application startup complete
INFO:     Uvicorn running on http://0.0.0.0:9000
```

## Проверка 1С конфигурации

### Проверка справочников

Убедитесь, что следующие справочники доступны и открываются:

| Справочник  | Проверка                     |
| ----------- | ---------------------------- |
| Агенты      | Создайте и сохраните элемент |
| Инструменты | Создайте и сохраните элемент |
| Модели      | Создайте и сохраните элемент |
| Триггеры    | Откройте список              |
| MCP серверы | Откройте список              |

### Проверка настроек

1. Откройте настройки (команда `APA_Настройки`)
2. Убедитесь, что URL Proxy заполнен
3. Нажмите "Проверить подключение"

**Ожидаемый результат:** Сообщение "Подключение успешно"

### Проверка обмена с Proxy

1. Выполните команду `APA_ВыполнитьОбменСПрокси`
2. Дождитесь завершения

**Ожидаемый результат:** Сообщение об успешной загрузке агентов

## Проверка агента

### Базовая проверка

1. Откройте чат (команда `APA_Чат`)
2. Введите тестовое сообщение:

```
Привет!
```

3. Дождитесь ответа

**Ожидаемый результат:** Агент отвечает приветствием

### Проверка понимания контекста

Отправьте последовательность сообщений:

```
Меня зовут Иван.
```

Дождитесь ответа, затем:

```
Как меня зовут?
```

**Ожидаемый результат:** Агент вспомнит имя "Иван"

### Проверка инструментов

Если вы добавили инструмент "Текущая дата и время":

```
Какое сегодня число?
```

**Ожидаемый результат:**

* Агент использует инструмент
* Возвращает актуальную дату

## Диагностика проблем

### Proxy-сервер не отвечает

**Симптомы:**

* Ошибка "Connection refused" при curl
* Timeout при открытии /health

**Решения:**

1. Проверьте, запущен ли контейнер/процесс:

   ```bash
   # Docker
   docker ps | grep oneapa

   # Python — проверьте процесс python
   ```
2. Проверьте порт:

   ```bash
   # Windows
   netstat -ano | findstr :9000

   # Linux
   netstat -tlnp | grep 9000
   ```
3. Проверьте firewall

### 1С не подключается к Proxy

**Симптомы:**

* Ошибка при проверке подключения
* Ошибка при обмене с Proxy

**Решения:**

1. Проверьте URL в настройках (без завершающего слэша)
2. Проверьте доступность Proxy из 1С:
   * Если 1С на другом сервере — укажите IP вместо localhost
3. Проверьте firewall между серверами

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

**Симптомы:**

* Сообщение отправлено, но ответа нет
* Длительное ожидание без результата

**Решения:**

1. Проверьте логи Proxy на ошибки
2. Убедитесь, что выполнен обмен с Proxy после создания агента
3. Проверьте настройки модели (API ключ)

### Ошибка авторизации LLM

**Симптомы:**

* Ошибка 401 или 403 в логах Proxy
* Сообщение "Invalid API key"

**Решения:**

1. Проверьте API ключ в настройках модели
2. Проверьте, не истёк ли ключ
3. Проверьте баланс аккаунта (для платных провайдеров)

### Инструменты не вызываются

**Симптомы:**

* Агент отвечает, но не использует инструменты
* Ответы без данных из инструментов

**Решения:**

1. Убедитесь, что инструменты добавлены в агента
2. Выполните повторный обмен с Proxy
3. Проверьте описание инструмента — оно должно чётко объяснять, когда его использовать
4. Попробуйте явно попросить использовать инструмент:

   ```
   Используй инструмент "Текущая дата и время" чтобы узнать, который сейчас час.
   ```

## Тестовые сценарии

### Сценарий 1: Простой диалог

```
Пользователь: Привет!
Агент: Здравствуйте! Чем могу помочь?

Пользователь: Расскажи анекдот
Агент: [рассказывает анекдот]

Пользователь: Спасибо!
Агент: Пожалуйста! Обращайтесь, если понадобится помощь.
```

**Результат:** ✅ Агент ведёт связный диалог

### Сценарий 2: Использование инструмента

```
Пользователь: Какая сейчас дата?
Агент: [вызывает инструмент]
Агент: Сегодня 23 января 2026 года.
```

**Результат:** ✅ Агент использует инструмент для получения данных

### Сценарий 3: Работа с контекстом

```
Пользователь: Запомни, что мой любимый цвет — синий
Агент: Хорошо, запомнил!

[... несколько сообщений ...]

Пользователь: Какой мой любимый цвет?
Агент: Ваш любимый цвет — синий.
```

**Результат:** ✅ Агент помнит информацию из диалога

## Итоговый чек-лист

После всех проверок отметьте выполненные пункты:

* [ ] Proxy-сервер отвечает на /health
* [ ] Web UI (Chainlit) открывается
* [ ] 1С подключается к Proxy
* [ ] Обмен с Proxy выполняется без ошибок
* [ ] Чат в 1С работает
* [ ] Агент отвечает на сообщения
* [ ] Инструменты вызываются (если настроены)

{% hint style="success" %}
Если все пункты выполнены — система работает корректно! Переходите к созданию полезных агентов.
{% endhint %}

## Далее

* [Установка и развёртывание](broken://pages/Q4ra8Wne8P6Nv47rT3MR) — детальные инструкции
* [Разработка агентов](/ai-platforma-oneapa/razrabotka-agentov.md) — создание сложных агентов
* [Примеры агентов](broken://pages/CJ9yzUSQRFkfvGB4Spfm) — готовые шаблоны