# Интеграции

Раздел описывает возможности интеграции OneAPA с внешними системами.

## Возможности интеграции

| Интеграция                                                         | Описание               | Страница         |
| ------------------------------------------------------------------ | ---------------------- | ---------------- |
| [MCP протокол](/ai-platforma-oneapa/integratsii/mcp-protokol.md)   | Model Context Protocol | mcp-protokol.md  |
| [OneRPA](/ai-platforma-oneapa/integratsii/onerpa.md)               | Запуск роботов         | onerpa.md        |
| [API Reference](/ai-platforma-oneapa/integratsii/api-reference.md) | REST API Proxy         | api-reference.md |

## Архитектура интеграций

```
┌─────────────────────────────────────────────────────────────────────────┐
│                            OneAPA                                        │
│                                                                          │
│  ┌─────────────┐    ┌─────────────┐    ┌─────────────────────────────┐  │
│  │   Агенты    │    │ Инструменты │    │       LLM Провайдеры        │  │
│  └──────┬──────┘    └──────┬──────┘    └──────────────┬──────────────┘  │
│         │                  │                          │                  │
└─────────┼──────────────────┼──────────────────────────┼──────────────────┘
          │                  │                          │
          ▼                  ▼                          ▼
┌─────────────────┐  ┌─────────────────┐  ┌─────────────────────────────┐
│   MCP серверы   │  │     OneRPA      │  │   OpenAI, Yandex, Ollama    │
│                 │  │                 │  │                             │
│  • FileSystem   │  │  • Роботы       │  │  • GPT-4o                   │
│  • GitHub       │  │  • UI авто-     │  │  • YandexGPT                │
│  • Database     │  │    матизация    │  │  • Llama 3                  │
└─────────────────┘  └─────────────────┘  └─────────────────────────────┘
          │                  │
          ▼                  ▼
┌─────────────────────────────────────────┐
│            Векторные БД (RAG)            │
│                                          │
│  • Chroma    • Milvus    • Pinecone     │
└─────────────────────────────────────────┘
```

## Типы интеграций

### MCP (Model Context Protocol)

Стандартный протокол для расширения возможностей LLM:

* OneAPA как MCP сервер — предоставляет инструменты
* OneAPA как MCP клиент — использует внешние инструменты

### OneRPA

Интеграция с платформой роботизации:

* Запуск роботов как инструментов агента
* Передача параметров
* Получение результатов

### RAG (Retrieval-Augmented Generation)

Использование внутренних баз знаний:

* Выгрузка данных 1С в векторную БД
* Поиск релевантной информации
* Обогащение ответов агента

### REST API

Взаимодействие через HTTP:

* Загрузка агентов
* Отправка сообщений
* Интеграция с внешними системами

## Сценарии интеграции

### Сценарий 1: Внешняя CRM

```
CRM система → API → OneAPA → Агент → Ответ → CRM
```

### Сценарий 2: Автоматизация процессов

```
Событие в 1С → Агент → Инструмент → Робот OneRPA → Результат
```

### Сценарий 3: База знаний

```
Документы → Векторная БД → RAG → Агент → Ответ с контекстом
```

### Сценарий 4: IDE интеграция

```
Cursor IDE → MCP → OneAPA → Инструменты 1С → Результат
```

## Далее

{% content-ref url="/pages/Sbpi7dD0CjrACn7wSck4" %}
[MCP протокол](/ai-platforma-oneapa/integratsii/mcp-protokol.md)
{% 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.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.
