{"meta":{"title":"О GitHub Agentic Workflows","intro":"Автоматизация работы с повторяющимися репозиториями с инструкциями на естественном языке, выполняемых агентами кодирования ИИ в GitHub Actions.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ru/copilot","title":"GitHub Copilot"},{"href":"/ru/copilot/concepts","title":"Основные понятия"},{"href":"/ru/copilot/concepts/agents","title":"Агенты"},{"href":"/ru/copilot/concepts/agents/about-github-agentic-workflows","title":"Агентные рабочие процессы"}],"documentType":"article"},"body":"# О GitHub Agentic Workflows\n\nАвтоматизация работы с повторяющимися репозиториями с инструкциями на естественном языке, выполняемых агентами кодирования ИИ в GitHub Actions.\n\n> \\[!NOTE]\n> GitHub агентические рабочие процессы are in Публичный предварительный просмотр and subject to change.\n\n## Около Агентные рабочие процессы\n\nGitHub агентические рабочие процессы это автоматизации репозиториев на базе ИИ, которые вы определяете в markdown и запускаете как GitHub Actions рабочие процессы. В отличие от традиционной автоматизации с фиксированными правилами if-then, Агентные рабочие процессы используйте программисты для понимания контекста, принятия решений и выполнения значимых действий — всё это на основе инструкций на естественном языке.\n\nНа практике, по сравнению с традиционными рабочими процессами, выполняющими заранее определённые шаги:\n\n* Рабочие процессы агента Выполняйте инструкции на естественном языке с помощью контекстного рассуждения.\n* Вы всё равно определяете ограничения в фронтматтере, такие как триггеры, разрешения и безопасные выходы.\n\nС Агентные рабочие процессыпомощью , вы можете автоматизировать такие задачи, как:\n\n* Сортировка поступающих вопросов и маркировка их по типу и приоритету\n* Расследование сбоев CI и предложения исправлений\n* Генерация ежедневных или еженедельных отчётов о состоянии репозитория\n* Обновление документации с учётом изменений в коде\n* Улучшение покрытия испытаний\n\n## Преимущества использования Агентные рабочие процессы\n\n* **Automate repetitive repository work**. Определите сортировку вопросов, расследование CI, обновление документации и отчётность на естественном языке.\n* **Снизить сложность рабочих процессов**. Пишите инструкции markdown вместо того, чтобы строить сложные процедурные скрипты для каждого сценария.\n* **Держите в курсе человеческих отзывов**.\n  Рабочие процессы агента может генерировать готовые к рассмотрению результаты, такие как проблемы, комментарии и pull requests, а вы управляете одобрением и слияниями.\n* **Запускайте агентов с многоуровневой безопасностью**. Агенты работают в фаерволочных контейнерах с токенами только для чтения по умолчанию. Действия записи ограничены объявленными «безопасными выходами», которые вы определили и проверяются агентным обнаружением угроз.\n\n## Требования\n\nЧтобы создать и использовать Агентные рабочие процессы, вам нужно:\n\n* GitHub Actions включено для вашего репозитория.\n* Аккаунт с ИИ-движком (агентом), таким как GitHub Copilot, Anthropic Claude, OpenAI Codexили Google Gemini.\n* GitHub CLI Установлен и аутентифицирован\n\n## Как Агентные рабочие процессы работать\n\nКаждый файл разметки рабочего процесса состоит из двух частей:\n\n* **Frontmatter** (YAML между `---` маркерами): Настраивает время запуска рабочего процесса, какие права он имеет и какие операции записи разрешены.\n* **Тело Markdown**: содержит инструкции на естественном языке, которым следует агент ИИ.\n\nВ целом процесс создания и использования Агентные рабочие процессы таков:\n\n1. Определите файл агентного рабочего `.md` процесса, включая инструкции YAML frontmatter и markdown.\n2. Скомпилируйте файл рабочего процесса markdown в защищённый `.lock.yml`GitHub Actions файл рабочего процесса.\n3. Зафиксируйте и отправьте оба файла в стандартную ветку вашего репозитория.\n4. Запускайте рабочий процесс как любой GitHub Actions другой — на триггере или в GitHub веб-интерфейсе вашего репозитория. Вы также можете запускать его из GitHub CLI.\n\nВот пример рабочего процесса для создания ежедневной проблемы с статусом репозитория:\n\n```markdown\n---\non: daily\n\npermissions:\n  contents: read\n  issues: read\n  pull-requests: read\n  copilot-requests: write\n\nnetwork: defaults\n\ntools:\n  github:\n    toolsets: [default]\n\nsafe-outputs:\n  create-issue:\n\n---\n\n# Daily Repo Status Report\n\nReview recent activity in the repository, including issues, pull requests, discussions, and code changes.\n\nCreate a GitHub issue summarizing what changed in the last 24 hours (merged pull requests, closed issues, and new discussions), any blockers or open questions mentioned in comments, progress toward visible goals, and recommended next steps for maintainers.\n\nKeep the summary concise. Adjust the level of detail based on how much activity occurred.\n```\n\nДля подробных шагов по созданию и обновлению Агентные рабочие процессысм. [Создание агентских рабочих процессов GitHub](/ru/copilot/how-tos/github-agentic-workflows/creating-github-agentic-workflows).\n\n## Поддерживаемые кодирующие агенты\n\nGitHub агентические рабочие процессы Поддержка нескольких программных агентов, включая:\n\n* GitHub Copilot (нужен план GitHub Copilot )\n* Anthropic Claude\n* OpenAI Codex\n* Google Gemini\n\nВы указываете, какой агент использовать в свойстве `engine`фронтматера рабочего процесса . Каждый движок требует собственного секрета аутентификации, настроенного в вашем репозитории.\nGitHub Copilot является движком по умолчанию, если его не указано.\n\nДля получения дополнительной информации смотрите [ссылку на двигатель](https://github.github.com/gh-aw/reference/engines/).\n\n## Ограничительные меры безопасности\n\nGitHub агентические рабочие процессы разработаны с приоритетом безопасности:\n\n* **По умолчанию только для чтения**: Рабочие процессы имеют права репозитория только для чтения, если только вы явно не предоставите больше.\n* **Безопасные выходы**: Операции записи (такие как создание проблем, добавление комментариев или открытие pull request) разрешены только через проверенное `safe-outputs` объявление в фронтматтере.\n* **Секреты остаются вне времени выполнения агента**: Чувствительные учетные данные хранятся в изолированных заданиях на следующей линии, а не напрямую доступны агенту.\n* **Обнаружение угроз**: Предлагаемые выходы сканируются на предмет подозрительных или опасных изменений перед применением действий записи.\n* **Использование с файрволом**: агенты работают в изолированных GitHub Actions средах.\n* **Доступ на основе роли**: вы можете ограничить, кто может запускать или изменять Агентные рабочие процессы , с помощью ролевых систем контроля доступа.\n\nДля полного прохождения по архитектуре смотрите [документацию по безопасности](https://github.github.com/gh-aw/introduction/architecture/).\n\n## Использование и выставление счетов\n\nОбщая стоимость Агентные рабочие процессы состоит из двух частей:\n\n* GitHub Actions минуты, занимаемые рабочими процессами.\n* Стоимость вывода зависит от настроенного движка ИИ.\n\nДля вывода GitHub агентические рабочие процессы используйте AI Credits (AIC) как общий критерий мониторинга и бюджетирования между движками.\n`1 AIC = $0.01 USD`.\n\nТо, как применяется выставление счетов, зависит от двигателя:\n\n* Движок по умолчанию GitHub Copilot : использование AIC отображается на AI credits в GitHub Copilot биллинге.\n* Сторонний движок: Инференция оплачивается этим провайдером.\n\nВы можете использовать GitHub CLI его для просмотра использования и предполагаемой стоимости для Агентные рабочие процессы. Используйте `gh aw logs` их для просмотра последних рабочих процессов, включая продолжительность, использование токена и оценки AIC по разным запускам. Используйте `gh aw audit RUN-ID` более детальный анализ одного запуска, включая использование токена и предполагаемую стоимость вывода. Значения AIC — это лучшие оценки, и они могут не совпадать с счетами поставщика, поэтому проверьте окончательные расходы в панели оплаты вашего провайдера.\n\nВы также можете настроить `max-ai-credits` фронтматтер рабочего процесса, чтобы ограничивать использование вывода для одного запуска. По умолчанию лимит — 1 000 AIC за пробег.\n\nДля обзора выставления GitHub агентические рабочие процессы счетов и рекомендаций по оптимизации затрат см. [раздел «Управление затратами](https://github.github.com/gh-aw/reference/cost-management/) » на GitHub агентические рабочие процессы сайте документации.\n\n### Возможность организации выставления счетов для GitHub агентические рабочие процессы\n\nДля GitHub Copilot агентных рабочих процессов в репозиториях, принадлежащих организации, если у организации есть план GitHub Copilot , мы настоятельно рекомендуем использовать GitHub Actionsвстроенный `GITHUB_TOKEN`' . Этот подход расходуется на компанию и избегает использования personal access token.\n\nЧтобы выставить счет организации, вам нужно:\n\n1. Администратор организации для включения «Copilot CLI» и «Разрешить использование Copilot CLI, выставленного организацией» в настройках политики GitHub Copilot. Если «Copilot CLI» уже включён, то по умолчанию активна политика выставления счетов.\n2. В каждом фронтматтере рабочего процесса включите `copilot-requests: write` под объект `permissions` .\n\nКогда `copilot-requests: write` установлен в разрешениях фронтматера рабочего процесса, токен GitHub Actions' используется для Copilot запросов, так что `COPILOT_GITHUB_TOKEN` не нужен. Если токен GitHub Actions не имеет доступа GitHub Copilot от организации, рабочий процесс сбивает при отправке Copilot запросов, и следует настроить `COPILOT_GITHUB_TOKEN`.\n\nПодробные инструкции по настройке см. [раздел «Использование встроенного `GITHUB_TOKEN`](/ru/copilot/how-tos/github-agentic-workflows/creating-github-agentic-workflows#using-the-built-in-github_token).\n\n## Дальнейшие действия\n\n* Чтобы добавить свой первый агентский рабочий процесс, смотрите [Ваш первый агентский рабочий процесс](/ru/copilot/how-tos/github-agentic-workflows/quickstart).\n* Для получения дополнительной информации о создании и использовании Агентные рабочие процессысм. [Создание агентских рабочих процессов GitHub](/ru/copilot/how-tos/github-agentic-workflows/creating-github-agentic-workflows).\n* Полная справочная документация, включая продвинутые шаблоны и примеры, смотрите [GitHub агентические рабочие процессы сайт с документированием](https://github.github.com/gh-aw/)."}