> 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/obzor-sistemy.md).

# Обзор системы

Раздел содержит подробное описание платформы OneAPA, её архитектуры, компонентов и ключевых возможностей.

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

| Страница                                                                              | Описание                                                    |
| ------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| [Архитектура](/ai-platforma-oneapa/obzor-sistemy/arkhitektura.md)                     | Общая архитектура системы, схема взаимодействия компонентов |
| [Компоненты](/ai-platforma-oneapa/obzor-sistemy/komponenty.md)                        | Детальное описание каждого компонента платформы             |
| [Ключевые возможности](/ai-platforma-oneapa/obzor-sistemy/klyuchevye-vozmozhnosti.md) | Функциональные возможности и преимущества                   |

## Назначение платформы

**OneAPA** — это платформа для создания, настройки и эксплуатации ИИ агентов в корпоративной среде на базе 1С:Предприятие.

### Целевая аудитория

| Роль                    | Использование OneAPA                                                         |
| ----------------------- | ---------------------------------------------------------------------------- |
| **Бизнес-пользователи** | Взаимодействие с агентами через чат-интерфейс для решения повседневных задач |
| **Аналитики**           | Настройка агентов без программирования: промпты, инструменты, триггеры       |
| **Разработчики**        | Создание кастомных инструментов, интеграция с внешними системами             |
| **Администраторы**      | Развёртывание, мониторинг, обслуживание системы                              |

### Позиционирование

OneAPA занимает нишу между простыми чат-ботами и сложными enterprise-решениями для автоматизации:

```
Простые чат-боты ◄────────────► OneAPA ◄────────────► Enterprise AI
(ограниченные         (low-code,            (требуют глубокой
 сценарии)            гибкость,              разработки)
                      интеграция с 1С)
```

## Основные концепции

### ИИ Агент

**ИИ агент** — это автономная программная сущность, которая:

1. Получает задачу от пользователя (через чат, email, API или триггер)
2. Анализирует задачу с помощью языковой модели (LLM)
3. Выбирает и использует необходимые инструменты
4. Формирует и возвращает результат

### Инструмент

**Инструмент** — это функция, которую агент может вызвать для получения данных или выполнения действия:

* Запрос к базе данных 1С
* Вызов внешнего API
* Запуск робота OneRPA
* Взаимодействие через MCP

### Промпт

**Промпт** — это текстовая инструкция для языковой модели, определяющая поведение агента:

* **Системный промпт** — общие правила работы агента
* **Пользовательский промпт** — шаблон для обработки конкретных запросов

### Триггер

**Триггер** — это событие, запускающее работу агента:

* Сообщение в чате
* Входящий email
* API-запрос
* Изменение буфера обмена
* Запись объекта в 1С

## Принципы работы

### Workflow агента

```
┌─────────────────────────────────────────────────────────────────┐
│                        Пользователь                              │
│                     "Сколько у меня отпускных дней?"            │
└─────────────────────────┬───────────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────────┐
│                      Router Node                                 │
│              Выбор подходящего агента                           │
└─────────────────────────┬───────────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────────┐
│                      Agent Node                                  │
│    LLM анализирует запрос и решает использовать инструмент      │
│    → tool_call: "получить_остаток_отпуска(сотрудник=...)"       │
└─────────────────────────┬───────────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────────┐
│                      Tools Node                                  │
│              Выполнение инструмента в 1С                        │
│              → результат: {"дней": 14}                          │
└─────────────────────────┬───────────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────────┐
│                      Agent Node                                  │
│    LLM формирует ответ на основе результата инструмента         │
│    → "У вас осталось 14 дней отпуска"                           │
└─────────────────────────┬───────────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────────┐
│                        Пользователь                              │
│                  "У вас осталось 14 дней отпуска"               │
└─────────────────────────────────────────────────────────────────┘
```

### Цикл инструментов

Агент может вызывать несколько инструментов последовательно для решения сложных задач:

1. Пользователь: "Забронируй мне переговорку на завтра в 14:00"
2. Агент → инструмент: проверить доступность переговорок
3. Результат: переговорка А свободна, переговорка Б занята
4. Агент → инструмент: создать бронирование переговорки А
5. Результат: бронирование создано
6. Агент → пользователь: "Переговорка А забронирована на завтра в 14:00"

## Безопасность

### On-Premise развёртывание

OneAPA развёртывается полностью в инфраструктуре заказчика:

* Proxy-сервер работает на ваших серверах
* Данные не покидают периметр организации
* При использовании Ollama — даже LLM работает локально

### Контроль доступа

* Разграничение доступа к агентам по пользователям
* Ограничение доступности инструментов
* Логирование всех действий агентов

## Далее

* [Архитектура](/ai-platforma-oneapa/obzor-sistemy/arkhitektura.md) — подробная схема системы
* [Компоненты](/ai-platforma-oneapa/obzor-sistemy/komponenty.md) — описание всех компонентов
* [Ключевые возможности](/ai-platforma-oneapa/obzor-sistemy/klyuchevye-vozmozhnosti.md) — функциональность платформы