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

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

Назначение

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

• Экспортировать агентов в файл

• Импортировать агентов из файла

• Переносить конфигурации между средами

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

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

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

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

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

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

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

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

1. В таблице отметьте агентов для экспорта

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

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

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

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

1. Нажмите "Обзор"

2. Выберите путь для сохранения

3. Укажите имя файла (расширение .json)

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

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

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

Агенты экспортируются в формате 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)

API ключи моделей не экспортируются из соображений безопасности. После импорта необходимо заново указать ключи.

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

• 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 — настройка моделей

• Разработка агентов — создание своих агентов