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

{% 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)


---

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