{"meta":{"title":"Ваш первый пользовательский агент","intro":"Создайте и протестируйте свой первый пользовательский агент с помощью этого простого примера специалиста по README.","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-agents","title":"Пользовательские агенты"},{"href":"/ru/copilot/tutorials/customization-library/custom-agents/your-first-custom-agent","title":"Ваш первый пользовательский агент"}],"documentType":"article"},"body":"# Ваш первый пользовательский агент\n\nСоздайте и протестируйте свой первый пользовательский агент с помощью этого простого примера специалиста по README.\n\n> \\[!NOTE]\n>\n> * Примеры, приведенные в этой библиотеке, предназначены для вдохновения— рекомендуется настроить их для более конкретных проектов, языков и командных процессов.\n> * Примеры для конкретных языков и сценариев, предоставленные сообществом, см. в репозитории [настроек Awesome GitHub Copilot](https://github.com/github/awesome-copilot/tree/main/agents) .\n\n## Около Пользовательские агенты\n\nПользовательские агенты это специализированные версии Copilot облачный агент , которые сохраняют единую экспертизу на протяжении всех рабочих процессов. В отличие от пользовательских инструкций, которые применяются широко, или файлов запросов для одноразовых задач, Пользовательские агенты которые выбираются для конкретных задач и сохраняют свою конфигурацию на протяжении всего рабочего процесса.\n\nДля более подробного обзора см. [О пользовательских агентах](/ru/copilot/concepts/agents/cloud-agent/about-custom-agents).\n\n## Твой первый Пользовательский агент\n\nНачните с этого простого специализированного агента README, который помогает создавать и улучшать файлы project README.\n\n### Специалист по README Профиль агента\n\n```text copy\n---\nname: readme-specialist\ndescription: Specialized agent for creating and improving README files and project documentation\ntools: ['read', 'search', 'edit']\n---\n\nYou are a documentation specialist focused primarily on README files, but you can also help with other project documentation when requested. Your scope is limited to documentation files only - do not modify or analyze code files.\n\n**Primary Focus - README Files:**\n- Create and update README.md files with clear project descriptions\n- Structure README sections logically: overview, installation, usage, contributing\n- Write scannable content with proper headings and formatting\n- Add appropriate badges, links, and navigation elements\n- Use relative links (e.g., `docs/CONTRIBUTING.md`) instead of absolute URLs for files within the repository\n- Ensure all links work when the repository is cloned\n- Use proper heading structure to enable GitHub's auto-generated table of contents\n- Keep content under 500 KiB (GitHub truncates beyond this)\n\n**Other Documentation Files (when requested):**\n- Create or improve CONTRIBUTING.md files with clear contribution guidelines\n- Update or organize other project documentation (.md, .txt files)\n- Ensure consistent formatting and style across all documentation\n- Cross-reference related documentation appropriately\n\n**File Types You Work With:**\n- README files (primary focus)\n- Contributing guides (CONTRIBUTING.md)\n- Other documentation files (.md, .txt)\n- License files and project metadata\n\n**Important Limitations:**\n- Do NOT modify code files or code documentation within source files\n- Do NOT analyze or change API documentation generated from code\n- Focus only on standalone documentation files\n- Ask for clarification if a task involves code modifications\n\nAlways prioritize clarity and usefulness. Focus on helping developers understand the project quickly through well-organized documentation.\n```\n\n## Тестирование\n\nПротестируйте этот агент, дав ему задание для выполнения:\n\n1. Перейдите на вкладку агентов по адресу [https://github.com/copilot/agents](https://github.com/copilot/agents?ref_product=copilot\\&ref_type=engagement\\&ref_style=text).\n2. С помощью раскрывающихся меню в текстовом поле выберите репозиторий и ветвь, с которыми вам удобно проводить тестирование (в идеале с минимальным или устаревшим файлом README).\n3. Нажмите <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-copilot\" aria-label=\"copilot\" role=\"img\"><path d=\"M7.998 15.035c-4.562 0-7.873-2.914-7.998-3.749V9.338c.085-.628.677-1.686 1.588-2.065.013-.07.024-.143.036-.218.029-.183.06-.384.126-.612-.201-.508-.254-1.084-.254-1.656 0-.87.128-1.769.693-2.484.579-.733 1.494-1.124 2.724-1.261 1.206-.134 2.262.034 2.944.765.05.053.096.108.139.165.044-.057.094-.112.143-.165.682-.731 1.738-.899 2.944-.765 1.23.137 2.145.528 2.724 1.261.566.715.693 1.614.693 2.484 0 .572-.053 1.148-.254 1.656.066.228.098.429.126.612.012.076.024.148.037.218.924.385 1.522 1.471 1.591 2.095v1.872c0 .766-3.351 3.795-8.002 3.795Zm0-1.485c2.28 0 4.584-1.11 5.002-1.433V7.862l-.023-.116c-.49.21-1.075.291-1.727.291-1.146 0-2.059-.327-2.71-.991A3.222 3.222 0 0 1 8 6.303a3.24 3.24 0 0 1-.544.743c-.65.664-1.563.991-2.71.991-.652 0-1.236-.081-1.727-.291l-.023.116v4.255c.419.323 2.722 1.433 5.002 1.433ZM6.762 2.83c-.193-.206-.637-.413-1.682-.297-1.019.113-1.479.404-1.713.7-.247.312-.369.789-.369 1.554 0 .793.129 1.171.308 1.371.162.181.519.379 1.442.379.853 0 1.339-.235 1.638-.54.315-.322.527-.827.617-1.553.117-.935-.037-1.395-.241-1.614Zm4.155-.297c-1.044-.116-1.488.091-1.681.297-.204.219-.359.679-.242 1.614.091.726.303 1.231.618 1.553.299.305.784.54 1.638.54.922 0 1.28-.198 1.442-.379.179-.2.308-.578.308-1.371 0-.765-.123-1.242-.37-1.554-.233-.296-.693-.587-1.713-.7Z\"></path><path d=\"M6.25 9.037a.75.75 0 0 1 .75.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 .75-.75Zm4.25.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 1.5 0Z\"></path></svg>, затем **выберите<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-plus\" aria-label=\"Plus button\" role=\"img\"><path d=\"M7.75 2a.75.75 0 0 1 .75.75V7h4.25a.75.75 0 0 1 0 1.5H8.5v4.25a.75.75 0 0 1-1.5 0V8.5H2.75a.75.75 0 0 1 0-1.5H7V2.75A.75.75 0 0 1 7.75 2Z\"></path></svg> Создать Пользовательский агент**.\n4. В каталоге, в выбранном вами репозитории, откроется Профиль агента`my-agent.agent.md` шаблон с вызовом`.github/agents`. Назовите файл `readme-specialist.agent.md` и вставьте в пример Профиль агента.\n5. Зафиксируйте и объедините этот файл с ветвью репозитория по умолчанию. Go back на вкладку агентов (возможно, потребуется обновить страницу) и в текстовом поле выберите своего агента «readme-specialist» из выпадающего меню.\n6. В текстовом поле введите задачу для агента (например, пример ниже) и нажмите **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-paper-airplane\" aria-label=\"Start task\" role=\"img\"><path d=\"M.989 8 .064 2.68a1.342 1.342 0 0 1 1.85-1.462l13.402 5.744a1.13 1.13 0 0 1 0 2.076L1.913 14.782a1.343 1.343 0 0 1-1.85-1.463L.99 8Zm.603-5.288L2.38 7.25h4.87a.75.75 0 0 1 0 1.5H2.38l-.788 4.538L13.929 8Z\"></path></svg>**<kbd>или нажмите Enter</kbd>.\n\n   ```copilot copy\n   Please review and improve our README.md file.\n   ```\n\nЗадача агента появится на странице под текстовым полем. Агент сосредоточится именно на улучшении README, используя свои специализированные знания, создав запрос на вытягивание в вашем репозитории. Вы можете нажать на задачу и следовать за ней вместе с оператором. Дополнительные сведения см. в разделе [Сессии управляющих агентов](/ru/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents).\n\n## Дополнительные материалы\n\n* [О пользовательских агентах](/ru/copilot/concepts/agents/cloud-agent/about-custom-agents)\n* [Создание кастомных агентов для Copilot облачный агент](/ru/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents)\n* [Настройка пользовательских агентов](/ru/copilot/reference/custom-agents-configuration)"}