# Uso de vínculos profundos para abrir el aplicación Copilot de GitHub

Use vínculos profundos para abrir GitHub Copilot app desde el terminal, las incidencias y las herramientas internas, de modo que los usuarios puedan acceder directamente al repositorio, la solicitud de incorporación de cambios, la automatización o la sesión adecuados.

Los enlaces profundos ayudan a las personas a empezar a trabajar en el GitHub Copilot app con menos cambios de contexto. Por ejemplo, puede compartir mensajes de inicio de sesión, incluir vínculos a la aplicación en archivos markdown, iniciar la aplicación desde scripts de terminal o agregar un botón para abrir la aplicación en herramientas externas.

Puede abrir GitHub Copilot app desde vínculos del navegador que contienen un vínculo de la aplicación en el iniciador hospedado. El lanzador alojado abre la aplicación cuando es posible y muestra una página alternativa si el navegador no puede redirigir al usuario a la aplicación. Para obtener una lista completa de los vínculos de aplicaciones compatibles, consulte [Vínculos de aplicaciones disponibles](#available-app-links).

## ¿Por qué usar vínculos profundos?

Use vínculos profundos cuando desee moverse de una página web o flujo de trabajo directamente a una página o tarea específica de la aplicación. Entre los casos de uso comunes se incluyen:

* Inicie las sesiones con un aviso de inicio rellenado previamente.
* Comparta mensajes de automatización para que los compañeros de equipo puedan abrirlos y reutilizarlos rápidamente.
* Agregue botones de inicio en documentos internos o archivos markdown para abrir flujos de trabajo comunes.
* Inicie la aplicación desde comandos o scripts de terminal como parte de los flujos de trabajo locales.
* Abra la aplicación desde productos de terceros, como sistemas de incidencias o problemas.

## Formato de dirección URL del iniciador

Use la dirección URL del iniciador hospedado con el vínculo de aplicación completo codificado en el `open` parámetro de consulta. El lanzador alojado abre la aplicación cuando es posible y muestra una página alternativa si el navegador no puede redirigir al usuario a la aplicación.

```text
https://github.com/copilot/app/launch?open=ENCODED_APP_LINK
```

Use `encodeURIComponent`o el equivalente en el lenguaje de programación para codificar el vínculo de la aplicación completa. Si el vínculo de la aplicación incluye parámetros de consulta, codifique esos valores de parámetro de consulta antes de codificar el vínculo de aplicación completo para `open`.

Por ejemplo, para abrir un repositorio, el vínculo de la aplicación es:

```text
ghapp://github.com/OWNER/REPO
```

Codificado en la dirección URL del iniciador, que se convierte en:

```text
https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO
```

Los enlaces públicos deben utilizar el esquema oficial `ghapp://` . La aplicación también acepta enlaces `github-app://` y `gh://` por compatibilidad, pero los enlaces generados y documentados deben usar `ghapp://`.

## Abrir un repositorio o un elemento de trabajo

Para abrir una página en GitHub Copilot app, compile una dirección URL del iniciador mediante el vínculo de la aplicación para la página que desea abrir.

* Para abrir un repositorio, use este vínculo de aplicación:

   ```text
   ghapp://github.com/OWNER/REPO
   ```

   Codificado en la dirección URL del iniciador, que se convierte en:

   ```text
   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO
   ```

* Para abrir una incidencia, utilice este vínculo de la aplicación:

   ```text
   ghapp://github.com/OWNER/REPO/issues/NUMBER
   ```

   Codificado en la dirección URL del iniciador, que se convierte en:

   ```text
   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Fissues%2F123
   ```

* Para abrir una solicitud de incorporación de cambios, use este vínculo de aplicación:

   ```text
   ghapp://github.com/OWNER/REPO/pull/NUMBER
   ```

   Codificado en la dirección URL del iniciador, que se convierte en:

   ```text
   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Fpull%2F123
   ```

* Para reanudar una tarea de agente, use este vínculo de aplicación:

   ```text
   ghapp://github.com/OWNER/REPO/tasks/TASK_ID
   ```

   Codificado en la dirección URL del iniciador, que se convierte en:

   ```text
   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Ftasks%2FTASK_ID
   ```

   Utilice el identificador de tarea de GitHub para `TASK_ID`. No use un identificador de sesión en tiempo de ejecución ni una dirección URL de sesión local de la aplicación para vínculos que reanuden GitHubCopilot las tareas del agente.

## Sesiones abiertas

Para iniciar una nueva sesión desde un vínculo profundo, use `ghapp://session/new` con parámetros de consulta para rellenar previamente el repositorio, la rama, la solicitud de incorporación de cambios, la solicitud o el modo. Para ver los parámetros disponibles, consulte [Parámetros de sesión](#session-parameters).

Por ejemplo, para iniciar una nueva sesión interactiva con un repositorio y un mensaje de inicio, use este vínculo de aplicación:

```text
ghapp://session/new?repo=OWNER%2FREPO&mode=interactive&prompt=Investigate%20failing%20tests
```

Codificado en la dirección URL del iniciador, que se convierte en:

```text
https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fsession%2Fnew%3Frepo%3DOWNER%252FREPO%26mode%3Dinteractive%26prompt%3DInvestigate%2520failing%2520tests
```

### Parámetros de sesión

Los enlaces `ghapp://session/new` y `ghapp://session/new/OWNER/REPO` aceptan estos parámetros de consulta.

| Parámetro | Obligatorio | Notas |
| --- | --- | --- |
| `repo` | Obligatorio para `ghapp://session/new`; opcional para `ghapp://session/new/OWNER/REPO` | Repositorio en `OWNER/REPO` formato. |
| `pr` | No | Número de solicitud de incorporación de cambios positivo. No se puede combinar con `branch`. |
| `branch` | No | Rama base para la nueva sesión. No se puede combinar con `pr`. |
| `prompt` | No | Aviso de inicio. No incluya secretos ni contenido confidencial del usuario en direcciones URL. |
| `mode` | No | Uno de`plan`, `interactive` o `autopilot`. |

## Automatizaciones abiertas

Para abrir automatizaciones o crear un nuevo borrador de automatización a partir de un enlace profundo, use los enlaces de la aplicación de automatización. Para ver los parámetros disponibles al crear un borrador de automatización, consulte [Parámetros de automatización](#automation-parameters).

* Para abrir la página Automatizaciones, use este vínculo de aplicación:

   ```text
   ghapp://automations
   ```

   Codificado en la dirección URL del iniciador, que se convierte en:

   ```text
   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations
   ```

* Para abrir un nuevo borrador de automatización, use este vínculo de aplicación:

   ```text
   ghapp://automations/new?name=Daily%20triage&trigger=daily&time=09%3A00&prompt=Summarize%20new%20issues
   ```

   Codificado en la dirección URL del iniciador, que se convierte en:

   ```text
   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations%2Fnew%3Fname%3DDaily%2520triage%26trigger%3Ddaily%26time%3D09%253A00%26prompt%3DSummarize%2520new%2520issues
   ```

* Para abrir una automatización existente, use este vínculo de aplicación:

   ```text
   ghapp://automations/AUTOMATION_ID
   ```

   Codificado en la dirección URL del iniciador, que se convierte en:

   ```text
   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations%2FAUTOMATION_ID
   ```

* Para abrir una automatización en la nube, agregue `mode=cloud` al vínculo de la aplicación antes de codificarlo:

   ```text
   ghapp://automations/AUTOMATION_ID?mode=cloud
   ```

   Codificado en la dirección URL del iniciador, que se convierte en:

   ```text
   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations%2FAUTOMATION_ID%3Fmode%3Dcloud
   ```

### Parámetros de Automatización

El `ghapp://automations/new` vínculo abre el cuadro de diálogo de automatización nuevo. No crea la automatización hasta que el usuario revisa el cuadro de diálogo y confirma en la aplicación. No incluya secretos ni contenido confidencial del usuario en mensajes insertados en direcciones URL.

| Parámetro | Se aplica a | Notas |
| --- | --- | --- |
| `name` | `ghapp://automations/new` | Nombre de automatización. |
| `prompt` | `ghapp://automations/new` | Aviso de automatización. No incluya secretos ni contenido confidencial del usuario en direcciones URL. |
| `trigger` | `ghapp://automations/new` | Uno de `manual`, `hourly`, `daily`o `weekly`. Se omiten los valores no válidos. 
`interval` también se acepta como alias. |
| `time` | `ghapp://automations/new` | Hora en `HH:mm` formato local de 24 horas. Aceptado para los desencadenadores `daily` y `weekly`. Los desencadenadores diarios también aceptan tiempos repetidos o separados por comas cuando todas las entradas comparten el mismo minuto, por ejemplo `time=08:00,13:00`. Se omiten los valores no válidos. |
| `day` | `ghapp://automations/new` | Día semanal como `0`-`6` (`0` = domingo) o un nombre de día de la semana. Se omiten los valores no válidos. 
`schedule_day` también se acepta como alias y los desencadenadores semanales aceptan valores separados por comas o repetidos, como `schedule_day=1,3,5`. |
| `mode` | 
`ghapp://automations/AUTOMATION_ID` y `ghapp://automations/AUTOMATION_ID/RUN_ID` | Se usa `cloud` para las automatizaciones en la nube. Omita o use `local` para las automatizaciones locales. |

## Flujos de plugin abiertos

Para abrir la instalación del complemento o los flujos de Marketplace desde un vínculo profundo, use los vínculos de la aplicación de complementos. Para ver los parámetros disponibles, consulte [Parámetros del complemento](#plugin-parameters).

Por ejemplo, para abrir el formulario de instalación del complemento con un origen rellenado previamente, use este vínculo de aplicación:

```text
ghapp://plugins/install?source=my-plugin%40acme
```

Codificado en la dirección URL del iniciador, que se convierte en:

```text
https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fplugins%2Finstall%3Fsource%3Dmy-plugin%2540acme
```

### Parámetros del complemento

Los vínculos del complemento abren la vista **Complementos** en **Personalizar** con un formulario rellenado previamente. No instalan un complemento ni agregan un marketplace hasta que el usuario confirme en la aplicación.

| Link | Parámetro | Obligatorio | Notas |
| --- | --- | --- | --- |
| `ghapp://plugins/install` | `source` | Sí | Código fuente del complemento en formato `PLUGIN@MARKETPLACE`. Codifique la dirección URL del valor, por ejemplo `source=my-plugin%40acme`. |
| `ghapp://plugins/marketplace/add` | `source` | Sí | Origen de Marketplace como `OWNER/REPO` o una dirección URL de Git. Codifique la dirección URL del valor, por ejemplo `source=acme%2Fplugins`. |

## Vínculos de aplicaciones disponibles

Los siguientes vínculos de aplicación se pueden encapsular en el iniciador hospedado. Las cadenas de consulta y los hash se conservan cuando la aplicación abre el vínculo.

| Forma de vínculo de aplicación | Mensajes abiertos | Notas |
| --- | --- | --- |
| `ghapp://` | Hogar | Abre la ruta principal de la aplicación. |
| `ghapp://chats` | Chats | Abre chats. |
| `ghapp://mywork` | Mi trabajo | Abre problemas y solicitudes de incorporación de cambios en Mi trabajo. |
| `ghapp://github.com/OWNER/REPO` | Configuración del repositorio | Abre o clona el repositorio. |
| `ghapp://github.com/OWNER/REPO/issues/NUMBER` | Issue | Abre el problema en Mi trabajo cuando el repositorio ya se ha agregado como un proyecto. |
| `ghapp://github.com/OWNER/REPO/pull/NUMBER` | Solicitud de incorporación de cambios | Abre la solicitud de incorporación de cambios en Mi trabajo cuando el repositorio ya se ha agregado como un proyecto. Se conservan los segmentos de ruta final opcionales. |
| `ghapp://github.com/OWNER/REPO/tasks/TASK_ID` | Tarea del agente | Reanuda una tarea del agente GitHubCopilot. Usa el ID de tarea GitHub, no un ID de sesión local de la aplicación. |
| `ghapp://automations` | Automations | Abre Automatizaciones. |
| `ghapp://automations/new` | Nuevo borrador de automatización | Abre el nuevo cuadro de diálogo de automatización con parámetros de consulta admitidos rellenados previamente. Consulte [Parámetros de Automation](#automation-parameters). |
| `ghapp://automations/AUTOMATION_ID` | Automation | Abre una automatización local de forma predeterminada. Agregue `?mode=cloud` para una automatización en la nube. |
| `ghapp://automations/AUTOMATION_ID/RUN_ID` | Ejecución de automatización | Abre una ejecución de automatización local de forma predeterminada. Agregue `?mode=cloud` para una ejecución de automatización en la nube. |
| `ghapp://recent` | Áreas de trabajo recientes | Abre áreas de trabajo recientes. |
| `ghapp://sessions/SESSION_ID` | Sesión de la aplicación | Abre un área de trabajo o sesión local de la aplicación. No utilice esta forma para reanudar las tareas del agente de Copilot GitHub. |
| `ghapp://clone/OWNER/REPO` | Configuración del repositorio | Muestra una confirmación antes de clonar o abrir la configuración del repositorio. |
| `ghapp://repo/OWNER/REPO` | Configuración del repositorio | Muestra una confirmación antes de clonar o abrir la configuración del repositorio. |
| `ghapp://session/new` | Nueva sesión | Muestra una confirmación antes de crear una sesión. Usa parámetros de consulta para especificar el repositorio, la solicitud de extracción, la rama, la instrucción o el modo de sesión. Consulte [Parámetros de sesión](#session-parameters). |
| `ghapp://session/new/OWNER/REPO` | Nueva sesión para un repositorio | Muestra una confirmación antes de crear una sesión para el repositorio. Consulte [Parámetros de sesión](#session-parameters). |
| `ghapp://plugins/install` | Formulario de instalación del complemento | Muestra una confirmación y, a continuación, abre la vista **Complementos** en la pestaña **Personalizar** con el formulario de instalación rellenado previamente. Consulte [Parámetros del complemento](#plugin-parameters). |
| `ghapp://plugins/marketplace/add` | Formulario de Marketplace del complemento | Muestra una confirmación y, a continuación, abre la vista **Complementos** en la pestaña **Personalizar** con el formulario de Marketplace rellenado previamente. Consulte [Parámetros del complemento](#plugin-parameters). |