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

Этот раздел поможет вам запустить OneAPA и создать первого ИИ агента примерно за 15-20 минут.

Цель раздела

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

• Установите и настроите OneAPA

• Создадите своего первого ИИ агента

• Протестируете его в чате

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

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

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

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

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

Требования

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

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

Установка

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

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

Первый агент

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

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

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

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

┌─────────────────────────────────────────────────────────────┐
│                    БЫСТРЫЙ СТАРТ 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 - адрес контейнера

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

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

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

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

1. Изучите детальные инструкции по установке

2. Настройте дополнительные модели

3. Создайте собственные инструменты

4. Ознакомьтесь с примерами агентов

Поддержка

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

• Раздел Устранение неполадок

• FAQ

• Контакты поддержки