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

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

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

1. Proxy-сервер

• Proxy-сервер запущен

• Endpoint /health отвечает

• Web UI доступен

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

• Справочники доступны

• Обмен с Proxy выполняется

• Чат открывается

3. Агент

• Агент создан и активен

• Агент отвечает на сообщения

• Инструменты работают (если добавлены)

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

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

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

curl http://localhost:9000/health

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

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

Если вы видите такой ответ — Proxy-сервер работает корректно.

Проверка Web UI

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

http://localhost:9000/ui

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

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

Docker:

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. Введите тестовое сообщение:

Привет!

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

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

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

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

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

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

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

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

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

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

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

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

• Агент использует инструмент

• Возвращает актуальную дату

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

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

Симптомы:

• Ошибка "Connection refused" при curl

• Timeout при открытии /health

Решения:

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

   # Docker
   docker ps | grep oneapa
   
   # Python — проверьте процесс python

2. Проверьте порт:

   # 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С работает

• Агент отвечает на сообщения

• Инструменты вызываются (если настроены)

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

Далее

• Установка и развёртывание — детальные инструкции

• Разработка агентов — создание сложных агентов

• Примеры агентов — готовые шаблоны