Los enlaces profundos ayudan a las personas a empezar a trabajar en el aplicación Copilot de GitHub 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 el aplicación Copilot de GitHub desde enlaces del navegador que contienen un enlace de la aplicación en el iniciador alojado. 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.
¿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.
- Abre la aplicación desde productos de terceros, como sistemas de incidencias o tickets.
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.
https://github.com/copilot/app/launch?open=ENCODED_APP_LINK
Use encodeURIComponento 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:
ghapp://github.com/OWNER/REPO
Codificado en la dirección URL del iniciador, que se convierte en:
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 aplicación Copilot de GitHub, 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:
ghapp://github.com/OWNER/REPOCodificado en la dirección URL del iniciador, que se convierte en:
https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO -
Para abrir una incidencia, utilice este enlace de la aplicación:
ghapp://github.com/OWNER/REPO/issues/NUMBERCodificado en la dirección URL del iniciador, que se convierte en:
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:
ghapp://github.com/OWNER/REPO/pull/NUMBERCodificado en la dirección URL del iniciador, que se convierte en:
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:
ghapp://github.com/OWNER/REPO/tasks/TASK_IDCodificado en la dirección URL del iniciador, que se convierte en:
https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Ftasks%2FTASK_IDUtilice 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, el aviso o el modo. Para ver los parámetros disponibles, consulte Parámetros de sesión.
Por ejemplo, para iniciar una nueva sesión interactiva con un repositorio y un mensaje de inicio, use este vínculo de aplicación:
ghapp://session/new?repo=OWNER%2FREPO&mode=interactive&prompt=Investigate%20failing%20tests
Codificado en la dirección URL del iniciador, que se convierte en:
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:/; opcional para ghapp:/ | Repositorio en OWNER/REPO formato. |
pr | No | Número de pull request 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 deplan, 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.
-
Para abrir la página Automatizaciones, use este vínculo de aplicación:
ghapp://automationsCodificado en la dirección URL del iniciador, que se convierte en:
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:
ghapp://automations/new?name=Daily%20triage&trigger=daily&time=09%3A00&prompt=Summarize%20new%20issuesCodificado en la dirección URL del iniciador, que se convierte en:
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:
ghapp://automations/AUTOMATION_IDCodificado en la dirección URL del iniciador, que se convierte en:
https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations%2FAUTOMATION_ID -
Para abrir una automatización en la nube, agregue
mode=cloudal vínculo de la aplicación antes de codificarlo:ghapp://automations/AUTOMATION_ID?mode=cloudCodificado en la dirección URL del iniciador, que se convierte en:
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:/ | Nombre de automatización. |
prompt | ghapp:/ | Aviso de automatización. No incluya secretos ni contenido confidencial del usuario en direcciones URL. |
trigger | ghapp:/ | Uno de manual, hourly, dailyo weekly. Se omiten los valores no válidos. |
interval también se acepta como alias. | ||
time | ghapp:/ | 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:/ | 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:/ y ghapp:/ | 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.
Por ejemplo, para abrir el formulario de instalación del complemento con un origen rellenado previamente, use este vínculo de aplicación:
ghapp://plugins/install?source=my-plugin%40acme
Codificado en la dirección URL del iniciador, que se convierte en:
https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fplugins%2Finstall%3Fsource%3Dmy-plugin%2540acme
Parámetros del complemento
Los enlaces de plugins abren Configuración > Plugins con un formulario ya rellenado. No instalan un complemento ni agregan un marketplace hasta que el usuario confirme en la aplicación.
| Link | Parámetro | Obligatorio | Notas |
|---|---|---|---|
ghapp:/ | 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:/ | 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 | Aperturas | 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:/ | Configuración del repositorio | Abre o clona el repositorio. |
ghapp:/ | Issue | Abre el problema en Mi trabajo cuando el repositorio ya se agrega como un proyecto. |
ghapp:/ | Solicitud de incorporación de cambios | Abre la solicitud de extracción en Mi trabajo cuando el repositorio ya se ha agregado como proyecto. Se conservan los segmentos de ruta final opcionales. |
ghapp:/ | Tarea del agente | Reanuda una GitHubCopilot tarea del agente. Usa el ID de tarea GitHub, no un ID de sesión local de la aplicación. |
ghapp:/ | Automations | Abre Automatizaciones. |
ghapp:/ | 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. |
ghapp:/ | Automation | Abre una automatización local de forma predeterminada. Agregue ?mode=cloud para una automatización en la nube. |
ghapp:/ | 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:/ | 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:/ | Configuración del repositorio | Muestra una confirmación antes de clonar o abrir la configuración del repositorio. |
ghapp:/ | Configuración del repositorio | Muestra una confirmación antes de clonar o abrir la configuración del repositorio. |
ghapp:/ | 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. |
ghapp:/ | 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. |
ghapp:/ | Formulario de instalación del complemento | Muestra una confirmación y, a continuación, abre Configuración > Complementos con el formulario de instalación rellenado previamente. Consulte Parámetros del complemento. |
ghapp:/ | Formulario de Marketplace del complemento | Muestra una confirmación y, a continuación, abre Configuración > Complementos con el formulario de Marketplace rellenado previamente. Consulte Parámetros del complemento. |