> 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.md).

# Устранение неполадок

Руководство по диагностике и устранению проблем в OneAPA.

## Содержание раздела

| Страница                                                                                  | Описание                    |
| ----------------------------------------------------------------------------------------- | --------------------------- |
| [Ошибки LLM](/ai-platforma-oneapa/ustranenie-nepoladok/oshibki-llm.md)                    | Проблемы с LLM провайдерами |
| [Ошибки инструментов](/ai-platforma-oneapa/ustranenie-nepoladok/oshibki-instrumentov.md)  | Проблемы выполнения         |
| [Ошибки подключения](/ai-platforma-oneapa/ustranenie-nepoladok/oshibki-podklyucheniya.md) | Сетевые проблемы            |
| [FAQ](/ai-platforma-oneapa/ustranenie-nepoladok/faq.md)                                   | Часто задаваемые вопросы    |

## Общий подход к диагностике

### 1. Определите компонент

```
┌─────────────────────────────────────────────────────────────┐
│                    ДИАГНОСТИКА                               │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  Агент не отвечает?                                          │
│       │                                                      │
│       ├── Proxy недоступен? → Ошибки подключения            │
│       │                                                      │
│       ├── LLM возвращает ошибку? → Ошибки LLM               │
│       │                                                      │
│       └── Инструмент не работает? → Ошибки инструментов     │
│                                                              │
└─────────────────────────────────────────────────────────────┘
```

### 2. Проверьте логи

* Логи Proxy: `docker logs oneapa-proxy`
* Логи 1С: регистр APA\_ЛогИнструментов

### 3. Изолируйте проблему

* Работает ли health check?
* Работают ли другие агенты?
* Работает ли агент без инструментов?

## Быстрая диагностика

| Симптом         | Вероятная причина   | Решение           |
| --------------- | ------------------- | ----------------- |
| Нет ответа      | Proxy не запущен    | Запустите Proxy   |
| Таймаут         | Медленный LLM       | Увеличьте таймаут |
| 401 ошибка      | Неверный API ключ   | Проверьте ключ    |
| Агент не найден | Не синхронизировано | Обмен с Proxy     |

## Инструменты диагностики

### Health Check

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

### Тест подключения к LLM

Создайте простого агента без инструментов и отправьте "Привет".

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

Вызовите инструмент напрямую через код 1С.

## Далее

{% content-ref url="/pages/Hxk67aS6x0KJLzURPWsT" %}
[Ошибки LLM](/ai-platforma-oneapa/ustranenie-nepoladok/oshibki-llm.md)
{% endcontent-ref %}