{"meta":{"title":"Использование глубоких ссылок для открытия приложения GitHub приложение Copilot","intro":"Используйте глубокие ссылки для запуска GitHub Copilot app из терминала, тикеты и внутренние инструменты, чтобы люди могли сразу перейти в нужный репозиторий, pull request, автоматизацию или сессию.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ru/enterprise-cloud@latest/copilot","title":"GitHub Copilot"},{"href":"/ru/enterprise-cloud@latest/copilot/how-tos","title":"Инструкции"},{"href":"/ru/enterprise-cloud@latest/copilot/how-tos/github-copilot-app","title":"GitHub Copilot app"},{"href":"/ru/enterprise-cloud@latest/copilot/how-tos/github-copilot-app/open-with-deep-links","title":"Открыть с глубокими ссылками"}],"documentType":"article"},"body":"# Использование глубоких ссылок для открытия приложения GitHub приложение Copilot\n\nИспользуйте глубокие ссылки для запуска GitHub Copilot app из терминала, тикеты и внутренние инструменты, чтобы люди могли сразу перейти в нужный репозиторий, pull request, автоматизацию или сессию.\n\nГлубокие ссылки помогают людям начинать работу GitHub Copilot app с меньшим количеством переключения контекста. Например, вы можете делиться запусковыми запросами, включать ссылки на приложение в файлы markdown, запускать приложение из терминальных скриптов или добавить кнопку для открытия приложения во внешних инструментах.\n\nВы можете открыть GitHub Copilot app ссылки из браузера, которые обертывают ссылку на приложение в размещённом лаунчере. Размещённый лаунчер открывает приложение, когда это возможно, и показывает страницу запасного варианта, если браузер не может передать данные приложению. Полный список ссылок на поддерживаемые приложения смотрите [раздел «Доступные ссылки на приложения](#available-app-links)».\n\n## Зачем использовать глубокие ссылки\n\nИспользуйте глубокие ссылки, когда хотите перейти с веб-страницы или рабочего процесса напрямую на конкретную страницу или задачу в приложении. Распространенные варианты использования:\n\n* Начинайте сессии с заранее заполненного стартового запроса.\n* Делитесь подсказками автоматизации, чтобы товарищи могли быстро их открывать и использовать повторно.\n* Добавьте кнопки запуска во внутренней документации или файлы markdown, чтобы открыть общие рабочие процессы.\n* Запускайте приложение из команд терминала или скриптов в рамках локальных рабочих процессов.\n* Откройте приложение через сторонние продукты, такие как Issue или Ticket Systems.\n\n## Формат URL лаунчера\n\nИспользуйте URL размещённого лаунчера с полной ссылкой приложения, закодированной в `open` параметре запроса. Размещённый лаунчер открывает приложение, когда это возможно, и показывает страницу запасного варианта, если браузер не может передать данные приложению.\n\n```text\nhttps://github.com/copilot/app/launch?open=ENCODED_APP_LINK\n```\n\nИспользуйте `encodeURIComponent`, или аналог в вашем языке программирования, чтобы закодировать полную ссылку приложения. Если ссылка приложения содержит параметры запроса, закодуйте эти значения параметров запроса перед кодированием полной ссылки приложения для `open`.\n\nНапример, чтобы открыть репозиторий, ссылка на приложение выглядит следующим образом:\n\n```text\nghapp://github.com/OWNER/REPO\n```\n\nЗакодировано в URL лаунчера, это становится:\n\n```text\nhttps://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO\n```\n\nПубличные ссылки должны использовать официальную `ghapp://` схему. Приложение также принимает `github-app://` ссылки для `gh://` совместимости, но сгенерированные и задокументированные ссылки должны использовать `ghapp://`.\n\n## Откройте репозиторий или рабочий элемент\n\nЧтобы открыть страницу в GitHub Copilot app, создать URL лаунчера по ссылке приложения на страницу, которую вы хотите открыть.\n\n* Чтобы открыть репозиторий, воспользуйтесь этой ссылкой приложения:\n\n   ```text\n   ghapp://github.com/OWNER/REPO\n   ```\n\n   Закодировано в URL лаунчера, это становится:\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO\n   ```\n\n* Чтобы открыть проблему, воспользуйтесь этой ссылкой приложения:\n\n   ```text\n   ghapp://github.com/OWNER/REPO/issues/NUMBER\n   ```\n\n   Закодировано в URL лаунчера, это становится:\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Fissues%2F123\n   ```\n\n* Чтобы открыть pull request, воспользуйтесь этой ссылкой приложения:\n\n   ```text\n   ghapp://github.com/OWNER/REPO/pull/NUMBER\n   ```\n\n   Закодировано в URL лаунчера, это становится:\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Fpull%2F123\n   ```\n\n* Чтобы возобновить задачу агента, воспользуйтесь этой ссылкой приложения:\n\n   ```text\n   ghapp://github.com/OWNER/REPO/tasks/TASK_ID\n   ```\n\n   Закодировано в URL лаунчера, это становится:\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Ftasks%2FTASK_ID\n   ```\n\n   Используйте GitHub идентификатор задачи для `TASK_ID`. Не используйте идентификатор сессии во время выполнения или URL локальной сессии приложения для ссылок, возобновляющих GitHubCopilot задачи агента.\n\n## Открытые сессии\n\nЧтобы начать новую сессию с глубокой ссылки, используйте `ghapp://session/new` параметры запроса для предварительного заполнения репозитория, ветки, pull request, prompt или режима. Для доступных параметров см. [раздел «Параметры сессии](#session-parameters)».\n\nНапример, чтобы начать новую интерактивную сессию с репозиторием и запросом на старт, используйте эту ссылку приложения:\n\n```text\nghapp://session/new?repo=OWNER%2FREPO&mode=interactive&prompt=Investigate%20failing%20tests\n```\n\nЗакодировано в URL лаунчера, это становится:\n\n```text\nhttps://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fsession%2Fnew%3Frepo%3DOWNER%252FREPO%26mode%3Dinteractive%26prompt%3DInvestigate%2520failing%2520tests\n```\n\n### Параметры сессии\n\n`ghapp://session/new` Ссылки и `ghapp://session/new/OWNER/REPO` принимают эти параметры запроса.\n\n| Parameter | Обязательный | Примечания |\n| --- | --- | --- |\n| `repo` | Требуется для `ghapp://session/new`; по желанию для `ghapp://session/new/OWNER/REPO` | Репозиторий в `OWNER/REPO` формате. |\n| `pr` | Нет | Положительный номер pull request. Не удается объединить с `branch`. |\n| `branch` | Нет | Базовая ветка для новой сессии. Не удается объединить с `pr`. |\n| `prompt` | Нет | Начало игры. Не включайте секреты или чувствительный пользовательский контент в URL. |\n| `mode` | Нет | Один из `plan`, `interactive`или `autopilot`. |\n\n## Открытые автоматизации\n\nЧтобы открыть автоматизации или создать новый черновик автоматизации по глубокой ссылке, используйте ссылки на приложения автоматизации. Для доступных параметров при создании нового черновика автоматизации см. [раздел «Параметры автоматизации](#automation-parameters)».\n\n* Чтобы открыть страницу автоматизации, воспользуйтесь этой ссылкой приложения:\n\n   ```text\n   ghapp://automations\n   ```\n\n   Закодировано в URL лаунчера, это становится:\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations\n   ```\n\n* Чтобы открыть новый черновик автоматизации, воспользуйтесь этой ссылкой приложения:\n\n   ```text\n   ghapp://automations/new?name=Daily%20triage&trigger=daily&time=09%3A00&prompt=Summarize%20new%20issues\n   ```\n\n   Закодировано в URL лаунчера, это становится:\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations%2Fnew%3Fname%3DDaily%2520triage%26trigger%3Ddaily%26time%3D09%253A00%26prompt%3DSummarize%2520new%2520issues\n   ```\n\n* Чтобы открыть существующую автоматизацию, используйте эту ссылку на приложение:\n\n   ```text\n   ghapp://automations/AUTOMATION_ID\n   ```\n\n   Закодировано в URL лаунчера, это становится:\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations%2FAUTOMATION_ID\n   ```\n\n* Чтобы открыть облачную автоматизацию, добавьте `mode=cloud` к приложению ссылку перед его кодированием:\n\n   ```text\n   ghapp://automations/AUTOMATION_ID?mode=cloud\n   ```\n\n   Закодировано в URL лаунчера, это становится:\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations%2FAUTOMATION_ID%3Fmode%3Dcloud\n   ```\n\n### Параметры автоматизации\n\nСсылка `ghapp://automations/new` открывает новый диалог автоматизации. Автоматизация создаётся только после просмотра диалога и подтверждения в приложении. Не включайте секреты или чувствительный пользовательский контент в запросы, встроенные в URL.\n\n| Parameter | Применимо к | Примечания |\n| --- | --- | --- |\n| `name` | `ghapp://automations/new` | Имя службы автоматизации. |\n| `prompt` | `ghapp://automations/new` | Подсказка автоматизации. Не включайте секреты или чувствительный пользовательский контент в URL. |\n| `trigger` | `ghapp://automations/new` | Один из `manual`, `hourly``daily`или `weekly`. Недопустимые значения игнорируются. \n`interval` также принимается как псевдоним. |\n| `time` | `ghapp://automations/new` | Время в `HH:mm` круглосуточном местном формате. Принято и `daily``weekly` триггерами. Ежедневные триггеры также принимают времена, разделённые по запятым или повторяющиеся моменты, когда все записи имеют одну и ту же минуту, например `time=08:00,13:00`. Недопустимые значения игнорируются. |\n| `day` | `ghapp://automations/new` | Еженедельный день как `0`-`6` (`0` = воскресенье) или название в будний день. Недопустимые значения игнорируются. \n`schedule_day` также принимается как псевдоним, а еженедельные триггеры принимают значения, разделённые по запятой или повторяющиеся значения, такие как `schedule_day=1,3,5`. |\n| `mode` | \n`ghapp://automations/AUTOMATION_ID` и `ghapp://automations/AUTOMATION_ID/RUN_ID`. | Применение `cloud` для облачных автоматизаций. Опустите его или используйте `local` для локальной автоматизации. |\n\n## Потоки открытых плагинов\n\nЧтобы открыть установку плагина или потоки маркетплейса по глубокой ссылке, используйте ссылки на приложение плагинов. Для доступных параметров см. [раздел «Параметры плагинов](#plugin-parameters)».\n\nНапример, чтобы открыть форму установки плагина с заранее заполненным исходным кодом, воспользуйтесь этой ссылкой приложения:\n\n```text\nghapp://plugins/install?source=my-plugin%40acme\n```\n\nЗакодировано в URL лаунчера, это становится:\n\n```text\nhttps://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fplugins%2Finstall%3Fsource%3Dmy-plugin%2540acme\n```\n\n### Параметры плагинов\n\nСсылки на подключаемые модули открывают представление **подключаемых модулей** в разделе **\"Настройка** \" с предварительно заполненной формой. Они не устанавливают плагин и не добавляют маркетплейс, пока пользователь не подтвердит это в приложении.\n\n| Link | Parameter | Обязательный | Примечания |\n| --- | --- | --- | --- |\n| `ghapp://plugins/install` | `source` | Да | Источник плагина в `PLUGIN@MARKETPLACE` формате. URL-кодировать значение, например `source=my-plugin%40acme`, . |\n| `ghapp://plugins/marketplace/add` | `source` | Да | Маркетплейс — источник в виде `OWNER/REPO` или Git-URL. URL-кодировать значение, например `source=acme%2Fplugins`, . |\n\n## Доступные ссылки на приложения\n\nСледующие ссылки на приложения могут быть упакованы в размещённый лаунчер. Строки запросов и хэши сохраняются, когда приложение открывает ссылку.\n\n| Форма ссылки приложения | Открытия | Примечания |\n| --- | --- | --- |\n| `ghapp://` | Дом | Открывает домашний маршрут приложения. |\n| `ghapp://chats` | Чаты | Открывает чаты. |\n| `ghapp://mywork` | Моя работа | Открывает проблемы и pull requests в моей работе. |\n| `ghapp://github.com/OWNER/REPO` | Настройка репозитория | Открывает или клонирует репозиторий. |\n| `ghapp://github.com/OWNER/REPO/issues/NUMBER` | Issue | Проблема возникает в разделе «Моя работа», когда репозиторий уже добавлен как проект. |\n| `ghapp://github.com/OWNER/REPO/pull/NUMBER` | Запрос на слияние | Открывает pull request в My work, когда репозиторий уже добавлен как проект. Опциональные сегменты дорожки сохраняются. |\n| `ghapp://github.com/OWNER/REPO/tasks/TASK_ID` | Задача агента | Возобновляет GitHubCopilot работу агента. Используйте GitHub ID задачи, а не локальный идентификатор сессии приложения. |\n| `ghapp://automations` | Automations | Открывает автоматизации. |\n| `ghapp://automations/new` | Новый проект автоматизации | Открывается новый диалог автоматизации с заранее заполнёнными поддерживаемыми параметрами запроса. См. [параметры автоматизации](#automation-parameters). |\n| `ghapp://automations/AUTOMATION_ID` | Automation | По умолчанию открывает локальную автоматизацию. Добавьте `?mode=cloud` для облачной автоматизации. |\n| `ghapp://automations/AUTOMATION_ID/RUN_ID` | Автоматизированный запуск | Открывает локальную автоматизацию, запущенную по умолчанию. Добавьте `?mode=cloud` для запуска облачной автоматизации. |\n| `ghapp://recent` | Недавние рабочие пространства | Открывает недавние рабочие пространства. |\n| `ghapp://sessions/SESSION_ID` | Сессия приложения | Открывает локальное рабочее пространство или сессию. Не используйте эту форму для возобновления GitHub задач агент Copilot. |\n| `ghapp://clone/OWNER/REPO` | Настройка репозитория | Показывает подтверждение до клонирования или открытия настройки репозитория. |\n| `ghapp://repo/OWNER/REPO` | Настройка репозитория | Показывает подтверждение до клонирования или открытия настройки репозитория. |\n| `ghapp://session/new` | Новый сеанс | Показывает подтверждение перед созданием сессии. Используйте параметры запроса для предоставления репозитория, пулл-запроса, ветки, запроса или режима сессии. См. [параметры сессии](#session-parameters). |\n| `ghapp://session/new/OWNER/REPO` | Новая сессия для репозитория | Показывает подтверждение перед созданием сессии для репозитория. См. [параметры сессии](#session-parameters). |\n| `ghapp://plugins/install` | Форма установки плагинов | Отображает подтверждение, а затем открывает представление **подключаемых модулей** на вкладке **\"Настройка** \" с предварительно заполненной формой установки. См. [параметры плагина](#plugin-parameters). |\n| `ghapp://plugins/marketplace/add` | Форма плагинного маркетплейса | Отображает подтверждение, а затем открывает представление **подключаемых модулей** на вкладке **\"Настройка** \" с предварительно заполненной формой Marketplace. См. [параметры плагина](#plugin-parameters). |"}