voidea/docs/agent-prompts/README.md

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

Принцип

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

Где хранить

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

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

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

Структура YAML

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

Структура MD

# Роль

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

## Prompt Template

Ты — {role}. Описание.