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

# Быстрый старт

{% hint style="success" %}
Этот раздел поможет вам запустить OneAPA и создать первого ИИ агента примерно за 15-20 минут.
{% endhint %}

## Цель раздела

После выполнения инструкций этого раздела вы:

* Установите и настроите OneAPA
* Создадите своего первого ИИ агента
* Протестируете его в чате

## Что вам понадобится

| Компонент      | Требование                                              |
| -------------- | ------------------------------------------------------- |
| 1С:Предприятие | Версия 8.3.20 или выше                                  |
| Docker         |                                                         |
| LLM провайдер  | API ключ (OpenAI, Yandex и др.) или Ollama              |
| Сеть           | Доступ к LLM провайдеру (или локальная сеть для Ollama) |

## Этапы быстрого старта

### Этап 1: Проверка требований

Убедитесь, что ваша система соответствует минимальным требованиям.

{% content-ref url="/pages/wNFzxQVc9f4HvH9kgZpm" %}
[Требования](/ai-platforma-oneapa/bystryj-start/trebovaniya.md)
{% endcontent-ref %}

### Этап 2: Установка

Установите расширение 1С и запустите Proxy-сервер.

{% content-ref url="/pages/z1SGTBnETqlaohXEv5Jn" %}
[Установка](/ai-platforma-oneapa/bystryj-start/ustanovka.md)
{% endcontent-ref %}

### Этап 3: Создание первого агента

Создайте простого агента и настройте его.

{% content-ref url="/pages/JQw8cPsVzjNynAtusTSl" %}
[Первый агент](/ai-platforma-oneapa/bystryj-start/pervyj-agent.md)
{% endcontent-ref %}

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

Протестируйте агента и убедитесь, что всё работает.

{% content-ref url="/pages/ktAJhxhoefYp0OGw7jw0" %}
[Проверка работоспособности](/ai-platforma-oneapa/bystryj-start/proverka-rabotosposobnosti.md)
{% endcontent-ref %}

## Схема быстрого старта

```
┌─────────────────────────────────────────────────────────────┐
│                    БЫСТРЫЙ СТАРТ OneAPA                      │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  1. ТРЕБОВАНИЯ                                               │
│     └─► Проверить версии 1С, Docker                         │
│     └─► Получить API ключ LLM провайдера                    │
│                           │                                  │
│                           ▼                                  │
│  2. УСТАНОВКА                                                │
│     └─► Загрузить конфигурацию OneAPA в 1С                  │
│     └─► Запустить Proxy сервер                               │
│     └─► Настроить URL Proxy в 1С                            │
│                           │                                  │
│                           ▼                                  │
│  3. ПЕРВЫЙ АГЕНТ                                             │
│     └─► Создать модель (LLM провайдер)                      │
│     └─► Создать агента с промптом                           │
│     └─► Добавить простой инструмент                         │
│                           │                                  │
│                           ▼                                  │
│  4. ПРОВЕРКА                                                 │
│     └─► Открыть чат                                         │
│     └─► Отправить тестовое сообщение                        │
│     └─► Получить ответ от агента                            │
│                           │                                  │
│                           ▼                                  │
│                      ✓ ГОТОВО!                               │
└─────────────────────────────────────────────────────────────┘
```

## Рекомендуемый путь для начинающих

Если вы впервые работаете с OneAPA, рекомендуем:

1. **Начните с OpenAI** — самый простой вариант, требует только API ключ
2. **Используйте Docker** — упрощает запуск Proxy сервера
3. **Создайте простого агента** — без инструментов, только для проверки связи

Типовая настройка системы выглядит так. В данном кейсе Docker контейнер с Proxy установлен на той же машине что и 1С - поэтому host.docker.internal - адрес контейнера

<figure><img src="/files/ZnApcnA63Cz4axyNP9nF" alt=""><figcaption></figcaption></figure>

## Возможные проблемы

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

## Следующие шаги

После успешного завершения быстрого старта:

1. Изучите [детальные инструкции по установке](broken://pages/Q4ra8Wne8P6Nv47rT3MR)
2. Настройте [дополнительные модели](/ai-platforma-oneapa/provajdery-llm.md)
3. Создайте [собственные инструменты](/ai-platforma-oneapa/razrabotka-agentov/sozdanie-instrumentov.md)
4. Ознакомьтесь с [примерами агентов](broken://pages/CJ9yzUSQRFkfvGB4Spfm)

## Поддержка

Если у вас возникли проблемы:

* Раздел [Устранение неполадок](/ai-platforma-oneapa/ustranenie-nepoladok.md)
* [FAQ](/ai-platforma-oneapa/ustranenie-nepoladok/faq.md)
* [Контакты поддержки](broken://pages/7eTLn4Seqa8mJV5bihwt)