Типовые помощники¶
Ниже — рекомендуемые архитектуры. Адаптируйте их под реальные процессы, документы и права организации.
1. Универсальный корпоративный помощник¶
Назначение: повседневные тексты, объяснения, суммаризация и поиск.
Инструкции: отвечать на языке пользователя, отделять факты от предположений, не утверждать использование источника без фактического вызова.
Знания: минимальные; общие корпоративные правила и терминология.
Сервисы: интернет-поиск при разрешении администратора.
Память: общая персональная.
Не подключать: широкие административные сервисы «на всякий случай».
Пример:
Подготовь краткую записку для руководителя:
что произошло, почему это важно и какие три решения возможны.
2. Помощник разработчика¶
Назначение: ревью, объяснение кода, поиск ошибок, тесты и документация.
Инструкции: сначала причина, затем минимальное исправление; учитывать версии; не переписывать весь проект без необходимости.
Знания: coding standards, архитектурные решения, API docs.
Навыки: security review, unit-test checklist, changelog.
Сервисы: документация или репозиторий только если такая интеграция подключена и разрешена.
Память: отдельная для проекта — по необходимости.
Вот stack trace и два файла. Найди минимальную первопричину.
Не предлагай рефакторинг, пока ошибка не локализована.
3. Linux-администратор¶
Назначение: журналы, systemd, сеть, конфигурации, эксплуатационная диагностика.
Инструкции: факты → гипотезы → безопасные проверки → исправление → rollback.
Знания: инструкции эксплуатации, стандарты ОС, backup/restore.
Сервисы: преимущественно только для чтения.
Память: только устойчивые особенности окружения; не CMDB.
Проанализируй journalctl. Покажи строки, которые подтверждают каждую гипотезу.
Сначала только диагностика, без изменяющих команд.
4. Яндекс Облако — инфраструктура¶
Назначение: отвечать на фактические вопросы о разрешённой облачной инфраструктуре.
Инструкции: использовать данные только для чтения; не обещать создание, изменение или перезапуск ресурсов; при ошибке доступа не заменять факты предположением.
Знания: внутренние стандарты именования и архитектурные правила.
Сервисы: YC только для чтения + официальная документация.
Память: необязательна.
Опиши виртуальные машины и сети в рабочей области.
Отдельно укажи ресурсы, которые не удалось проверить.
5. YC FinOps¶
Назначение: объяснять расходы и находить зоны для проверки оптимизации.
Инструкции: fact ≠ forecast; не предлагать удаление ресурса только по стоимости.
Сервисы: Billing/FinOps только для чтения.
Навык: стандарт финансового анализа.
Расписание: ежедневный или еженедельный отчёт.
Сравни текущий месяц с сопоставимым периодом прошлого месяца.
Покажи три крупнейших фактора изменения расходов.
6. Корпоративные знания¶
Назначение: отвечать по регламентам и документации компании.
Инструкции: приоритет документам; обязательные источники; при отсутствии ответа — так и сказать.
Знания: File Search по контролируемой базе.
Сервисы: обычно не нужны.
Память: часто лучше отключить, чтобы персональные факты не смешивались с нормативными ответами.
Каков порядок восстановления доступа сотруднику?
Дай ответ только по действующим документам и укажи источник.
7. Исследователь¶
Назначение: собирать свежую внешнюю информацию и формировать аналитический обзор.
Инструкции: отделять первичные источники от пересказов; фиксировать даты; показывать противоречия.
Сервисы: интернет-поиск.
Навык: методика исследования.
Интерактивные материалы: диаграммы и таблицы.
Исследуй изменения рынка за последние 30 дней.
Раздели факты, оценки источников и собственный синтез.
8. Помощник документации¶
Назначение: превращать проверенную техническую информацию в понятные инструкции для новичков.
Инструкции: один шаг — одно действие; после каждого блока — проверка результата; не пропускать prerequisites.
Знания: актуальная продуктовая документация.
Навык: style guide документации.
Интерактивные материалы: Mermaid.
9. Техническая поддержка¶
Назначение: классификация обращения и подготовка диагностического сценария.
Инструкции: не делать преждевременный вывод; сначала минимальные вопросы; не просить секреты пользователя.
Знания: known issues, troubleshooting, FAQ.
Сервисы: ticketing только если отдельная интеграция реально подключена.
10. Помощник руководителя¶
Назначение: краткие записки, сравнение вариантов, подготовка решений.
Инструкции: сначала executive summary; количественные значения только с источником; явно указывать неопределённость.
Знания: ограниченный набор управленческих документов.
Память: полезна для предпочтительного формата.
Как не надо строить каталог¶
Плохо:
Лучше:
Общие
└── Универсальный
Разработка
├── Code Review
└── Архитектура
Эксплуатация
├── Linux диагностика
└── Incident Review
Яндекс Облако
├── Инфраструктура
└── FinOps
Знания
└── Корпоративные регламенты
Шаблон карточки нового помощника¶
Имя:
Целевая аудитория:
Повторяемая задача:
Владелец:
Instruction version:
Знания:
Сервисы:
Память:
Навыки:
Интерактивные материалы:
Расписание:
Доступ:
Acceptance tests:
Дата ревизии:
Правило масштаба¶
Не стремитесь создать максимальное число помощников. Создавайте новый только тогда, когда он даёт отдельное предсказуемое поведение, знания или модель доступа.