{"meta":{"title":"Ваши первые пользовательские инструкции","intro":"Создайте и проверьте первую пользовательскую инструкцию с помощью этого простого примера.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ru/copilot","title":"GitHub Copilot"},{"href":"/ru/copilot/tutorials","title":"Учебники"},{"href":"/ru/copilot/tutorials/customization-library","title":"Библиотека настройки"},{"href":"/ru/copilot/tutorials/customization-library/custom-instructions","title":"Пользовательские инструкции"},{"href":"/ru/copilot/tutorials/customization-library/custom-instructions/your-first-custom-instructions","title":"Ваши первые пользовательские инструкции"}],"documentType":"article"},"body":"# Ваши первые пользовательские инструкции\n\nСоздайте и проверьте первую пользовательскую инструкцию с помощью этого простого примера.\n\n> \\[!NOTE]\n>\n> * Примеры, приведенные в этой библиотеке, предназначены для вдохновения— рекомендуется настроить их для более конкретных проектов, языков и командных процессов.\n> * Примеры пользовательских инструкций для определенных языков и сценариев в сообществе см. в [репозитории GitHub Copilot Customs](https://github.com/github/awesome-copilot/blob/main/docs/README.instructions.md) .\n> * Пользовательские инструкции можно применять в разных областях в зависимости от платформы или интегрированной среды разработки, в которой вы создаете их. Дополнительные сведения см. в разделе «[О кастомизации ответов GitHub Copilot](/ru/copilot/concepts/prompting/response-customization)».\n\n## Сведения о настройках\n\nВы можете настроить ответы GitHub Copilot, используя два типа файлов:\n\n* **Пользовательские инструкции предоставляют текущие рекомендации** по работе GitHub Copilot во всех взаимодействиях.\n* **Файлы запроса (общедоступная предварительная версия)** определяют повторно используемые запросы для определенных задач, которые можно вызвать при необходимости. Файлы запросов доступны только в IDE VS Code, Visual Studio и JetBrains. Вводный пример см. [в разделе AUTOTITLE.](/ru/copilot/tutorials/customization-library/prompt-files/your-first-prompt-file)\n\nХотя пользовательские инструкции помогают добавить контекст в каждый рабочий процесс ИИ, файлы запросов позволяют добавлять инструкции в определенное взаимодействие чата.\n\nПользовательские инструкции репозитория наиболее часто используются и поддерживаются, но также можно определить личные и организационные пользовательские инструкции только для GitHub Copilot Chat in GitHub. Пользовательские инструкции репозитория можно создать двумя способами:\n\n* **Инструкции** на уровне репозитория: создайте один `copilot-instructions.md` файл в корневом каталоге репозитория, который применяется ко всем файлам в репозитории.\n* **Инструкции** для конкретного `.instructions.md` пути: создайте один или несколько `applyTo` файлов с полем, которое применяется только к определенным файлам или каталогам. В настоящее время поддерживаются инструкции, специфичные для пути, для **Copilot Chat**Visual Studio CodeVisual Studio, и .**Copilot cloud agent**\n\n## Ваши первые инструкции\n\nНачните с этих основных пользовательских инструкций, которые помогают GitHub Copilot понять ваши настройки кодирования.\n\n### Инструкции по написанию функций\n\n```markdown copy\nWhen writing functions, always:\n- Add descriptive JSDoc comments\n- Include input validation\n- Use early returns for error conditions\n- Add meaningful variable names\n- Include at least one example usage in comments\n```\n\nЭти инструкции изменят способ создания функций GitHub Copilot.\n\n## Тестирование\n\nЧтобы быстро проверить разницу от пользовательских инструкций, можно использовать личные инструкции в Copilot Chat.\n\n1. Сначала перейдите в [github.com/copilot](https://github.com/copilot?ref_product=copilot\\&ref_type=trial\\&ref_style=text) и введите этот запрос:\n\n   `Create a JavaScript function that calculates the area of a circle`\n\n**Без пользовательских инструкций** можно получить:\n\n````\n```javascript\nfunction areaOfCircle(radius) {\n    if (typeof radius !== 'number' || radius < 0) {\n        throw new Error('Radius must be a non-negative number');\n    }\n    return Math.PI * radius * radius;\n}\n```\n````\n\n1. Теперь access свои индивидуальные инструкции, кликнув на фотографию профиля в левом нижнем углу страницы, затем **Personal instructions**. Вставьте приведенные выше инструкции в текстовое поле и нажмите кнопку **\"Сохранить**\".\n\n   Теперь введите тот же запрос, который вы ввели ранее.\n\n**С пользовательскими инструкциями** вы получите примерно следующее:\n\n````\n```javascript\n/**\n * Calculates the area of a circle given its radius.\n * * @param {number} radius - The radius of the circle. Must be a positive number.\n * @returns {number|null} The area of the circle, or null if the input is invalid.\n * * @example\n * // returns 78.53981633974483\n * areaOfCircle(5);\n * * @example\n * // returns null (invalid input)\n * areaOfCircle(-2);\n */\nfunction areaOfCircle(radius) {\n  if (typeof radius !== \"number\" || isNaN(radius) || radius <= 0) {\n    // Invalid input: radius must be a positive number\n    return null;\n  }\n\n  const area = Math.PI * Math.pow(radius, 2);\n  return area;\n}\n\n// Example usage:\nconsole.log(areaOfCircle(5));   // 78.53981633974483\nconsole.log(areaOfCircle(-2));  // null\n```\n````\n\n## Дополнительные материалы\n\n* [О кастомизации ответов GitHub Copilot](/ru/copilot/concepts/prompting/response-customization) — обзор настройки ответа в GitHub Copilot\n* [Добавьте пользовательские инструкции для Copilot](/ru/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions) — настройка пользовательских инструкций\n* [Удивительные настройки](https://github.com/github/awesome-copilot/blob/main/README.md) GitHub Copilot — репозиторий пользовательских инструкций, внесенных сообществом, и других настроек для определенных языков и сценариев"}