# Artefactos con problemas

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

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 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-plus" aria-label="Add artifact" role="img"><path d="M7.75 2a.75.75 0 0 1 .75.75V7h4.25a.75.75 0 0 1 0 1.5H8.5v4.25a.75.75 0 0 1-1.5 0V8.5H2.75a.75.75 0 0 1 0-1.5H7V2.75A.75.75 0 0 1 7.75 2Z"></path></svg>.
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 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-link" aria-label="the link" role="img"><path d="m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z"></path></svg>.

## Editar un artefacto

1. Abra el artefacto.
2. En el panel de artefactos, haga clic en <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-pencil" aria-label="Edit artifact" role="img"><path d="M11.013 1.427a1.75 1.75 0 0 1 2.474 0l1.086 1.086a1.75 1.75 0 0 1 0 2.474l-8.61 8.61c-.21.21-.47.364-.756.445l-3.251.93a.75.75 0 0 1-.927-.928l.929-3.25c.081-.286.235-.547.445-.758l8.61-8.61Zm.176 4.823L9.75 4.81l-6.286 6.287a.253.253 0 0 0-.064.108l-.558 1.953 1.953-.558a.253.253 0 0 0 .108-.064Zm1.238-3.763a.25.25 0 0 0-.354 0L10.811 3.75l1.439 1.44 1.263-1.263a.25.25 0 0 0 0-.354Z"></path></svg>.
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 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-history" aria-label="Edit history" role="img"><path d="m.427 1.927 1.215 1.215a8.002 8.002 0 1 1-1.6 5.685.75.75 0 1 1 1.493-.154 6.5 6.5 0 1 0 1.18-4.458l1.358 1.358A.25.25 0 0 1 3.896 6H.25A.25.25 0 0 1 0 5.75V2.104a.25.25 0 0 1 .427-.177ZM7.75 4a.75.75 0 0 1 .75.75v2.992l2.028.812a.75.75 0 0 1-.557 1.392l-2.5-1A.751.751 0 0 1 7 8.25v-3.5A.75.75 0 0 1 7.75 4Z"></path></svg>.
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 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="Artifact actions" 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> junto a un artefacto, hacer clic en **Mover** y elegir una posición.

## Borrar un artefacto

> [!WARNING]
> 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 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="Artifact actions" 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> 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](https://cli.github.com/manual/gh_issue_artifact).

## Lectura adicional

* "[Endpoints de API REST para artefactos de incidencias](/es/rest/issues/artifacts)" en la documentación de las API REST
* [Acerca de los problemas](/es/issues/tracking-your-work-with-issues/learning-about-issues/about-issues)