# Управление промптами агентов

## Принцип

Промпты — это код. Они версионируются, хранятся в репозитории и проходят code review. Никаких hardcoded промптов в Python-коде.

## Где хранить

В VoIdea используется **два формата** с fallback:

| Формат | Расположение | Назначение |
|--------|-------------|------------|
| YAML | `docs/agent_prompts.yaml` | Настройки провайдера, температуры, токенов |
| Markdown | `docs/specs/agents/<role>.md` | Детальные промпты с примерами |

`PromptLoader` пробует YAML первым, если не нашёл — падает на MD-спецификацию.

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

```yaml
coordinator:
  provider: yandex_gpt       # yandex_gpt | gigachat
  temperature: 0.7            # 0.0-1.0
  max_tokens: 2000            # макс. длина ответа
```

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

```markdown
# Роль

**Провайдер:** Yandex GPT
**Температура:** 0.7
**Макс. токенов:** 2000

## Prompt Template
```
Ты — {role}. Описание.
```
```