41 lines
1.2 KiB
Markdown
41 lines
1.2 KiB
Markdown
# Управление промптами агентов
|
||
|
||
## Принцип
|
||
|
||
Промпты — это код. Они версионируются, хранятся в репозитории и проходят 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}. Описание.
|
||
```
|
||
```
|