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

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

> \[!NOTE]
> GitHub Copilot использует искусственный интеллект. Проверьте наличие ошибок. См [. раздел AUTOTITLE](/ru/enterprise-cloud@latest/copilot/responsible-use/agents).

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

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

* У вас должен быть GitHub аккаунт с доступом Copilot через платный Copilot план.
* У вас должен быть аккаунт Jira Cloud, **приложение Jira с поддержкой ИИ**, а Rovo должен быть активирован для вашей организации. См. [раздел «Активировать ИИ» для приложений](https://support.atlassian.com/organization-administration/docs/activate-atlassian-intelligence-for-products) в документации 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](https://marketplace.atlassian.com/apps/1582455624?ref_product=copilot\&ref_type=engagement\&ref_style=text) на Atlassian Marketplace.

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

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

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

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

5. Нажмите **«Наладить** » в подтверждении в Jira после установки.
   * Если вас не перенаправляют автоматически, перейдите на [страницуGitHub Copilot установки Jira](https://github.com/apps/github-copilot-for-jira?ref_product=copilot\&ref_type=engagement\&ref_style=text) на GitHub Marketplace. Нажмите кнопку **"Установить**".

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)](https://marketplace.atlassian.com/apps/3637796809?ref_product=copilot\&ref_type=engagement\&ref_style=text) на Atlassian Marketplace.

2. Справа от названия приложения нажмите <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="Configure" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg>, и введите 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 cloud agent в Jira вам нужно будет подключить его к своему GitHub аккаунту.

Только пользователи с **доступом к записи** в репозиторий могут запускать Copilot cloud agent работу в этом репозитории.

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

* **Назначить**GitHub Copilot в рабочее задание с помощью поля Assignee.
* **Упоминание**`@GitHub Copilot` в комментарии к рабочему пункту.
* **Используйте автоматизацию Jira.** В ваших правилах автоматизации Jira выберите действие **«Использовать GitHub Copilot** » и настройте свой поток так, чтобы использовать пользовательский триггер на основе событий Jira, например, когда рабочий элемент создан или переключён или наложен метка. Для получения дополнительной информации см. [раздел «Работа с агентами ИИ в Jira](https://support.atlassian.com/jira-software-cloud/docs/work-with-ai-agents-in-jira/) » в документации Atlassian.

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

### Пример: Триггер Copilot cloud agent из рабочего предмета Jira

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

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

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

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

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

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

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

> \[!TIP]
> Если вы не получили подтверждения срабатывания Copilot cloud agent через 1 минуту, обновите страницу рабочего элемента Jira.

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

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

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

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

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

## Кастомизация Copilot cloud agent в Jira

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

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

Указывайте модель, когда вы хотите, чтобы задача выполнялась на конкретной модели, а не на стандартной. Например, вы можете выбрать более лёгкую модель для рутинных, чётко продуманных изменений. Чтобы изменить модель, используемую для Copilot cloud agent конкретной задачи, включите название модели в инструкции на Copilot, см. [Изменение модели ИИ для облачного агента GitHub Copilot](/ru/enterprise-cloud@latest/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model).

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

Укажите пользовательский агент, чтобы адаптировать cloud agentповедение его под конкретный рабочий процесс или репозиторий. Вы можете указать пользовательского агента из вашего GitHub репозитория прямо в заявке Jira. Дополнительные сведения см. в разделе [Создание кастомных агентов для Copilot cloud agent](/ru/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents).

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

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

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

Copilot cloud agent использует GitHub Actions минуты и AI credits.

Дополнительные сведения см. в разделе [Выставление счетов на основе использования для организаций и предприятий](/ru/enterprise-cloud@latest/copilot/concepts/billing/usage-based-billing-for-organizations-and-enterprises).

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

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

> \[!NOTE]
> Если после первоначальной установки в приложение добавляется новая организация, защищённая SSO, пользователям нужно будет запустить активную сессию SAML для организации в GitHub, чтобы Copilot cloud agent запустить работу в репозиториях новой организации из Jira. Дополнительные сведения см. в разделе [Сведения о проверке подлинности с помощью единого входа](/ru/enterprise-cloud@latest/authentication/authenticating-with-single-sign-on/about-authentication-with-single-sign-on#about-oauth-apps-github-apps-and-sso).

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

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

## Troubleshooting

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

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

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

1. Jira — это приложение с поддержкой ИИ, см. [раздел «Активировать ИИ» для приложений](https://support.atlassian.com/organization-administration/docs/activate-atlassian-intelligence-for-products) в документации Atlassian.

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

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

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

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

Чтобы войти GitHub Copilot в приложение Jira, выполните шаги выше в разделе. [Вы видите, Copilot cloud agent но нельзя назначить её к рабочему элементу Jira](#you-can-see-the-copilot-cloud-agent-but-it-is-not-possible-to-assign-it-to-a-jira-work-item).

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

Если Copilot cloud agent вы не можете увидеть или работать с ресурсами вашей организации в Jira, а ваша организация использует SSO в GitHub, возможно, вам потребуется повторно авторизировать GitHub Copilot приложение для Jira для вашего GitHub аккаунта. Дополнительные сведения см. в разделе [Сведения о проверке подлинности с помощью единого входа](/ru/enterprise-cloud@latest/authentication/authenticating-with-single-sign-on/about-authentication-with-single-sign-on#about-oauth-apps-github-apps-and-sso).

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

1. Перейдите в [настройки вашей организации](https://github.com/settings/organizations) в GitHub.
2. В разделе «Единый вход» найдите организацию, в которую нужно пройти аутентификацию, нажмите **Выйти** и затем **войти**.
   * Если ваше предприятие управляет единым входом для вашей организации, вход в одну организацию на предприятии работает как сеанс единого входа для всех организаций на предприятии.
3. Вернитесь к Jira и обновите страницу, на которой работаете.
4. Попробуйте снова работать Copilot cloud agent с Jira.

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

* Проверьте GitHub[страницу «Статус](https://githubstatus.com)» на предмет активных инцидентов.
* Проверьте [страницу статуса Atlassian](https://status.atlassian.com) на предмет активных инцидентов.
* Проверьте, что Copilot cloud agent у него есть доступ к репозиторию, проверив, можно ли назначить Copilot проблему на GitHub.
* Проверьте, что GitHub Copilot приложение for Jira имеет доступ к репозиторию. См [. раздел AUTOTITLE](/ru/enterprise-cloud@latest/apps/using-github-apps/reviewing-and-modifying-installed-github-apps).

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

* [О облачном агенте GitHub Copilot](/ru/enterprise-cloud@latest/copilot/concepts/agents/cloud-agent/about-cloud-agent)
* [Управление доступом к облачному агенту GitHub Copilot](/ru/enterprise-cloud@latest/copilot/concepts/agents/cloud-agent/access-management)
* [Настройте MCP-серверы для вашего репозитория](/ru/enterprise-cloud@latest/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers#example-atlassian)
* [Сотрудничайте над рабочими задачами с агентами ИИ](https://support.atlassian.com/jira-software-cloud/docs/collaborate-on-work-items-with-ai-agents/) в документации Atlassian