> 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/obrabotki/eksport-import-agentov.md).

# Экспорт/импорт агентов

Обработка `APA_ВыгрузкаЗагрузкаАгентов` предназначена для переноса агентов между информационными базами.

<figure><img src="/files/2Qim7xOst0tvz9Uapkjk" alt=""><figcaption></figcaption></figure>

## Назначение

Обработка позволяет:

* Экспортировать агентов в файл
* Импортировать агентов из файла
* Переносить конфигурации между средами

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

| Сценарий                  | Описание                              |
| ------------------------- | ------------------------------------- |
| **Перенос в production**  | Из тестовой базы в рабочую            |
| **Резервное копирование** | Сохранение конфигураций               |
| **Обмен шаблонами**       | Передача агентов другим пользователям |
| **Версионирование**       | Сохранение версий агентов             |

## Интерфейс обработки

```
┌─────────────────────────────────────────────────────────────────────────┐
│  Выгрузка/загрузка агентов                             [—][□][×]        │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│  Режим: ○ Выгрузка   ● Загрузка                                         │
│                                                                          │
│  Файл: [C:\export\agents.json                          ] [Обзор...]     │
│                                                                          │
│  Агенты для выгрузки/загрузки:                                          │
│  ┌────────────────────────────────────────────────────────────────────┐ │
│  │ ☑ | Наименование              | Описание                          │ │
│  │───┼───────────────────────────┼───────────────────────────────────│ │
│  │ ☑ | Кадровый агент            | Отпуска, командировки             │ │
│  │ ☑ | Бухгалтерский агент       | Финансы, оплаты                   │ │
│  │ ☐ | Тестовый агент            | Для тестирования                  │ │
│  └────────────────────────────────────────────────────────────────────┘ │
│                                                                          │
│  Опции:                                                                  │
│  ┌────────────────────────────────────────────────────────────────────┐ │
│  │ ☑ Включить инструменты                                             │ │
│  │ ☑ Включить модели                                                  │ │
│  │ ☐ Перезаписать существующие при загрузке                           │ │
│  └────────────────────────────────────────────────────────────────────┘ │
│                                                                          │
│                                              [Выполнить]  [Закрыть]     │
└─────────────────────────────────────────────────────────────────────────┘
```

## Экспорт агентов

### Шаг 1: Выбор режима

Установите переключатель "Выгрузка"

### Шаг 2: Выбор агентов

1. В таблице отметьте агентов для экспорта
2. Используйте "Выбрать все" / "Снять все" при необходимости

### Шаг 3: Настройка опций

| Опция                    | Описание                               |
| ------------------------ | -------------------------------------- |
| **Включить инструменты** | Экспорт связанных инструментов         |
| **Включить модели**      | Экспорт настроек моделей (без ключей!) |

### Шаг 4: Указание файла

1. Нажмите "Обзор"
2. Выберите путь для сохранения
3. Укажите имя файла (расширение .json)

### Шаг 5: Экспорт

Нажмите "Выполнить"

## Формат экспорта

Агенты экспортируются в формате JSON:

```json
{
  "version": "1.0",
  "export_date": "2026-01-23T14:30:00",
  "agents": [
    {
      "id": "agent-001",
      "name": "Кадровый агент",
      "description": "Помощь с кадровыми вопросами",
      "active": true,
      "model": {
        "provider": "OpenAI",
        "model_name": "gpt-4o"
      },
      "system_prompt": "Ты — кадровый специалист...",
      "user_prompt": "",
      "tools": [
        {
          "name": "Получить остаток отпуска",
          "description": "...",
          "code": "...",
          "parameters": [...]
        }
      ],
      "users": [],
      "mcp_servers": []
    }
  ]
}
```

## Импорт агентов

### Шаг 1: Выбор режима

Установите переключатель "Загрузка"

### Шаг 2: Выбор файла

1. Нажмите "Обзор"
2. Выберите файл экспорта (.json)

### Шаг 3: Просмотр агентов

После выбора файла в таблице отобразятся агенты из файла.

### Шаг 4: Выбор агентов

Отметьте агентов для импорта.

### Шаг 5: Настройка опций

| Опция                         | Описание                                |
| ----------------------------- | --------------------------------------- |
| **Перезаписать существующие** | Заменить агентов с совпадающими именами |

### Шаг 6: Импорт

Нажмите "Выполнить"

## Что экспортируется

### Всегда экспортируется

* Наименование агента
* Описание
* Флаг "Активен"
* Системный промпт
* Пользовательский промпт
* Триггер (тип)

### При включённых опциях

**Инструменты:**

* Наименование
* Описание
* Код
* Параметры
* Формат

**Модели:**

* Провайдер
* Название модели
* URL (для Ollama)

{% hint style="warning" %}
API ключи моделей **не экспортируются** из соображений безопасности. После импорта необходимо заново указать ключи.
{% endhint %}

## Что НЕ экспортируется

* API ключи и токены
* Пароли пользователей
* Логи выполнения
* Ссылки на объекты 1С (документы, справочники)

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

### Именование файлов

Используйте понятные имена с датой:

```
agents_production_2026-01-23.json
hr_agents_v2.json
test_agents_backup.json
```

### Версионирование

Храните версии файлов:

```
/agents_export/
├── 2026-01-01_v1.json
├── 2026-01-15_v2.json
└── 2026-01-23_v3.json
```

### Проверка после импорта

После импорта:

1. Проверьте наличие всех агентов
2. Укажите API ключи для моделей
3. Выполните синхронизацию с Proxy
4. Протестируйте работу агентов

## Устранение проблем

### Ошибка чтения файла

1. Проверьте формат файла (JSON)
2. Убедитесь, что файл не повреждён
3. Проверьте кодировку (UTF-8)

### Конфликт имён

При импорте агента с существующим именем:

* Если опция "Перезаписать" включена — агент заменится
* Если выключена — появится ошибка

### Отсутствуют инструменты

1. Убедитесь, что при экспорте была включена опция "Включить инструменты"
2. Импортируйте заново с правильными опциями

### Модель не работает после импорта

После импорта необходимо:

1. Открыть модель в справочнике
2. Ввести API ключ
3. Сохранить

## Далее

* [Провайдеры LLM](/ai-platforma-oneapa/provajdery-llm.md) — настройка моделей
* [Разработка агентов](/ai-platforma-oneapa/razrabotka-agentov.md) — создание своих агентов