QFE

Использование Copilot: кейсы и примеры промптов

Copilot — ИИ-помощник, который работает в редакторе кода и понимает задачи, описанные обычным языком. Он как коллега, который берёт на себя рутину, но результат почти всегда требует вашей проверки. Для техписателя это особенно удобно, когда документация лежит в git (системе контроля версий) рядом с кодом — помощник видит файлы проекта и может их создавать, проверять и редактировать.

Задачу для Copilot называют промптом. Хороший промпт короткий, но самодостаточный: в нём есть контекст и ожидаемый результат. Разберём четыре кейса — промпты можно копировать и подставлять свои файлы.

📝 Кейс 1. Завести файл со стилем документации.

Сначала опишите правила стиля в отдельном файле — тогда Copilot будет придерживаться их в каждой задаче, а не угадывать стиль заново. Промпт:

Создай файл doc-style.md — правила стиля нашей документации: обращение на «вы», простые слова без канцелярита, первое упоминание термина сразу поясняем. Оформи чек-листом.

Внутри может получиться, например, такой чек-лист:

- Обращаемся к читателю на «вы».
- Пишем «используйте» вместо «осуществляйте».
- Новый термин объясняем при первом упоминании.

📝 Кейс 2. Проверить существующую документацию.

Канцелярит — это бюрократический язык: «осуществлять», «в рамках». Искать такие обороты и длинные абзацы вручную утомительно, поэтому поручите поиск Copilot, а решение об исправлениях оставьте себе. Промпт:

Проверь install.md по правилам из doc-style.md: найди канцелярит, длинные абзацы и непояснённые термины. Покажи проблемы списком с цитатами.

📝 Кейс 3. Написать новую документацию.

Черновые заметки есть у каждого техписателя, но собирать из них ровный текст — долгая работа. Copilot напишет раздел в вашем стиле, а вы отредактируете результат как текст коллеги. Промпт:

Напиши раздел «Установка» для инструкции новичка: шаги нумерованным списком, один шаг — одно действие, стиль по doc-style.md. Вот мои черновые заметки: …

📝 Кейс 4. Собрать changelog из истории изменений.

Changelog — список изменений продукта для пользователей. История уже хранится в git — по одному коммиту на каждую порцию правок, — и Copilot может переписать её человеческим языком. Промпт:

Посмотри последние 10 коммитов и собери черновик changelog для пользователей: что нового, что изменилось, что исправлено. Без технического жаргона.

🌼 Упражнение

Выберите кейс, который ближе к вашей работе, и попробуйте его на своём проекте.

1. Скопируйте промпт и подставьте название своего файла.
2. Отправьте промпт Copilot.
3. Прочитайте результат и внесите свои правки.

Получилось? Если нет, то задавайте вопросы в комментариях. 💖

Подключение своей модели к Copilot в VS Code

В прошлом посте мы говорили о безопасности данных. Теперь настроим инструмент: пусть чат GitHub Copilot (ИИ-помощник редактора VS Code) работает через вашу модель — например, GLM от компании z.ai.

⚙️ Свою модель подключают через режим Bring Your Own Key.

Bring Your Own Key (BYOK, «принеси свой ключ») — режим, при котором чат VS Code отправляет запросы к модели вашего провайдера, а не к встроенной. Провайдер — компания, которая открывает доступ к своим моделям.

Это как SIM-карта в телефоне: аппарат тот же, а оператор — ваш. Бонус: для чата с собственной моделью подписка Copilot не нужна. Но помните про границы: через свою модель работает чат, а автодополнение при наборе и часть функций остаются на стороне обычного Copilot.

⚙️ Что понадобится?

Список короткий:

🔑 Редактор VS Code с чатом Copilot.
🔑 API-ключ провайдера. API, Application Programming Interface — договорённость, по которой программы общаются между собой. Ключ работает как пароль: подтверждает, что запросы делаете вы.
🔑 Адрес эндпоинта. Эндпоинт (endpoint, «точка входа») — адрес, по которому редактор отправляет запросы к модели.

⚙️ Шаги подключения.

Официально задокументированный способ — провайдер Custom Endpoint (свой эндпоинт). На macOS и Windows шаги одинаковые:

1. В окне чата нажмите на имя модели рядом с полем ввода.
2. Выберите Manage Language Models (управление моделями) — значок шестерёнки. Другой путь — палитра команд Command Palette: Cmd+Shift+P на macOS или Ctrl+Shift+P на Windows, затем команда Chat: Manage Language Models.
3. Нажмите Add Models (добавить модели) и выберите Custom Endpoint.
4. Введите имя группы моделей, отображаемое имя и API-ключ.
5. Выберите тип API (Chat Completions, Responses или Messages), который поддерживает ваш провайдер.
6. Откроется файл chatLanguageModels.json: впишите в него идентификатор модели и URL эндпоинта, сохраните файл.
7. Выберите добавленную модель в списке чата. Если её нет — перезапустите VS Code.

⚙️ С подпиской провайдера есть нюанс.

У z.ai есть подписка GLM Coding Plan с моделями GLM и отдельными адресами эндпоинтов. Но она официально поддерживает только инструменты из списка самого z.ai — проверьте его на docs.z.ai, прежде чем платить. Если чата Copilot в списке нет, детали подключения и выбор ключа уточняйте в документации провайдера.

🌼 Упражнение

Проверим настройку на техписательской задаче:

1. Создайте файл test-notes.md с предложением: «В данном разделе осуществляется процесс настройки подключения провайдера.»
2. Попросите Copilot: «Перепиши предложение простым языком, сохранив смысл: …»
3. Если пришёл упрощённый вариант — ваша модель отвечает.

Получилось? Если нет, задавайте вопросы в комментариях. 💖

Работать работу и писать посты

На прошлой неделе из-за работы я не успела закончить курс, поэтому в конце недели я решила сделать видео о том, как я пишу оставшиеся посты курса вместе с нейросеткой GLM 5.2 и инструментом Copilot Orchestrator.

Ссылка на видео: https://youtu.be/zemuOG1ewAw
Ссылка на репозиторий с рабочими файлами: https://github.com/elenashliaga/create-posts-tutorial

Буду рада, если вам видео понравится. Все созданные посты я опубликую на канале на этой неделе 💪

Безопасность данных

Взаимодействуя с нейросетями через сторонних провайдеров, мы отправляем промпты на внешние серверы. Эти данные могут сохраняться и использоваться для обучения моделей.

Чтобы избежать утечек, соблюдайте базовую гигиену работы с ИИ:

🚫 Удаляйте доступы и секреты — всегда вырезайте из кода и логов API-ключи, пароли, токены и строки подключения к базам данных.

🚫 Удаляйте персональные данные — исключайте ФИО, контакты и паспорта из текстов и прикрепляемых файлов.

🚫 Не загружайте коммерческие секреты и код — договоры, финансовые отчеты и ключевые фрагменты закрытого кода компании должны оставаться внутри.

🚫 Соблюдайте NDA — обезличивайте запросы: заменяйте реальные названия компании, продуктов и клиентов на нейтральные.

💡 Заменяйте реальные данные синтетическими. Вместо реального конфига используйте example.com, user_123 и фейковые ключи вроде sk-test-000000.

Кто такой ИИ агент

Последние результаты ИИ моделей поражают воображение. Они умеют писать код, выводить формулы, писать документацию. И все это можно делать с помощью ИИ агентов.

Важно понимать разницу между обычным чатом и агентом. Агент — это практически сотрудник, который может решать поставленные ему задачи и принимать решения самостоятельно.

Вы можете попросить агента написать документацию по коду или исправить баг в коде. В таком случае вы запустите настоящий мыслительный процесс, результатом которого может быть как решение вашей проблемы, так и наличие новой проблемы в виде удаленной операционной системы или слитой конфиденциальной информации.

Это все приводит к важному вопросу: Как безопасно использовать агентов? С этого вопроса я завтра начну разбирать работу с агентами.

Курсы от канала

Думаю, многие из вас когда-то присоединились из-за бесплатных курсов, которые я проводила на канале. Ссылки на прошедшие курсы можно найти в Навигации.

Из новых курсов я думала о том, чтобы провести бесплатный курс для начинающих по использованию ИИ. Рассказать, какие инструменты бывают, показать примеры использования, возможно рассказать немного о безопасном использовании. Но я все никак не могла набраться мотивации его провести.

Думаю, что я наконец готова его провести. На следующей неделе ждите постов про использование ИИ.

Хеширование и шифрование

Хеширование — это одностороннее преобразование данных. Из текста любого объема создается уникальная строка фиксированной длины (хеш), но восстановить исходный текст из этого хеша невозможно. Используется для безопасного хранения паролей и проверки целостности файлов.

Шифрование — это обратимый процесс. Данные кодируются с помощью ключа так, чтобы их никто не мог прочесть, но при наличии ключа их можно расшифровать обратно в исходный вид. Используется для защиты переписки и передачи секретной информации.

Простыми словами: хеширование работает только в одну сторону (для проверки), а шифрование — в обе стороны (для скрытия и последующего чтения).

Горизонтальное и вертикальное масштабирование

Вертикальное масштабирование (Scale Up) — это увеличение мощности одного имеющегося сервера. Вы добавляете на ту же машину больше оперативной памяти, более мощный процессор или объемный диск.

Например, обновление домашнего компьютера — вы докупаете и вставляете дополнительную оперативную память, чтобы один ПК справлялся с тяжелыми программами.

Горизонтальное масштабирование (Scale Out) — это увеличение количества серверов в системе. Вы не меняете железо на текущей машине, а подключаете новые сервера и распределяете нагрузку между ними.

Например, открытие дополнительных касс в супермаркете перед праздниками. Вместо того чтобы заставлять одного кассира работать в пять раз быстрее, магазин открывает еще четыре кассы и делит очередь между ними.

Репликация и шардинг

Репликация — это процесс полного копирования всей базы данных на несколько разных серверов, где на каждом узле дублируется одна и та же информация. Это нужно для повышения надежности системы и ускорения чтения данных.

Шардинг — это процесс разделения одной крупной базы данных на отдельные фрагменты и их распределение по разным серверам. В этом случае каждый сервер хранит только свою уникальную часть данных, что позволяет обрабатывать огромные объемы информации и распределять нагрузку на запись.

Простыми словами, репликация создает клоны одних и тех же данных на разных узлах, а шардинг разрезает общую базу на уникальные части и раскладывает их по разным машинам.

Идентификация и Аутентификация

Мнения разделились.

Идентификация — это процесс, когда вы передаете свои данные. То есть вводите логин на портале или называете имя и фамилию на входе охраннику.

Аутентификация подразумевает проверку вашей личности тем или иным способом. То есть процесс, когда охранник подтверждает вашу личность, сравнивая вашу фотографию, это аутентификация.

Авторизация же происходит, когда вы получаете допуск к данным или в здание.