# Las primeras instrucciones personalizadas

Crea y prueba tu primera instrucción personalizada con este sencillo ejemplo.

> \[!NOTE]
>
> * Los ejemplos de esta biblioteca están pensados para inspirarte: te recomendamos que los ajustes para que sean más específicos para tus proyectos, lenguajes y procesos de equipo.
> * Para obtener ejemplos aportados por la comunidad de instrucciones personalizadas para lenguajes y escenarios específicos, consulta el repositorio [Awesome GitHub Copilot Customizations](https://github.com/github/awesome-copilot/blob/main/docs/README.instructions.md).
> * Puedes aplicar instrucciones personalizadas en distintos ámbitos, en función de la plataforma o IDE donde las crees. Para obtener más información, vea «[Acerca de la personalización de las respuestas de GitHub Copilot](/es/copilot/concepts/prompting/response-customization)».

## Acerca de las personalizaciones

Puedes personalizar las respuestas de GitHub Copilot mediante dos tipos de archivos:

* ```
            Las **Instrucciones personalizadas** proporcionan instrucciones continuas sobre cómo debe comportarse GitHub Copilot en todas las interacciones.
  ```
* ```
            Los **archivos de mensaje (versión preliminar pública)** definen mensajes reutilizables para tareas específicas que puede invocar cuando sea necesario. Los archivos de comandos solo están disponibles en VS Code, Visual Studio y en IDEs de JetBrains. Para obtener un ejemplo introductorio, consulte [AUTOTITLE](/copilot/tutorials/customization-library/prompt-files/your-first-prompt-file).
  ```

Aunque las instrucciones personalizadas ayudan a agregar contexto a cada flujo de trabajo de IA, los archivos de mensaje te permiten agregar instrucciones a una interacción de chat específica.

Las instrucciones personalizadas de repositorio son las más usadas y admitidas, pero también puedes definir instrucciones personalizadas personales y de la organización, solo para GitHub Copilot Chat in GitHub. Puedes crear instrucciones personalizadas del repositorio de dos maneras:

* **Instrucciones para todo el repositorio**: crea un único archivo`copilot-instructions.md` en la raíz del repositorio que se aplique a todos los archivos del repositorio.
* **Instrucciones específicas de la ruta de acceso**: crea uno o varios archivos `.instructions.md` con un campo `applyTo` que solo se apliquen a archivos o directorios específicos. Actualmente se admiten instrucciones específicas de la ruta para **Copilot Chat** en Visual Studio Code, Visual Studio y **Copilot cloud agent**.

## Las primeras instrucciones

Comienza con estas instrucciones personalizadas básicas que ayudan a GitHub Copilot a comprender tus preferencias de programación.

### Instrucciones para escribir funciones

```markdown copy
When writing functions, always:
- Add descriptive JSDoc comments
- Include input validation
- Use early returns for error conditions
- Add meaningful variable names
- Include at least one example usage in comments
```

Estas instrucciones cambiarán la forma en que GitHub Copilot genera funciones.

## Prueba

Para probar rápidamente la diferencia que pueden hacer las instrucciones personalizadas, puede usar instrucciones personalizadas personales en Copilot Chat.

1. En primer lugar, vaya a [github.com/copilot](https://github.com/copilot?ref_product=copilot\&ref_type=trial\&ref_style=text) y escriba este mensaje:

   `Create a JavaScript function that calculates the area of a circle`

**Sin instrucciones personalizadas**, podría obtener lo siguiente:

````
```javascript
function areaOfCircle(radius) {
    if (typeof radius !== 'number' || radius < 0) {
        throw new Error('Radius must be a non-negative number');
    }
    return Math.PI * radius * radius;
}
```
````

1. Ahora accede a tus instrucciones personalizadas haciendo clic en tu imagen de perfil en la esquina inferior izquierda de la página, luego haz clic en **Instrucciones personales**. Pega las instrucciones anteriores en el cuadro de texto y, después, haz clic en **Save**.

   Ahora, escribe el mismo mensaje anterior.

**Con instrucciones personalizadas**, obtendrá algo parecido a lo siguiente:

````
```javascript
/**
 * Calculates the area of a circle given its radius.
 * * @param {number} radius - The radius of the circle. Must be a positive number.
 * @returns {number|null} The area of the circle, or null if the input is invalid.
 * * @example
 * // returns 78.53981633974483
 * areaOfCircle(5);
 * * @example
 * // returns null (invalid input)
 * areaOfCircle(-2);
 */
function areaOfCircle(radius) {
  if (typeof radius !== "number" || isNaN(radius) || radius <= 0) {
    // Invalid input: radius must be a positive number
    return null;
  }

  const area = Math.PI * Math.pow(radius, 2);
  return area;
}

// Example usage:
console.log(areaOfCircle(5));   // 78.53981633974483
console.log(areaOfCircle(-2));  // null
```
````

## Información adicional

* [Acerca de la personalización de las respuestas de GitHub Copilot](/es/copilot/concepts/prompting/response-customization): Introducción a la personalización de respuestas en GitHub Copilot
* [Adición de instrucciones personalizadas para Copilot](/es/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions): Configuración de instrucciones personalizadas
* [Awesome GitHub Copilot Customizations](https://github.com/github/awesome-copilot/blob/main/README.md): repositorio de instrucciones personalizadas aportadas por la comunidad y otras personalizaciones para lenguajes y escenarios específicos