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

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

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

### 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) — готовые шаблоны


---

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