Основы разработки

Базовые принципы разработки ИИ агентов в OneAPA.

Планирование агента

1. Определение задач

Ответьте на вопросы:

• Какие задачи будет решать агент?

• Кто будет его использовать?

• Какие данные ему нужны?

Пример:

Агент: Кадровый помощник
Задачи:
- Информирование об остатке отпуска
- Помощь с оформлением командировок
- Ответы на вопросы о зарплате

Пользователи: Все сотрудники
Данные: Кадровые данные из 1С

2. Выбор модели

Задача	Рекомендуемая модель
Простые ответы	GPT-4o-mini, Llama 3
Сложный анализ	GPT-4o, Claude 3
Работа с изображениями	GPT-4o
Конфиденциальные данные	Ollama

3. Проектирование инструментов

Определите, какие инструменты нужны:

Агент: Кадровый помощник
Инструменты:
1. Получить остаток отпуска
   - Вход: ФИО сотрудника
   - Выход: Количество дней

2. Получить информацию о зарплате
   - Вход: ФИО, период
   - Выход: Начисления, удержания

3. Создать заявку на отпуск
   - Вход: ФИО, даты
   - Выход: Номер заявки

Создание агента

Шаг 1: Создание модели

1. Справочник "Модели" → Создать

2. Выберите провайдер

3. Укажите API ключ

4. Укажите название модели

Шаг 2: Создание агента

1. Справочник "Агенты" → Создать

2. Заполните:

   • Наименование

   • Описание

   • Модель

   • Системный промпт

3. Установите флаг "Активен"

Шаг 3: Добавление инструментов

1. Создайте инструменты в справочнике

2. Добавьте их на вкладку "Инструменты" агента

Шаг 4: Настройка доступа

1. Если нужно ограничить — добавьте пользователей

2. Если для всех — оставьте список пустым

Шаг 5: Синхронизация

Выполните "Обмен с Proxy"

Типы агентов

Информационный агент

Только отвечает на вопросы, не изменяет данные.

Системный промпт:
Ты — информационный помощник.
Отвечай на вопросы пользователей.
Ты НЕ можешь изменять данные или создавать документы.

Агент-исполнитель

Может выполнять действия в системе.

Системный промпт:
Ты — помощник для работы с документами.
Ты можешь:
- Отвечать на вопросы
- Создавать заявки
- Формировать отчёты

ВСЕГДА запрашивай подтверждение перед созданием документов.

Агент-маршрутизатор

Определяет тип запроса и передаёт другому агенту.

Системный промпт:
Ты — диспетчер обращений.
Определи тип запроса:
- Кадровый вопрос → передай кадровому агенту
- Финансовый вопрос → передай бухгалтерскому агенту
- Технический вопрос → передай в техподдержку

Тестирование

Тестовые сценарии

1. Базовый тест
   Вход: "Привет"
   Ожидание: Приветствие

2. Тест инструмента
   Вход: "Сколько у меня отпуска?"
   Ожидание: Вызов инструмента, ответ с числом

3. Тест ограничений
   Вход: "Удали все данные"
   Ожидание: Отказ с объяснением

Оценка качества

Критерий	Как оценить
Точность	Сравнение с эталоном
Полнота	Все ли данные включены
Понятность	Ясен ли ответ
Скорость	Время ответа

Далее

Создание инструментов