Создание агентских рабочих процессов GitHub

О создании GitHub Agentic Workflows

Вы можете создавать GitHub Agentic Workflows с помощью кодинг-агента (рекомендуют) или вручную. Рабочий процесс — это файл markdown, .github/workflows/ содержащий YAML-фронтматтер для настройки и инструкции на естественном языке для AI-агента.

Чтобы создать агентный рабочий процесс, вы определяете рабочий процесс в markdown, компилируете его в .lock.yml файл, фиксируете оба файла, затем запускаете через GitHub Actions триггеры или .GitHub CLI

В этой статье внимание уделяется основным задачам: созданию, обновлению и повторному использованию рабочих процессов. Для полной технической детализации и дополнительных шаблонов используйте GitHub Agentic Workflows сайт документации.

Предпосылки

Прежде чем начать, убедитесь, что у вас есть:

• Аккаунт ИИ: GitHub Copilot, Anthropic Claude, OpenAI Codex, или Google Gemini

• Репозиторий, GitHub где у вас есть доступ к записи

• GitHub Actions включено для репозитория

• GitHub CLI (gh) v2.0.0 или более поздней версии установлена и аутентифицирована

  Чтобы проверить версию, выполните команду gh --version. Для аутентификации запустите:

  gh auth login --scopes repo,workflow
  

• Расширение GitHub Agentic Workflows для установленных GitHub CLI :

  gh extension install github/gh-aw
  

  Если вы используете GitHub CLI версию 2.90.0 или выше, запуск любой gh aw команды подскажет вам автоматически установить расширение, если оно ещё не установлено.

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

Вы можете настроить аутентификацию с помощью выбранного вами ИИ-движка (программного агента) двумя способами:

• Использование встроенного GITHUB_TOKEN устройства Для выставления счетов организации (рекомендую). Эта опция предназначена специально для GitHub Copilot движка и может использоваться только репозиториями, принадлежащими организации с планом GitHub Copilot .
• Использование personal access token ключа API-файла для личных репозиториев и сторонних ИИ-движков.

Использование встроенного устройства 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. Если вкладка "Параметры" не отображается, выберите раскрывающееся меню и нажмите кнопку "Параметры".

   

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.

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. Для инструкций см. ссылку на аутентификацию.

Создание рабочего процесса

Рекомендуемый способ создания Агентные рабочие процессы — использовать CLI-кодировочный агент или VS Code. Это даёт вам один ориентировочный путь для создания, компиляции и фиксации рабочего процесса.

Использование CLI-кодирующего агента или VS Code

1. Используя GitHub CLIGitHub Agentic Workflows расширение (gh aw), инициализируйте репозиторий для агентного авторства (рекомендуется для первой настройки в репозитории):

   gh aw init
   

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

2. Запустите свой программный агент в контексте вашего репозитория (например Второй пилот CLI , в режиме агента VS Code).

3. Введите запрос с указанием навыка agentic-workflows и описанием желаемого рабочего процесса:

   Copilot prompt

   /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 помощью запуска:

   gh aw run YOUR-WORKFLOW-NAME
   

Другие методы создания

Вы также можете создавать агентные рабочие процессы:

• В GitHub веб-интерфейсе. См. creating workflows в веб-интерфейсе GitHub.
• Вручную. См. создание рабочих процессов с помощью ручного редактирования.

Ссылка на структуру рабочих процессов

Каждый файл разметки рабочего процесса состоит из двух частей:

Секция	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 Agentic Workflows документацию frontmatter.

Пример агентного рабочего процесса

Следующий пример — упрощённый еженедельный отчет о активности выпуска для репозитория.

---
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. Перекомпиляция для обновления файла блокировки:

   gh aw compile
   

3. Коммит и отправь оба обновлённых файла.

4. Откройте pull request и проверьте GitHub Actions проверки.

Подробные рекомендации по редактированию смотрите раздел Редактирование рабочих процессов.

Повторное использование рабочих процессов

Вы также можете импортировать рабочие процессы из внешних репозиториев, к которым доступны. Например, вы можете добавить рабочий процесс из githubnext/agentics:

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 снова.

Для получения дополнительной информации см. раздел «Повторное использование рабочих процессов».

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

• Примеры рабочих процессов, продвинутые шаблоны, руководства и информацию по устранению неполадок смотрите GitHub Agentic Workflows сайт документации.