# О пользовательских агентах

Custom agents Улучшайте Copilot с помощью поддержки, адаптированной к вашим потребностям.

## Около custom agents

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

Вы определяете custom agents использование файлов Markdown под названием agent profiles. Эти файлы указывают подсказки, инструменты и MCP-серверы. Это позволяет напрямую кодировать ваши конвенции, фреймворки и желаемые результаты в Copilot.

Определяет agent profilecustom agentповедение '. Когда вы назначаете агента задачу или проблему, он инстанцирует custom agent.

## Agent profile формат

Agent profiles — это файлы Markdown с YAML-фронтматтером. В самом простом виде они включают в себя:

* **Имя** (по желанию): Отображаемое имя для custom agent. Если оно опущено, имя файла агента используется в качестве идентификатора и отображаемого имени по умолчанию.
* **Описание**: Объясняет назначение и возможности агента.
* **Подсказка**: Пользовательские инструкции, определяющие поведение и экспертизу агента.
* **Tools** (опционально): Конкретные инструменты, которые агент может access. По умолчанию агенты имеют доступ ко всем доступным инструментам, включая встроенные инструменты и MCP-серверные инструменты.

Agent profiles также может включать конфигурации MCP-сервера с использованием этого `mcp-servers` свойства.

### Пример agent profile

Этот пример — базовый agent profile вариант с настраиванием названия, описания и запроса.

```text
---
name: readme-creator
description: Agent specializing in creating and improving README files
---

You are a documentation specialist focused on README files. Your scope is limited to README files or other related documentation files only - do not modify or analyze code files.

Focus on the following instructions:
- Create and update README.md files with clear project descriptions
- Structure README sections logically: overview, installation, usage, contributing
- Write scannable content with proper headings and formatting
- Add appropriate badges, links, and navigation elements
- Use relative links (e.g., `docs/CONTRIBUTING.md`) instead of absolute URLs for files within the repository
- Make links descriptive and add alt text to images
```

## Где можно настроить custom agents

Вы можете определить agent profiles на разных уровнях:

* **уровень репозитория**: Создайте `.github/agents/CUSTOM-AGENT-NAME.md` в своём репозитории для project-специфических агентов.
* **Организационный** уровень: Создавайте `/agents/CUSTOM-AGENT-NAME.md` материалы в `.github` организации или `.github-private` в репозитории для более широкой доступности внутри организации.
* **Корпоративный** уровень: Создайте `/agents/CUSTOM-AGENT-NAME.md` в `.github-private` репозитории организации, которое владелец предприятия определил в корпоративных настройках для доступности во всех репозиториях предприятия.

Дополнительные сведения см. в разделе \[AUTOTITLE и [Подготовка к использованию пользовательских агентов в организации](/ru/copilot/how-tos/administer-copilot/manage-for-organization/prepare-for-custom-agents)]\(/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents).

## Где можно использовать custom agents

> \[!NOTE]
> Custom agents находятся в Публичный предварительный просмотр для IDEs JetBrains, Eclipse и Xcode и могут измениться.

После создания custom agentsони становятся доступны для:

* **Copilot cloud agent на GitHub.com**: вкладка и панель агентов, назначение выдачи и pull requests
* **Copilot cloud agent в IDE**: Visual Studio Code, JetBrains IDE, Eclipse и Xcode
* **GitHub Copilot CLI**

Вы можете использовать agent profiles напрямую в Visual Studio CodeIDE JetBrains, Eclipse и Xcode. Некоторые свойства могут функционировать иначе или игнорировать между окружениями.

Для получения дополнительной информации об custom agents использовании в Visual Studio Codeсм. [Custom agents в VS Code](https://code.visualstudio.com/docs/copilot/customization/custom-agents).

## Дальнейшие действия

Чтобы создать свою собственную custom agents, см.:

* [Создание кастомных агентов для Copilot cloud agent](/ru/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents)
* [Создание и использование пользовательских агентов для GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli)
* [Шпаргалка для кастомизации Copilot](/ru/copilot/reference/customization-cheat-sheet)