# 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 %}


---

# 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/integratsii/onerpa.md?ask=<question>
```

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.