Initial commit: omnichannel-mcp — MCP-сервер управления платформой Omnichannel

examples/prompts.md

@@ -0,0 +1,56 @@
+# Примеры промптов
+
+Готовые формулировки для оператора: что написать агенту, чтобы он через
+`omnichannel-mcp` выполнил типовую задачу. В скобках — инструменты, которые
+агент вызовет. Замените хост/имена/пути на свои.
+
+## Наблюдение и диагностика
+
+- «Покажи, что сейчас происходит на стенде `prod`.» → `overview`
+- «Какие сервисы не в статусе OK?» → `list_applications` (или `overview`)
+- «Покажи детали сервиса `user_system_front`.» → `get_application`
+- «Покажи последние упавшие задачи за сегодня.» → `list_tasks {status:"failed"}`
+- «Покажи хвост вывода задачи `0c9f...`.» → `get_task {output_bytes:4000}`
+- «Все ли IP из схемы сопоставлены агентам?» → `ip_match`
+
+## Быстрый деплой на 1 сервер
+
+- «Задеплой сервис `demo_web`: обнови compose на образ `nginx:1.27`, подними и
+  дождись результата.» →
+  `set_compose` → `deploy` → `get_task {wait:true}` → `overview`
+- «Перезапусти сервис `user_system`, затем проверь, что задачи прошли без
+  ошибок.» → `restart` → `list_tasks`
+
+## Деплой релиза на несколько серверов
+
+- «Загрузи релиз на все хосты схемы: сохрани schema.json и manifest.json,
+  разложи хосты, скачай релиз с образами, дождись завершения и запусти
+  сервисы.» →
+  `save_deployment_files` → `seed_hosts` → `download_release {load_images:true, confirm:true}`
+  → `release_job` (опрос) → `start_services` → `deployment_tasks` → `get_task`
+
+## Обновление фронта
+
+- «Обнови фронт сервиса `chat_widget` из каталога `/srv/builds/chat_widget`.» →
+  `update_front {app_id:…, build_dir:"/srv/builds/chat_widget", confirm:true}`
+  → `get_task {wait:true}`
+
+## Откат и обслуживание
+
+- «Откати compose сервиса до версии `12`.» →
+  `get_application` (найти id версии) → `restore_compose {version_id:12, confirm:true}`
+- «Верни env-файл `.env` сервиса к версии `7`.» →
+  `env_versions` → `restore_env_version {version_id:7, confirm:true}`
+- «Почисти версии конфигураций старше 180 дней.» →
+  `cleanup_old_versions {days:180, confirm:true}`
+
+## Мультистенд
+
+- «Покажи статус стендов `prod` и `stage` и сравни.» →
+  `overview {server:"prod"}` + `overview {server:"stage"}`
+- «На `stage` откати последний неудачный деплой, на `prod` ничего не трогай.» →
+  работа с `server:"stage"`
+
+> Опасные операции (`down`, `restore_*`, `update_front`, `download_release`,
+> `cleanup_old_versions`) требуют `confirm="true"` — агент обязан спросить
+> подтверждение явно.