# Обзор системы Раздел содержит подробное описание платформы 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) — функциональность платформы --- # 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/obzor-sistemy.md?ask= ``` 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.