Интеграция облачного агента Copilot с Jira

Вы можете использовать GitHub интеграцию в Jira для предоставления контекста и открытых pull request, всё это из вашего рабочего пространства Jira.

Кто может использовать эту функцию?

Доступно для всех платныхCopilot планов.

В этой статье

Примечание.

GitHub Copilot использует искусственный интеллект. Проверьте наличие ошибок. См . раздел AUTOTITLE.

GitHub Copilot Интеграция в Jira позволяет вызыватьCopilot облачный агент, не выходя из рабочего пространства Jira. Внутри Jira вы можете инициировать Облачный агент сессии и открывать pull requests, используя контекст названия, описания, меток, комментариев и любых пользовательских полей Atlassian, таких как критерии приёма.

Необходимые условия

  • У вас должен быть GitHub аккаунт с доступом Copilot через платный Copilot план.
  • У вас должен быть аккаунт Jira Cloud, приложение Jira с поддержкой ИИ, а Rovo должен быть активирован для вашей организации. См. раздел «Активировать ИИ» для приложений в документации Atlassian.
  • Установка и аутентификация должны быть завершены как для Jira, так и GitHubдля .

Installation

Чтобы установить GitHub Copilot приложение for Jira и авторизовать его для вашей GitHub организации или корпоративного аккаунта, вам нужно:

  • Разрешение администратора для вашего сайта Jira.
  • Права владельца или GitHub менеджера приложения для вашей GitHub организации.

Эта интеграция основана на приложении Atlassian Forge и приложении GitHub . Оба варианта необходимы для интеграции. После успешной установки авторизованные пользователи рабочего пространства Jira с доступом к записиGitHub в репозиторий смогут активировать агент из Jira.

Установка GitHub Copilot приложения для Jira GitHub.com

  1. Перейдите на страницуGitHub Copilot установки Jira на Atlassian Marketplace.

  2. Нажмите кнопку "Получить сейчас".

  3. Выберите сайт Atlassian, на который хотите установить приложение GitHub .

  4. Нажмите «Просмотр», чтобы проверить детали установки, а затем «Получить сейчас».

    После GitHub Copilot установки For Jira на вашем сайте Jira необходимо авторизировать приложение для доступа к вашей GitHub организации и репозиториям.

  5. Нажмите «Наладить » в подтверждении в Jira после установки.

  6. Если вы ещё не вошли в GitHubаккаунт , нажмите выделенный пункт «Войти GitHub » и следуйте инструкциям, чтобы войти в свой GitHub аккаунт и авторизировать приложение.

    • Если ваша организация или предприятие использует единый вход (SSO), возможно, потребуется запустить активную сессию SAML для вашей организации и выполнить дополнительный этап авторизации.

  7. Нажмите «Установить приложение», чтобы дать приложению разрешение на доступ к информации в вашем аккаунте GitHub.

  8. Выберите организацию и репозитории, к которым приложение имеет доступ. Ваши GitHub организации по умолчанию включены для рабочего пространства Jira. По желанию, на странице «Установка GitHub Copilot для Jira » снять организацию и репозитории , к которым вы не хотите получать доступ приложению.

  9. Нажмите кнопку "Установить".

  10. После завершения установки вы увидите список подключённых организаций на GitHub Copilot странице конфигурации приложения Jira в Jira.

Установка GitHub Copilot приложения для Jira GHE.com

  1. Перейдите на GitHub Copilot страницу установки для Jira (GHEC с Data Residency) на Atlassian Marketplace.

  2. Справа от названия приложения нажмите , и введите U SUBDOMAIN.ghe.com в текстовое поле. Замените SUBDOMAIN на поддомен GHE.comвашего предприятия .

  3. Нажмите Сохранить конфигурацию.

  4. Нажмите кнопку "Получить сейчас".

  5. Выберите сайт Atlassian, на который хотите установить приложение GitHub .

  6. Нажмите «Просмотр», чтобы проверить детали установки, а затем «Получить сейчас».

    После GitHub Copilot установки For Jira на вашем сайте Jira необходимо авторизировать приложение для доступа к вашей GitHub организации и репозиториям.

  7. Нажмите «Наладить » в подтверждении в Jira после установки.

    • Если вас не перенаправляют автоматически, найдите GitHub Copilot приложение для Jira в списке приложений, доступных для вашего предприятия, по адресу SUBDOMAIN.ghe.com/apps/external-app/github-copilot-for-jira. Нажмите кнопку "Установить".

  8. Если вы ещё не вошли в GitHubаккаунт , нажмите выделенный пункт «Войти GitHub » и следуйте инструкциям, чтобы войти в свой GitHub аккаунт и авторизировать приложение.

    • Если ваша организация или предприятие использует SSO, возможно, вам потребуется запустить активную сессию SAML для вашей организации и выполнить дополнительный этап авторизации.

  9. Нажмите «Установить приложение», чтобы дать приложению разрешение на доступ к информации в вашем аккаунте GitHub.

  10. Выберите организацию и репозитории, к которым приложение имеет доступ. Ваши GitHub организации по умолчанию включены для рабочего пространства Jira. По желанию, на странице «Установка GitHub Copilot для Jira » снять организацию и репозитории , к которым вы не хотите получать доступ приложению.

  11. Нажмите кнопку "Установить".

  12. После завершения установки вы увидите список подключённых организаций на GitHub Copilot странице конфигурации приложения Jira в Jira.

Использование GitHub Copilot приложения в Jira

Приложение должно быть активировано для Copilot ор��анизации, GitHub членом которой вы являетесь, прежде чем вы сможете начать им пользоваться.

При первом использовании Copilot облачный агент в Jira вам нужно будет подключить его к своему GitHub аккаунту.

Только пользователи с доступом к записи в репозиторий могут запускать Copilot облачный агент работу в этом репозитории.

Вы можете спровоцировать Copilot облачный агент это несколькими способами:

  • НазначитьGitHub Copilot в рабочее задание с помощью поля Assignee.
  • Упоминание@GitHub Copilot в комментарии к рабочему пункту.
  • Используйте автоматизацию Jira. В ваших правилах автоматизации Jira выберите действие «Использовать GitHub Copilot » и настройте свой поток так, чтобы использовать пользовательский триггер на основе событий Jira, например, когда рабочий элемент создан или переключён или наложен метка. Для получения дополнительной информации см. раздел «Работа с агентами ИИ в Jira » в документации Atlassian.

Примечание.

Когда вы назначаете Copilot объект работы Jira, контекст, который агент захватывает из Jira, добавляется в pull request и будет виден всем , если репозиторий открыт.

Пример: Триггер Copilot облачный агент из рабочего предмета Jira

  1. В Jira откройте или создайте рабочий элемент с чёткими требованиями, которые вы хотите делегировать.Copilot облачный агент

  2. Чтобы указать репозиторий, в котором хотите Copilot работать, укажите его в описании рабочего элемента или в комментарии.

  3. Назначайте GitHub Copilot задачу к работе или упомяните @GitHub Copilot в комментариях. Рассмотрим пример.

    @GitHub Copilot create a new API endpoint for user authentication in octo-org/octorepo

  4. Если вы ранее не подключали приложение GitHub в Jira к своему GitHub аккаунту, следуйте инструкциям для авторизации приложения как GitHub для Atlassian, так и для Atlassian.

  5. После Copilot облачный агент начала работы с pull request, комментарий появится в чате в Jira. Пользователь, инициировавший сессию агента, может наблюдать за прогрессом там.

  6. Далее вы можете предоставить дополнительные инструкции по Copilotследующим вопросам:

    • Используйте кнопку «Продолжить в чате » под разделом «Агенты » для прямого чат Copilot , чтобы получить обновления текущего pull request.
    • Упомяните @GitHub Copilot в комментариях к рабочему пункту о внесении обновлений в новом pull requeste.

Совет

Если вы не получили подтверждения срабатывания Copilot облачный агент через 1 минуту, обновите страницу рабочего элемента Jira.

Активность наблюдательного агента в Jira

Во время Облачный агент работы активность транслируется в чат в Jira, так что вы можете отслеживать действия агента, не оставляя рабочего объекта. Поток активности включает ссылку на соответствующую сессию агента на GitHub.

Режиссура Copilot из Jira после сессии

После Copilot облачный агент завершения сессии, например, когда pull-запрос готов к рассмотрению, вы можете направить Copilot продолжать работу:

  • В панели чата в Jira выберите ссылку на связанную сессию агента на GitHub. Это открывает панель агентов на GitHub, где можно просмотреть сессию и отправить последующие инструкции для обновления существующего pull-запроса.
  • Добавьте уточнение @GitHub Copilot или комментарий к рабочему пункту Jira. Это запускает новую сессию и открывает новый pull-запрос вместо обновления существующего.

Кастомизация Copilot облачный агент в Jira

Вы можете настроить работу Copilot облачный агент в вашем рабочем пространстве Jira, указывая модели, агенты и пользовательские инструкции.

Спецификация модели

Указывайте модель, когда вы хотите, чтобы задача выполнялась на конкретной модели, а не на стандартной. Например, вы можете выбрать более лёгкую модель для рутинных, чётко продуманных изменений. Чтобы изменить модель, используемую для Copilot облачный агент конкретной задачи, включите название модели в инструкции на Copilot, см. Изменение модели ИИ для облачного агента GitHub Copilot.

Определение пользовательского агента

Укажите пользовательский агент, чтобы адаптировать Облачный агентповедение его под конкретный рабочий процесс или репозиторий. Вы можете указать пользовательского агента из вашего GitHub репозитория прямо в заявке Jira. Дополнительные сведения см. в разделе Создание кастомных агентов для Copilot облачный агент.

Использование пользовательских инструкций

Используйте пользовательские инструкции для установки стандартных параметров, применимых к каждой сессии, например, целевому репозиторию, чтобы Copilot не пришлось ставить на паузу и запрашивать ввод во время сессии. Вы можете задать пользовательские инструкции на уровне рабочего пространства Jira, которые применяются каждый раз при Copilot облачный агент срабатывании.

Затраты на использование

Copilot облачный агент использует GitHub Actions минуты и AI credits.

Дополнительные сведения см. в разделе Выставление счетов на основе использования для организаций и предприятий.

Добавление или удаление организации в GitHub Copilot приложение для Jira

Администратор Jira и GitHub владелец организации могут включать или отключать организации для интеграции.

Примечание.

Если после первоначальной установки в приложение добавляется новая организация, защищённая SSO, пользователям нужно будет запустить активную сессию SAML для организации в GitHub, чтобы Copilot облачный агент запустить работу в репозиториях новой организации из Jira. Дополнительные сведения см. в разделе Сведения о проверке подлинности с помощью единого входа.

Чтобы изменить доступ к GitHub Copilot приложению for Jira для организации:

  1. В Jira перейдите на страницу настроек вашего рабочего пространства.
  2. Перейдите на страницу GitHub Copilot настроек приложений.
  3. По желанию нажмите «Соединить больше GitHub организаций », чтобы добавить новые организации в список.
  4. Включите или отключите Copilot приложение для одной или нескольких из перечисленных организаций.

Troubleshooting

Если возникнут проблемы, попробуйте следующие решения.

Вы не видите, Copilot облачный агент и нельзя назначить его на рабочий элемент Jira

В Jira проверьте настройки управления Atlassian для вашей организации, которые настроены следующим образом.

  1. Jira — это приложение с поддержкой ИИ, см. раздел «Активировать ИИ» для приложений в документации Atlassian.

Вы можете увидеть, Copilot облачный агент но нельзя назначить его к рабочему элементу Jira

Проверьте, что ваш личный аккаунт GitHub подключён к GitHub Copilot приложению For Jira.

  1. В Jira перейдите на страницу настроек вашего личного аккаунта.
  2. В общих настройках выберите GitHub Copilot приложение для Jira .
  3. Если вы ещё не вошли в GitHubсистему, следуйте инструкциям для входа и авторизации заявки.

При общении с GitHub Copilot, вам предлагается войти в систему

Чтобы войти GitHub Copilot в приложение Jira, выполните шаги выше в разделе. Вы видите, Copilot облачный агент но нельзя назначить её к рабочему элементу Jira.

Другие пользователи в вашем рабочем пространстве могут назначать Copilot облачный агент задачу Jira, но вы не можете

Если Copilot облачный агент вы не можете увидеть или работать с ресурсами вашей организации в Jira, а ваша организация использует SSO в GitHub, возможно, вам потребуется повторно авторизировать GitHub Copilot приложение для Jira для вашего GitHub аккаунта. Дополнительные сведения см. в разделе Сведения о проверке подлинности с помощью единого входа.

Чтобы решить эту проблему, следуйте следующим шагам, чтобы начать новую активную сессию SSO для вашей организации:

  1. Перейдите в настройки вашей организации в GitHub.
  2. В разделе «Единый вход» найдите организацию, в которую нужно пройти аутентификацию, нажмите Выйти и затем войти.
    • Если ваше предприятие управляет единым входом для вашей организации, вход в одну организацию на предприятии работает как сеанс единого входа для всех организаций на предприятии.
  3. Вернитесь к Jira и обновите страницу, на которой работаете.
  4. Попробуйте снова работать Copilot облачный агент с Jira.

GitHub Copilot не отвечает

  • Проверьте GitHubстраницу «Статус» на предмет активных инцидентов.
  • Проверьте страницу статуса Atlassian на предмет активных инцидентов.
  • Проверьте, что Copilot облачный агент у него есть доступ к репозиторию, проверив, можно ли назначить Copilot проблему на GitHub.
  • Проверьте, что GitHub Copilot приложение for Jira имеет доступ к репозиторию. См . раздел AUTOTITLE.

Дополнительные материалы