> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub

> Gestiona repositorios, issues, pull requests y ejecuciones de workflows de GitHub mediante tu cuenta conectada.

# GitHub

Usa GitHub cuando tu workflow necesite acciones de repositorio, issue, pull request o ejecución de workflow. Encaja con pasos que crean, actualizan, encuentran o revisan trabajo de colaboración de código.

## Configuración

| Opción | Requerido | Descripción |
| - | - | - |
| Nombre | No | Etiqueta para el paso en el lienzo del workflow. |
| Autenticación | Sí | La cuenta conectada de GitHub que se usará para este paso. |
| Acción | Sí | La acción de GitHub que se va a realizar (por ejemplo Create issue, Get pull request, List pull requests, Create pull request). |
| Argumentos | Sí | Campos de formulario por acción generados a partir del esquema de la acción. Cada campo de texto tiene un botón **Insert Variable** para insertar valores `{{placeholder}}`. Hay una pestaña **Raw JSON** disponible para uso avanzado. |
| Cuando el paso falle | No | Controla si el workflow debe **Terminate Workflow** o **Continue** si este paso falla. |

Antes de configurar este paso, conecta GitHub en **Integrations** para tu espacio de trabajo usando el flujo de inicio de sesión. Si no hay una conexión activa disponible, el paso muestra una advertencia con un enlace a **Integrations** en lugar del selector de cuenta.

## Formulario de argumentos

Cuando seleccionas una acción, la sección **Arguments** muestra un formulario impulsado por el esquema de entrada de la acción.

Cambia a la pestaña **Raw JSON** cuando prefieras escribir a mano el objeto completo de argumentos. Los cambios en cualquiera de las dos pestañas se mantienen sincronizados.

## Acciones comunes

| Acción | Descripción |
| - | - |
| **Create issue** | Crea un nuevo issue en un repositorio. |
| **Get pull request** | Recupera un pull request específico por número. |
| **List pull requests** | Lista los pull requests de un repositorio. |
| **Create pull request** | Crea un pull request de una rama a otra. |
| **Request reviewers** | Solicita revisores para un pull request. |
| **Mark pull request ready** | Marca un pull request borrador como listo para revisión. |
| **Check pull request merged** | Comprueba si se ha fusionado un pull request. |
| **List repository issues** | Lista issues y pull requests en un repositorio. |
| **Get issue comments** | Recupera los comentarios de un issue o pull request. |
| **Create issue comment** | Crea un comentario en un issue o pull request. |
| **Add assignees** | Añade uno o más asignados a un issue. |
| **Add labels** | Añade etiquetas a un issue y crea las etiquetas que faltan. |
| **Close issue** | Cierra un issue abierto. |
| **Reopen issue** | Reabre un issue cerrado. |
| **List workflows** | Lista workflows de GitHub Actions en un repositorio. |

Las acciones destructivas, como eliminar registros, no están disponibles en el selector de acciones del workflow.

## Resultado

Este paso almacena la respuesta de GitHub como la salida del paso. La forma de la respuesta depende de la acción.

Usa la referencia de salida completa en pasos posteriores:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Ejemplo

1. Abre **Integrations** y conecta GitHub si todavía no lo has hecho.
2. Añade un paso **GitHub** a tu workflow.
3. Selecciona una cuenta conectada en **Authentication**.
4. Elige **Create issue** en **Action**.
5. Completa los campos obligatorios. Usa **Insert Variable** para referenciar la salida de un paso anterior en cualquier valor de campo.
6. Haz clic en **Run** en el encabezado del paso para probar la acción y luego revisa la carga devuelta en **Output**.

## Casos de uso

### Clasificar un nuevo informe de error

1. Create issue
2. Add labels
3. Add assignees

### Revisar un pull request

1. Get pull request
2. Request reviewers
3. Mark pull request ready

### Cerrar trabajo resuelto

1. List repository issues
2. Close issue
3. Create issue comment

## Notas

* Este paso depende de una integración conectada de GitHub en tu espacio de trabajo.
* El selector de acciones del workflow muestra un conjunto curado de acciones. Los agentes con la herramienta de GitHub pueden usar más de ellas.
* La pantalla de inicio de sesión puede mostrar una marca de autorización de terceros.

## Usar GitHub como herramienta de agente

También puedes añadir GitHub como herramienta en el **Agent Editor**. Abre el agente, haz clic en **Add tool** y selecciona **GitHub**. En el panel de configuración de la herramienta, elige la cuenta conectada que el agente debe usar. El agente llama a acciones de GitHub cuando son relevantes para la conversación.

Consulta también: [Integrations](https://docs.fetchhive.com/es/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/es/workflows/creating-and-editing.md) y [Testing and Iteration](https://docs.fetchhive.com/es/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.