Компоненты

Платформа OneAPA состоит из нескольких взаимосвязанных компонентов. В этом разделе подробно описан каждый из них.

Расширение для 1С

Назначение

Расширение является центральным компонентом системы, обеспечивающим:

  • Хранение настроек агентов, инструментов и моделей

  • Пользовательский интерфейс (чат)

  • Выполнение инструментов (запросы к данным, бизнес-логика)

  • Интеграцию с другими подсистемами 1С

Интеграция с существующей базой

Конфигурация OneAPA может быть объединена с любой конфигурацией 1С:

┌─────────────────────────────────────────────────┐
│           Ваша конфигурация 1С                  │
│  ┌─────────────┐  ┌─────────────┐              │
│  │ Бухгалтерия │  │     ERP     │              │
│  └─────────────┘  └─────────────┘              │
│                                                 │
│  ┌─────────────────────────────────────────┐   │
│  │           Расширение OneAPA              │   │
│  │   (или объединённая конфигурация)        │   │
│  └─────────────────────────────────────────┘   │
└─────────────────────────────────────────────────┘

Python Proxy Server

Назначение

Proxy-сервер обеспечивает:

  • Взаимодействие с LLM провайдерами

  • Оркестрацию workflow агентов

  • Web-интерфейс чата

  • REST API для внешних систем

Технологический стек

Технология
Версия
Назначение

Python

3.11+

Язык программирования

FastAPI

latest

REST API framework

LangGraph

latest

Оркестрация workflow

LangChain

latest

Интеграция с LLM

Chainlit

latest

Web UI для чата

Pydantic

latest

Валидация данных

uvicorn

latest

ASGI сервер

Структура файлов

REST API

GET /health

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

Ответ:

POST /load

Загрузка агентов и инструментов из 1С.

Тело запроса:

POST /chat

Отправка сообщения агенту.

Тело запроса:

Ответ:

LangGraph Workflow

Узлы графа:

Узел
Назначение

router

Выбор агента для обработки запроса

agent

Вызов LLM для анализа и формирования ответа

tools

Выполнение инструментов

fallback

Обработка ошибок

decide_next

Решение о следующем шаге (tools/agent/END)

Chainlit Web UI

Назначение

Веб-интерфейс для взаимодействия с агентами через браузер.

Функциональность

  • Чат-интерфейс с историей сообщений

  • Поддержка файлов (изображения, документы)

  • Отображение процесса работы агента

  • Сессии пользователей

Доступ

По умолчанию доступен по адресу: http://<proxy-server>:9000/ui

MCP серверы

Что такое MCP

Model Context Protocol (MCP) — открытый протокол для взаимодействия LLM с внешними инструментами и данными.

OneAPA как MCP сервер

OneAPA предоставляет свои инструменты как MCP сервер:

OneAPA как MCP клиент

OneAPA может использовать внешние MCP серверы:

Интеграция с OneRPA

Назначение

Модуль APA_OneRPA позволяет запускать роботов OneRPA как инструменты агента.

Сценарий использования

Конфигурация

В справочнике APA_Инструменты:

  • OneRPA — флаг, указывающий на инструмент OneRPA

  • КодЗаданияOneRPA — код задания для запуска

Система логирования

Уровни логирования

Уровень
Описание

DEBUG

Детальная отладочная информация

INFO

Общая информация о работе

WARNING

Предупреждения

ERROR

Ошибки

Логирование в 1С

Регистр APA_ЛогИнструментов:

Измерение
Тип
Описание

Инструмент

Справочник

Ссылка на инструмент

Дата

ДатаВремя

Время выполнения

Состояние

Перечисление

Успешно/Ошибка

Результат

Строка

Результат выполнения

Далее

Last updated