OneRPA

Руководство по интеграции OneAPA с платформой OneRPA.

Обзор

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

┌─────────────────┐         ┌─────────────────┐         ┌─────────────────┐
│     Агент       │────────►│   Инструмент    │────────►│     Робот       │
│    OneAPA       │         │    OneRPA       │         │    OneRPA       │
└─────────────────┘         └─────────────────┘         └─────────────────┘

Настройка инструмента OneRPA

Создание инструмента

1. Откройте справочник "Инструменты"

2. Создайте новый элемент

3. Установите флаг OneRPA

4. Укажите Код задания OneRPA

┌─────────────────────────────────────────────────────────────────────────┐
│  Инструмент: Выгрузка в Excel                                           │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│  ☐ MCP    ☑ OneRPA                                                      │
│                                                                          │
│  Код задания OneRPA: [EXPORT_TO_EXCEL                             ]     │
│                                                                          │
│  Описание:                                                               │
│  Выгружает данные в файл Excel. Используй, когда пользователь          │
│  просит создать отчёт в Excel формате.                                  │
│                                                                          │
│  Параметры:                                                              │
│  ┌────────────────────────────────────────────────────────────────────┐ │
│  │ report_type | string | Тип отчёта (sales, inventory, finance)     │ │
│  │ period      | string | Период (YYYY-MM)                           │ │
│  │ output_path | string | Путь для сохранения файла                  │ │
│  └────────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────┘

Модуль APA_OneRPA

Назначение

Серверный модуль для взаимодействия с OneRPA.

Основные функции

// Запуск робота
Результат = APA_OneRPA.ЗапуститьРобота(
    КодЗадания,
    ПараметрыЗапуска
);

// Проверка статуса
Статус = APA_OneRPA.ПолучитьСтатусВыполнения(ИдентификаторЗадания);

// Получение результата
Результат = APA_OneRPA.ПолучитьРезультат(ИдентификаторЗадания);

Пример сценария

Запрос пользователя

Пользователь: Выгрузи отчёт по продажам за январь 2026 в Excel

Обработка агентом

Агент:
1. Анализирует запрос
2. Определяет, что нужен инструмент "Выгрузка в Excel"
3. Формирует параметры:
   - report_type: "sales"
   - period: "2026-01"
   - output_path: "D:\Reports\sales_2026-01.xlsx"
4. Вызывает инструмент

Выполнение

OneAPA → OneRPA:
{
  "task_code": "EXPORT_TO_EXCEL",
  "parameters": {
    "report_type": "sales",
    "period": "2026-01",
    "output_path": "D:\\Reports\\sales_2026-01.xlsx"
  }
}

OneRPA:
1. Запускает робота
2. Робот формирует отчёт
3. Сохраняет файл
4. Возвращает результат

Ответ агента

Агент: Отчёт по продажам за январь 2026 успешно сформирован 
       и сохранён в файл D:\Reports\sales_2026-01.xlsx

Типы роботов для интеграции

Тип	Описание	Пример
Отчёты	Формирование и выгрузка	Excel, PDF
Импорт данных	Загрузка из внешних источников	CSV, XML
UI автоматизация	Работа с интерфейсами	SAP, веб-формы
Интеграция	Обмен с внешними системами	API, файлы

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

Таймаут выполнения

// В инструменте можно настроить таймаут
Если APA_OneRPA.ЖдатьЗавершения(ИдентификаторЗадания, 300) Тогда
    // Успешно
Иначе
    // Таймаут
    ВызватьИсключение "Робот не завершился за отведённое время";
КонецЕсли;

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

Результат = APA_OneRPA.ПолучитьРезультат(ИдентификаторЗадания);
Если Результат.Ошибка Тогда
    Возврат Новый Структура("Успех, Ошибка", Ложь, Результат.ОписаниеОшибки);
КонецЕсли;

Рекомендации

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

• Роботы должны быть атомарными (одна задача)

• Чёткие входные и выходные параметры

• Обработка ошибок внутри робота

Описание инструментов

• Понятное описание для LLM

• Чёткое указание, когда использовать

• Примеры в описании

Далее