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

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

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

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

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

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

```
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 %}


---

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