Примечание.
GitHub агентические рабочие процессы находятся и Публичный предварительный просмотр подлежат изменению.
Introduction
GitHub агентические рабочие процессы позвольте определить автоматизацию репозитория в Markdown и выбрать агент программирования ИИ, который запускает их. Расширение gh aw компилирует каждый агентический рабочий процесс в рабочий GitHub Actions процесс.
Весь жизненный цикл рабочего процесса — разработка, отладка и оптимизация — это агентная функция. Вы описываете, что требуется на естественном языке, а агент программирования создает, уточняет и устраняет неполадки рабочего процесса.
В этом руководстве используется агент кодирования для создания рецензента автоматического запроса на вытягивание, который проверяет, правильно ли тестируются изменения.
Необходимые условия
Прежде чем начать, убедитесь, что у вас есть:
- Репозиторий, где GitHub Actions включен и у вас есть доступ на запись
- GitHub CLI версия 2.0.0 или более поздней версии, установленная и проверенная
- Доступ к поддерживаемму агенту программирования, например Claude Code, OpenAI Codexили Google Близнецы CLIили Второй пилот CLI, и его требуемым учетным данным
Чтобы пройти проверку подлинности, выполните следующую GitHub CLIкоманду:
gh auth login --scopes repo,workflow
gh aw Установка расширения
GitHub агентические рабочие процессы Установите расширение дляGitHub CLI:
gh extension install github/gh-aw
Выбор агента и настройка проверки подлинности
Выберите интерфейс командной строки агента, который лучше всего подходит для рабочего процесса. Claude Code, OpenAI Codexили Google Близнецы CLI, и Второй пилот CLI все может выполняться GitHub агентические рабочие процессы.
В этой статье описывается простая настройка, которая добавляет учетные данные агента в качестве секрета репозитория. При использовании Claude Code, OpenAI Codexили Google Близнецы CLIсохраните ключ API агента в виде секрета репозитория.
| Интерфейс командной строки агента | Значение engine | Секрет репозитория |
|---|---|---|
| Код Клода | claude | |
ANTHROPIC_API_KEYсодержит ключ API Anthropic | ||
| OpenAI Codex | codex | |
OPENAI_API_KEY содержит ключ API OpenAI | ||
| Google Близнецы CLI | gemini | |
GEMINI_API_KEY содержит ключ API Google AI Studio | ||
| Второй пилот CLI (по умолчанию) | copilot | Секрет для репозиториев организации не требуется (см. ниже). Для личных репозиториев, COPILOT_GITHUB_ содержащих подробные personal access token сведения о запросах Copilot для чтения. |
Также поддерживаются другие механизмы, такие как Pi (экспериментальный). Полный список см. в справочнике по проверкеGitHub агентические рабочие процессы подлинности.
Выставление счетов за организацию GitHub Copilot
Если вы используете GitHub Copilot в репозитории, принадлежащем организации, вы можете использовать GitHub Actionsвстроенный GITHUB_TOKEN вместо него personal access token. Добавьте copilot-requests: write в интерфейс рабочий процесс и permissions не требуется отдельный секрет. Для этапов настройки см. Создание агентских рабочих процессов GitHub.
Хранение секрета в пользовательском интерфейсе GitHub
Чтобы добавить секрет для Claude Code, OpenAI Codexили Google Близнецы CLIличных репозиториев, выполните GitHub Copilot приведенные далее действия.
- В противном случае GitHubперейдите в репозиторий.
- Под именем вашего репозитория нажмите «Настройки».
- На боковой панели щелкните "Секреты" и "Переменные", а затем нажмите кнопку "Действия".
- Выберите Новый секрет репозитория.
- В поле "Имя" введите имя секрета из приведенной выше таблицы.
- В поле "Секрет" введите значение.
- Щелкните Добавить секрет.
Создание рабочего процесса
Используйте агент кодирования для создания рабочего процесса из описания естественного языка.
-
В корневом каталоге репозитория инициализируйте репозиторий для разработки агентов. Это добавляет навыки и инструкции, помогающие агенту программирования создавать и изменять рабочие процессы:
gh aw init -
Запустите сеанс агента программирования в контексте репозитория, например с помощью Claude Code, OpenAI Codexили Google Близнецы CLIВторой пилот CLIрежима агента VS Code или ,
-
Используйте навык и опишите нужный
agentic-workflowsрабочий процесс:Copilot prompt /agentic-workflows create a pr reviewer that ensure the changes are tested.
/agentic-workflows create a pr reviewer that ensure the changes are tested.Агент создает файл
.github/workflows/Markdown рабочего процесса, компилирует соответствующий.lock.ymlGitHub Actions файл рабочего процесса и запрашивает просмотр и фиксацию обоих файлов. -
Просмотрите созданный рабочий процесс, а затем попросите агента зафиксировать и отправить файлы.
Совет
Вы можете использовать тот же агентический подход для обновления и улучшения рабочего процесса после его запуска. Попросите агента уточнить критерии проверки, добавить дополнительные проверки или выполнить отладку неудачного выполнения — все на естественном языке. Если изменить интерфейс рабочего процесса позже, выполните команду gh aw compile перед фиксацией изменений.
Запуск рабочего процесса
Созданный рабочий процесс активирует автоматически при запросах на вытягивание, поэтому он запускается при следующем открытии или обновлении запроса на вытягивание в репозитории.
- Откройте запрос на вытягивание в репозитории.
- Перейдите GitHubк репозиторию и перейдите на вкладку "Действия ".
- На левой боковой панели выберите рабочий процесс, созданный агентом.
- После завершения выполнения рабочий процесс покидает запрос на вытягивание, отметив, включают ли изменения достаточно тестов.
Дальнейшие действия
- Чтобы создать рабочий процесс, создающий еженедельный отчет о действиях, см. раздел Создание агентских рабочих процессов GitHub.
- Дополнительные сведения о конфигурации ядра, безопасных выходных данных и других примерах рабочих процессов см. на GitHub агентические рабочие процессы сайте документации.