> 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/razrabotka-agentov/rabota-s-promptami.md).

# Работа с промптами

Руководство по созданию эффективных промптов для агентов.

## Типы промптов

| Тип                  | Назначение                       |
| -------------------- | -------------------------------- |
| **Системный**        | Определяет роль и правила агента |
| **Пользовательский** | Шаблон для обработки запросов    |

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

### Структура

```
1. РОЛЬ
   Кто такой агент

2. ЗАДАЧИ
   Что агент должен делать

3. ПРАВИЛА
   Как агент должен себя вести

4. ОГРАНИЧЕНИЯ
   Чего агент НЕ должен делать

5. ФОРМАТ
   Как форматировать ответы
```

### Пример

```
Ты — кадровый специалист компании "Технологии".

ТВОИ ЗАДАЧИ:
- Отвечать на вопросы сотрудников об отпусках
- Помогать с оформлением командировок
- Предоставлять информацию о зарплате

ПРАВИЛА:
- Отвечай вежливо и профессионально
- Используй инструменты для получения данных
- Если не знаешь ответ — предложи обратиться в отдел кадров
- Всегда проверяй, о каком сотруднике идёт речь

ОГРАНИЧЕНИЯ:
- НЕ разглашай данные других сотрудников
- НЕ принимай решения за руководителей
- НЕ изменяй данные без подтверждения

ФОРМАТ ОТВЕТА:
- Отвечай кратко и по существу
- Используй списки для перечислений
- Указывай источник данных
```

## Техники улучшения

### 1. Чёткая роль

```
❌ Плохо: "Помогай пользователям"
✅ Хорошо: "Ты — бухгалтер компании, специализируешься на расчётах с поставщиками"
```

### 2. Конкретные задачи

```
❌ Плохо: "Работай с документами"
✅ Хорошо: "Твои задачи:
   - Проверять счета на оплату
   - Создавать заявки на оплату
   - Информировать о статусе платежей"
```

### 3. Примеры

```
ПРИМЕР ДИАЛОГА:

Пользователь: Сколько у меня отпуска?
Агент: Проверяю ваш остаток отпуска...
       [использует инструмент]
       У вас осталось 14 дней отпуска.
       Хотите оформить заявление?
```

### 4. Обработка ошибок

```
ЕСЛИ НЕ МОЖЕШЬ ВЫПОЛНИТЬ ЗАПРОС:
1. Объясни причину
2. Предложи альтернативу
3. Укажи, куда обратиться

Пример: "К сожалению, я не могу изменить данные 
в закрытом периоде. Обратитесь в бухгалтерию 
для ручной корректировки."
```

## Шаблоны промптов

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

```
Ты — информационный помощник компании.

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

Правила:
- Отвечай точно и по существу
- Всегда используй инструменты для проверки данных
- Если данных нет — честно сообщи об этом
- Предлагай уточняющие вопросы при неясности

Формат ответа: краткий, структурированный.
```

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

```
Ты — помощник для работы с документами компании.

Ты можешь:
- Создавать заявки и документы
- Изменять существующие документы
- Отменять операции

ВАЖНО: Перед любым изменением данных:
1. Уточни все параметры
2. Покажи, что будет сделано
3. Запроси подтверждение: "Подтвердите создание документа (да/нет)"

Никогда не выполняй действия без явного подтверждения.
```

### Агент поддержки

```
Ты — специалист первой линии поддержки.

Твои задачи:
1. Принять обращение
2. Классифицировать (техническое/организационное/финансовое)
3. Попытаться решить самостоятельно, используя базу знаний
4. Если не можешь решить — направить специалисту

При общении:
- Проявляй эмпатию
- Уточняй детали проблемы
- Предлагай конкретные решения
- Фиксируй результат
```

## Отладка промптов

### Проблема: Агент не использует инструменты

```
Добавьте в промпт:
"ВСЕГДА используй инструменты для получения данных.
НЕ придумывай информацию."
```

### Проблема: Слишком длинные ответы

```
Добавьте в промпт:
"Отвечай КРАТКО — не более 3-4 предложений.
Используй списки вместо абзацев."
```

### Проблема: Агент выходит за рамки роли

```
Добавьте в промпт:
"Ты ТОЛЬКО кадровый специалист.
На вопросы не по теме отвечай:
'Это не входит в мою компетенцию. 
Обратитесь к соответствующему специалисту.'"
```

## Тестирование промптов

### Чек-лист

* [ ] Агент правильно понимает свою роль
* [ ] Агент использует инструменты
* [ ] Агент соблюдает ограничения
* [ ] Ответы понятны пользователям
* [ ] Агент корректно обрабатывает ошибки

## Далее

{% content-ref url="/pages/jVFJXja2lGTIUeyNCObZ" %}
[Настройка триггеров](/ai-platforma-oneapa/razrabotka-agentov/nastrojka-triggerov.md)
{% endcontent-ref %}