Artefactos con problemas

Mantenga planes, investigación, vínculos y HTML interactivo junto con la incidencia que respaldan.

¿Quién puede utilizar esta característica?

Issue artifacts are available on GitHub.com and GitHub Enterprise Cloud.

En este artículo

Esta característica está en versión preliminar pública y está sujeta a cambios.

Los artefactos de incidencia son fragmentos de contenido con nombre adjuntos a una incidencia. Proporcionan un lugar duradero para mantener planes, investigación, decisiones, prototipos y material de referencia como contexto junto con su trabajo.

Puede compartir artefactos con otros usuarios a través de una dirección URL y, si actualiza un artefacto, GitHub mantendrá un registro de los cambios para que pueda volver atrás y ver cómo ha evolucionado un artefacto a lo largo de un proyecto.

Tipos de artefacto admitidos

Los artefactos de incidencias admiten los siguientes tipos:

  • Documento markdown (generic): contenido de uso general, como investigación, notas de investigación o un documento de diseño.
  • Plan (plan): un plan de implementación de Markdown.
  • Vínculo (link): un vínculo con nombre al contenido en otro lugar, como una discusión, un prototipo o un subproceso de Slack o Teams.
  • Archivo HTML (embedded_html): un documento HTML autocontenida, como un prototipo interactivo, una visualización, un diagrama de flujo o un diagrama.

Crear un artefacto

Puede crear artefactos en GitHub.com, o pedir a un agente o a una herramienta de desarrollador que cree uno mediante el servidor MCP integrado GitHub, GitHub CLI o la API REST de artefactos de incidencias. Por ejemplo, puede pedirle a Copilot app que cree un plan de implementación, un análisis de causa principal o un resumen de investigación y adjuntarlo al problema.

Creación de un artefacto en GitHub.com

  1. Vaya a la incidencia en la que desea crear un artefacto.
  2. En la sección Artefactos , haga clic en .
  3. Seleccione un tipo de artefacto:
    • Para agregar una dirección URL con nombre, haga clic en Agregar vínculo.
    • Para crear un documento de Markdown, haga clic en Create artifact.
    • Para crear un documento HTML, haga clic en Crear artefacto HTML.
  4. Siga las indicaciones para asignar un nombre y crear el artefacto.

Visualización y uso compartido de un artefacto

  1. Vaya a la incidencia que contiene el artefacto.
  2. En la sección Artefactos , haga clic en el nombre del artefacto.
  3. El artefacto se abrirá y se mostrará en un panel lateral de la incidencia.
  4. Para copiar la dirección URL para compartir el artefacto con otros usuarios, haga clic en .

Editar un artefacto

  1. Abra el artefacto.
  2. En el panel de artefactos, haga clic en .
  3. Actualice el nombre del artefacto o su contenido.
  4. Guarde los cambios.

La edición de un artefacto crea una versión en su historial.

Visualización del historial de versiones de un artefacto

  1. Abra el artefacto de compilación.
  2. En el panel de artefactos, haga clic en .
  3. Seleccione una versión para ver su nombre, contenido, autor y hora de creación.

No se puede restaurar una versión en la interfaz web. Para restaurar una versión anterior, use gh issue artifact edit --restore-version. La restauración guarda el nombre y el contenido anteriores como una nueva versión, conservando el historial completo.

Reordenación de artefactos

Puede reordenar artefactos arrastrándolos dentro de la sección Artefactos . También puede hacer clic junto a un artefacto, hacer clic en Mover y elegir una posición.

Borrar un artefacto

Advertencia

La eliminación de un artefacto es permanente y también elimina su historial de versiones.

  1. En la sección Artefactos de la incidencia, haga clic junto al artefacto.
  2. Haga clic en Eliminar.

Vista previa segura de un artefacto HTML

En GitHub.com, los artefactos HTML se abren en la vista Código fuente para poder inspeccionar el código antes de ejecutarlo. Para visualizar el HTML, seleccione Vista previa. GitHub muestra la vista previa en un espacio aislado restringido. La interfaz advierte que la vista previa ejecuta código proporcionado por el usuario que puede enviar su contenido a sitios externos. Revise la fuente y solo obtenga una vista previa del CÓDIGO HTML de fuentes en las que confía. Para volver a la fuente, seleccione Fuente.

Uso de artefactos con agentes

Cuando se usa Copilot app para trabajar en una incidencia, los artefactos creados durante la sesión se adjuntan automáticamente a la incidencia. También puede pedirle a Copilot que cree un artefacto específico, como un plan de implementación, un análisis de la causa principal o un resumen del contexto histórico.

Los agentes y las herramientas de desarrollo también pueden usar el servidor MCP integrado GitHub , la API REST o GitHub CLI para leer y administrar artefactos.

Administración de artefactos con GitHub CLI

Los comandos de artefactos de incidencias requieren GitHub CLI 2.103.0 o posterior.

Para obtener más información sobre los comandos de artefactos de incidencias, consulte la gh issue artifact referencia.

Lectura adicional