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

Руководство по диагностике и устранению проблем в 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 %}


---

# 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.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.