# Создание агентских рабочих процессов GitHub Создавайте индивидуальные автоматизации на базе ИИ, адаптированные к потребностям вашего репозитория. > \[!NOTE] > GitHub агентические рабочие процессы are in Публичный предварительный просмотр and subject to change. ## О создании GitHub агентические рабочие процессы Вы можете создавать GitHub агентические рабочие процессы с помощью кодинг-агента (рекомендуют) или вручную. Рабочий процесс — это файл markdown, `.github/workflows/` содержащий YAML-фронтматтер для настройки и инструкции на естественном языке для AI-агента. Чтобы создать агентный рабочий процесс, вы определяете рабочий процесс в markdown, компилируете его в `.lock.yml` файл, фиксируете оба файла, затем запускаете через GitHub Actions триггеры или .GitHub CLI В этой статье внимание уделяется основным задачам: созданию, обновлению и повторному использованию рабочих процессов. Для полной технической детализации и дополнительных шаблонов используйте [GitHub агентические рабочие процессы сайт документации](https://github.github.com/gh-aw/). ## Предпосылки Прежде чем начать, убедитесь, что у вас есть: * Аккаунт ИИ: GitHub Copilot, Anthropic Claude, OpenAI Codex, или Google Gemini * Репозиторий, GitHub где у вас есть доступ к записи * GitHub Actions включено для репозитория * GitHub CLI (`gh`) v2.0.0 или более поздней версии установлена и аутентифицирована Чтобы проверить версию, выполните команду `gh --version`. Для аутентификации запустите: ```shell gh auth login --scopes repo,workflow ``` * Расширение GitHub агентические рабочие процессы для установленных GitHub CLI : ```shell gh extension install github/gh-aw ``` Если вы используете GitHub CLI версию 2.90.0 или выше, запуск любой `gh aw` команды подскажет вам автоматически установить расширение, если оно ещё не установлено. ## Аутентификация Вы можете настроить аутентификацию с помощью выбранного вами ИИ-движка (программного агента) двумя способами: * [Использование встроенного `GITHUB_TOKEN`](#using-the-built-in-github_token) устройства Для выставления счетов организации (рекомендую). Эта опция предназначена специально для GitHub Copilot движка и может использоваться только репозиториями, принадлежащими организации с планом GitHub Copilot . * [Использование personal access token ключа API-файла](#using-a-personal-access-token-or-api-key) для личных репозиториев и сторонних ИИ-движков. ### Использование встроенного устройства `GITHUB_TOKEN` > \[!TIP] > Если вы используете GitHub Copilot его в репозитории, принадлежащем организации, настоятельно рекомендуется встроенный `GITHUB_TOKEN` подход в этом разделе. Если вы используете GitHub Copilot его в репозитории, принадлежащем организации, вы можете использовать GitHub Actions' встроенный `GITHUB_TOKEN` вместо personal access token. Это напрямую счёт за использование рабочего процесса вашей организации и избавляет от необходимости управлять секретом personal access token для Copilot запросов. Чтобы это настроить: 1. Администратор вашей организации должен включить политику «Разрешить использование Copilot CLI, выставленного за организацию», если она ещё не включена, в настройках Copilot. 2. Для рабочих процессов, которые вы хотите выставить счета организации, укажите `copilot-requests: write` фронтматтер `permissions`рабочих процессов. #### Возможность выставления счетов организациям В настройках политики GitHub Copilot должна быть включена опция «Разрешить использование Copilot CLI, выставленного организации». Если политика «Copilot CLI» уже включена, то она по умолчанию активна. 1. В правом верхнем углу GitHub, щелкните рисунок профиля, а затем выберите **октикона "организация" aria-hidden="true" aria-label="organization" %} Ваши организации**. 2. Выберите организацию, кликнув по ней. 3. Под именем организации щелкните ** Settings**. Если вкладка "Параметры" не отображается, выберите **раскрывающееся меню ** и нажмите кнопку **"Параметры**". ![Снимок экрана: вкладки в профиле организации. Вкладка "Параметры" выделена темно-оранжевым цветом.](/assets/images/help/discussions/org-settings-global-nav-update.png) 4. В боковой панели нажмите **Copilot**, затем **выберите Политики**. 5. Включите «Copilot CLI», затем включите «Разрешить использование Copilot CLI, выставленного в счёт организации». #### Выставление счетов за рабочий процесс организации При создании рабочего процесса необходимо включить `copilot-requests: write` в `permissions` переднюю часть рабочего процесса. Когда это разрешение установлено, токен GitHub Actions' используется для Copilot запросов, а `COPILOT_GITHUB_TOKEN` игнорируется для этих запросов. Если токен GitHub Actions не имеет доступа GitHub Copilot от организации, рабочий процесс сбивает при отправке Copilot запросов, и следует настроить `COPILOT_GITHUB_TOKEN`. ```yaml permissions: contents: read copilot-requests: write ``` ### Использование ключа API personal access token или Для личных репозиториев или сторонних ИИ-движков нужно создать секрет репозитория, хранящий personal access token API-ключ. Для GitHub Copilot, секрет в `COPILOT_GITHUB_TOKEN`, который хранит мелкозернистый personal access token. Если вы используете `gh aw add-wizard`, процесс настройки подсказывает вам создать этот секрет. Если вы создаёте агентский рабочий процесс из веб-интерфейса или вручную GitHub , сначала нужно добавить секрет самостоятельно в секреты GitHub Actions вашего репозитория — либо в GitHub интерфейсе, либо в `gh aw secrets set` CLI. Для инструкций см. [ссылку на аутентификацию](https://github.github.com/gh-aw/reference/auth/). ## Создание рабочего процесса Рекомендуемый способ создания Агентные рабочие процессы — использовать CLI-кодировочный агент или VS Code. Это даёт вам один ориентировочный путь для создания, компиляции и фиксации рабочего процесса. ### Использование CLI-кодирующего агента или VS Code 1. Используя GitHub CLIGitHub агентические рабочие процессы расширение (`gh aw`), инициализируйте репозиторий для агентного авторства (рекомендуется для первой настройки в репозитории): ```shell gh aw init ``` Это добавляет навыки, инструкции и пользовательский агент, связанный с авторингом агентских рабочих процессов, чтобы агенты по программированию могли более эффективно создавать и редактировать рабочие процессы. 2. Запустите свой программный агент в контексте вашего репозитория (например Второй пилот CLI , в режиме агента VS Code). 3. Введите запрос с указанием навыка `agentic-workflows` и описанием желаемого рабочего процесса: ```copilot copy /agentic-workflows Create a new workflow that creates a daily report on recent activity in the repository, delivered as an issue. ``` 4. Агент создаст рабочий процесс и скомпилирует его с помощью GitHub CLI. 5. Просмотрите рабочий процесс, затем попросите агента зафиксировать и отправить файлы. 6. Запускайте рабочий процесс через GitHub Actions вкладку или с GitHub CLI помощью запуска: ```shell gh aw run YOUR-WORKFLOW-NAME ``` ### Другие методы создания Вы также можете создавать агентные рабочие процессы: * В GitHub веб-интерфейсе. См. [creating workflows в веб-интерфейсе GitHub](https://github.github.com/gh-aw/setup/creating-workflows/#github-web-interface). * Вручную. См. создание [рабочих процессов с помощью ручного редактирования](https://github.github.com/gh-aw/setup/creating-workflows/#manual-editing). ## Ссылка на структуру рабочих процессов Каждый файл разметки рабочего процесса состоит из двух частей: | Секция | Purpose | | ----------------------- | --------------------------------------------------------------------------------------------- | | **Фронт YAML** | Определяет триггеры (`on`), разрешения, безопасные выходы и движок искусственного интеллекта. | | **Кузов с маркировкой** | Инструкции на естественном языке, которым следует агент ИИ при работе рабочего процесса. | Ключевые области фронтматэра: | Поле | Description | | -------------- | ---------------------------------------------------------------------------------------------------------------- | | `on` | Триггер события (тот же синтаксис, что и GitHub Actions триггеры). | | `permissions` | Разрешения на репозиторий, предоставленные агенту. По умолчанию — `read-all`. | | `safe-outputs` | Операции записи, которые агент может выполнять (например, `create-issue`, `add-comment`, `create-pull-request`). | | `engine` | Движок ИИ для использования (`copilot` по умолчанию; `claude`, `codex`, и `gemini` также поддерживается). | Для полной информации о фронтматтере см. [GitHub агентические рабочие процессы документацию frontmatter](https://github.github.com/gh-aw/reference/frontmatter/). ## Пример агентного рабочего процесса Следующий пример — упрощённый еженедельный отчет о активности выпуска для репозитория. ```markdown --- on: weekly on monday permissions: issues: read copilot-requests: write network: defaults tools: github: toolsets: [issues] safe-outputs: create-issue: --- # Weekly issue activity report Review issue activity from the last 7 days in this repository. Create a GitHub issue that includes: - Total issues opened and closed this week. - The top recurring themes from issue titles and descriptions. - A short list of notable issues that still need attention. - Two or three actionable recommendations for maintainers. Keep the report concise and action-oriented. ``` ## Обновление рабочего процесса Чтобы обновить существующий рабочий процесс: 1. Отредактировать файл разметки рабочего процесса в `.github/workflows/`. 2. Перекомпиляция для обновления файла блокировки: ```shell gh aw compile ``` 3. Коммит и отправь оба обновлённых файла. 4. Откройте pull request и проверьте GitHub Actions проверки. Подробные рекомендации по редактированию смотрите [раздел Редактирование рабочих](https://github.github.com/gh-aw/guides/editing-workflows/) процессов. ## Повторное использование рабочих процессов Вы также можете импортировать рабочие процессы из внешних репозиториев, к которым доступны. Например, вы можете добавить рабочий процесс из `githubnext/agentics`: ```shell gh aw add-wizard githubnext/agentics/daily-repo-status ``` Для неинтерактивной настройки можно использовать `gh aw add` и, по желанию, закрепить версию. Когда вы импортируете рабочий процесс, GitHub CLI сохраняйте `source:` значение в фронтмате, чтобы позже обновить данные из upstream с `gh aw update`помощью . Импортируйте рабочие процессы только с тех источников, которым доверяете, и проверяйте работу процесса перед добавлением в репозиторий. Рабочие процессы, отмеченные `private: true` , нельзя импортировать в другие репозитории. Когда вы обновляете импортированный рабочий процесс, GitHub CLI старайтесь сохранить локальные изменения. Если возникают конфликты слияния, разрешайте их и запускайте `gh aw compile` снова. Для получения дополнительной информации см. [раздел «Повторное использование рабочих процессов](https://github.github.com/gh-aw/guides/reusing-workflows/)». ## Дальнейшие действия * Примеры рабочих процессов, продвинутые шаблоны, руководства и информацию по устранению неполадок смотрите [GitHub агентические рабочие процессы сайт документации](https://github.github.com/gh-aw/).