> 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/integratsii/onerpa.md).

# 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.

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

```bsl
// Запуск робота
Результат = 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, файлы     |

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

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

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

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

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

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

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

* Роботы должны быть атомарными (одна задача)
* Чёткие входные и выходные параметры
* Обработка ошибок внутри робота

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

* Понятное описание для LLM
* Чёткое указание, когда использовать
* Примеры в описании

## Далее

{% content-ref url="/pages/e2qVV1fTa35qnUP4Jkfh" %}
[Broken mention](broken://pages/e2qVV1fTa35qnUP4Jkfh)
{% endcontent-ref %}