{"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/prompting/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 in 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 **Copilot Chat** en Visual Studio Code, Visual Studio y **Copilot cloud agent**.\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 Copilot Chat.\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**Sin instrucciones personalizadas**, podría obtener lo siguiente:\n\n````\n```javascript\nfunction 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````\n\n1. 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**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 */\nfunction 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:\nconsole.log(areaOfCircle(5));   // 78.53981633974483\nconsole.log(areaOfCircle(-2));  // null\n```\n````\n\n## Información adicional\n\n* [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\n* [Adición de instrucciones personalizadas para Copilot](/es/copilot/how-tos/copilot-on-github/customize-copilot/add-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"}