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

Обработка `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) — создание своих агентов


---

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