{"meta":{"title":"Las primeras instrucciones personalizadas","intro":"Crea y prueba tu primera instrucción personalizada con este sencillo ejemplo.","product":"GitHub Copilot","breadcrumbs":[{"href":"/es/copilot","title":"GitHub Copilot"},{"href":"/es/copilot/tutorials","title":"Tutoriales"},{"href":"/es/copilot/tutorials/customization-library","title":"Biblioteca de personalización"},{"href":"/es/copilot/tutorials/customization-library/custom-instructions","title":"Instrucciones personalizadas"},{"href":"/es/copilot/tutorials/customization-library/custom-instructions/your-first-custom-instructions","title":"Las primeras instrucciones personalizadas"}],"documentType":"article"},"body":"# Las primeras instrucciones personalizadas\n\nCrea y prueba tu primera instrucción personalizada con este sencillo ejemplo.\n\n> \\[!NOTE]\n>\n> * 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.\n> * 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).\n> * 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/response-customization)».\n\n## Acerca de las personalizaciones\n\nPuedes personalizar las respuestas de GitHub Copilot mediante dos tipos de archivos:\n\n* ```\n            Las **Instrucciones personalizadas** proporcionan instrucciones continuas sobre cómo debe comportarse GitHub Copilot en todas las interacciones.\n  ```\n* ```\n            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).\n  ```\n\nAunque 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.\n\nLas 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 en GitHub. Puedes crear instrucciones personalizadas del repositorio de dos maneras:\n\n* **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.\n* **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 **Chat de Copiloto** en Visual Studio Code, Visual Studio y **agente en la nube de Copilot**.\n\n## Las primeras instrucciones\n\nComienza con estas instrucciones personalizadas básicas que ayudan a GitHub Copilot a comprender tus preferencias de programación.\n\n### Instrucciones para escribir funciones\n\n```markdown copy\nWhen writing functions, always:\n- Add descriptive JSDoc comments\n- Include input validation\n- Use early returns for error conditions\n- Add meaningful variable names\n- Include at least one example usage in comments\n```\n\nEstas instrucciones cambiarán la forma en que GitHub Copilot genera funciones.\n\n## Prueba\n\nPara probar rápidamente la diferencia que pueden hacer las instrucciones personalizadas, puede usar instrucciones personalizadas personales en Chat de Copiloto.\n\n1. 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:\n\n   `Create a JavaScript function that calculates the area of a circle`\n\n   ```\n          **Sin instrucciones personalizadas**, podría obtener lo siguiente:\n   ```\n\n   ```javascript\n   function areaOfCircle(radius) {\n       if (typeof radius !== 'number' || radius < 0) {\n           throw new Error('Radius must be a non-negative number');\n       }\n       return Math.PI * radius * radius;\n   }\n   ```\n\n2. 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**.\n\n   Ahora, escribe el mismo mensaje anterior.\n\n   ```\n          **Con instrucciones personalizadas**, obtendrá algo parecido a lo siguiente:\n   ```\n\n   ```javascript\n   /**\n    * Calculates the area of a circle given its radius.\n    * * @param {number} radius - The radius of the circle. Must be a positive number.\n    * @returns {number|null} The area of the circle, or null if the input is invalid.\n    * * @example\n    * // returns 78.53981633974483\n    * areaOfCircle(5);\n    * * @example\n    * // returns null (invalid input)\n    * areaOfCircle(-2);\n    */\n   function areaOfCircle(radius) {\n     if (typeof radius !== \"number\" || isNaN(radius) || radius <= 0) {\n       // Invalid input: radius must be a positive number\n       return null;\n     }\n\n     const area = Math.PI * Math.pow(radius, 2);\n     return area;\n   }\n\n   // Example usage:\n   console.log(areaOfCircle(5));   // 78.53981633974483\n   console.log(areaOfCircle(-2));  // null\n   ```\n\n## Información adicional\n\n* [Acerca de la personalización de las respuestas de GitHub Copilot](/es/copilot/concepts/response-customization): Introducción a la personalización de respuestas en GitHub Copilot\n* [Adición de instrucciones personalizadas para Copilot](/es/copilot/how-tos/configure-custom-instructions): Configuración de instrucciones personalizadas\n* [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"}