{"meta":{"title":"Creación y uso de agentes personalizados para GitHub Copilot CLI","intro":"Cree agentes especializados con experiencia personalizada para tareas de desarrollo específicas.","product":"GitHub Copilot","breadcrumbs":[{"href":"/es/copilot","title":"GitHub Copilot"},{"href":"/es/copilot/how-tos","title":"Procedimientos"},{"href":"/es/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/es/copilot/how-tos/copilot-cli/customize-copilot","title":"Personalización de la CLI de Copilot"},{"href":"/es/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli","title":"Creación de agentes personalizados"}],"documentType":"article"},"body":"# Creación y uso de agentes personalizados para GitHub Copilot CLI\n\nCree agentes especializados con experiencia personalizada para tareas de desarrollo específicas.\n\n## Introducción\n\nCustom agents le permiten adaptar la experiencia de Copilot a tareas específicas.\n\nCuando se le solicita a Copilot que realice una tarea, puede optar por usar uno de tus custom agents, si Copilot determina que la pericia del agente es adecuada para la tarea.\n\nEl trabajo realizado por un custom agent se lleva a cabo mediante un subagente, que es un agente temporal que se activa para completar la tarea. El subagent tiene su propia ventana de contexto, que se puede rellenar mediante información que no es relevante para el agente principal. Así, especialmente para tareas más grandes, partes del trabajo se pueden delegar en custom agents, sin sobrecargar la ventana de contexto del agente principal. Después, el agente principal puede centrarse en la planificación y coordinación de nivel superior.\n\nPara más información, consulta [Acerca de los agentes personalizados](/es/copilot/concepts/agents/copilot-cli/about-custom-agents).\n\n## Crear un custom agent\n\nCada custom agent se define mediante un archivo Markdown con extensiones `.agent.md`. Puede crear estos archivos usted mismo o agregarlos desde la CLI, como se describe en los pasos siguientes.\n\n1. En modo interactivo, escriba `/agent`.\n\n2. Seleccione **Crear nuevo agente** en la lista de opciones.\n\n3. Elija entre las opciones para crear el custom agent en el repositorio o en su directorio personal.\n\n   * **Project** (`.github/agents/`)\n\n   * **Usuario** (`~/.copilot/agents/`)\n\n   > \\[!NOTE]\n   > Si hay custom agents con el mismo nombre en ambas ubicaciones, se utilizará el del directorio personal, en lugar del del repositorio.\n\n4. Elija si quiere que Copilot, cree el archivo custom agent o créelo usted mismo.\n\n**Opción 1: Usar Copilot**\n\nEscriba los detalles del agente que desea crear. Describa la experiencia del agente y cuándo se debe usar el agente.\nCopilot tomará la descripción que introduce y la usará para escribir un perfil de agente para usted.\n\nPor ejemplo, podría ingresar:\n\n```text\nI am a security expert. I check code files thoroughly for potential security issues. Use me whenever a security review/check/audit is requested for one or more code files, or when the word \"seccheck\" is used in a prompt in reference to code files.\n\nI will identify potential problems, such as code that:\n\n- Exposes secrets or credentials\n- Allows cross-site scripting\n- Allows SQL injection\n- Contains vulnerable dependencies\n- Allows authentication to be bypassed\n\nIf any problems are identified, create a single GitHub issue in this repository on GitHub.com with details of problems, giving full details of each issue, including, but not limited to, risk level and recommended fix.\n```\n\nUna vez Copilot finalizada la generación del perfil inicial del agente, se muestran las siguientes opciones:\n\n* Continuar\n* Revisión del contenido\n* Volver a intentarlo\n* Salir\n\nSi decide revisar el contenido, el archivo del agente se abre en el editor predeterminado. Puede revisar y realizar cambios, si es necesario, antes de continuar con el proceso de creación del agente en la CLI.\n\nPara completar el proceso de creación, elija **Continuar**.\n\n**Opción 2: Creación manual del perfil del agente**\n\nAl elegir crear el archivo del agente usted mismo, se le guiará a través de una serie de avisos para rellenar la información necesaria para crear el perfil del agente.\n\n1. Escriba un nombre para el agente. El nombre que escriba es el nombre que se muestra al enumerar los agentes disponibles. Una versión de esto se usará como nombre del archivo del agente; por ejemplo, si escribe \"Experto en seguridad\", el archivo del agente se denominará `security-expert.agent.md`.\n\n   > \\[!TIP]\n   > Para facilitar el uso de un elemento custom agent mediante programación, se recomienda elegir un nombre que consta solo de letras minúsculas y guiones.\n\n2. Escriba una descripción que indique qué experiencia tiene este agente y cuándo se debe usar.\n\n3. Escriba instrucciones sobre cómo debe comportarse el agente, incluidas las instrucciones específicas, las acciones que debe realizar o las restricciones que debe seguir.\n\n4. Elija las herramientas custom agent a las que debe tener acceso.\n\n   De forma predeterminada, custom agents tiene acceso a todas las herramientas. Si restringe el acceso de un agente, se agrega una `tools` especificación al archivo del agente.\n\n5. Reinicie la CLI para cargar el nuevo custom agent.\n\n## Uso de un custom agent\n\nCustom agents se puede usar de las siguientes maneras:\n\n* **Comando Slash**\n\n  Escriba `/agent` en modo interactivo y elija de la lista de custom agents disponibles. A continuación, escriba un mensaje que se pasará al agente seleccionado.\n\n  > \\[!NOTE]\n  > Los agentes predeterminados de la CLI no se incluyen en esta lista. Para obtener más información sobre los agentes predeterminados, consulte [Acerca de los agentes personalizados](/es/copilot/concepts/agents/copilot-cli/about-custom-agents#built-in-agents).\n\n* **Instrucción explícita**\n\n  Indica Copilot que use un agente específico. Por ejemplo:\n\n  ```copilot\n  Use the security-auditor agent on all files in the /src/app directory\n  ```\n\n* **Por inferencia**\n\n  Utilice una solicitud que desencadene el uso de un agente particular basándose en la descripción del archivo del agente. Por ejemplo:\n\n  ```copilot\n  Check all TypeScript files in or under the src directory for potential security problems\n  ```\n\n  o (donde \"seccheck\" se define como una palabra de desencadenador en el perfil del agente):\n\n  ```copilot\n  seccheck /src/app/validator.go\n  ```\n\nCopilot deducirá automáticamente el agente que desea usar.\n\n* **Programáticamente**\n\n  Especifique el custom agent que desea usar con la opción de línea de comandos. Por ejemplo:\n\n  ```shell\n  copilot --agent security-auditor --prompt \"Check /src/app/validator.go\"\n  ```\n\n  Donde `security-auditor` es el nombre de archivo del perfil custom agent, sin extensión `.agent.md`. Normalmente, pero no necesariamente, esto es lo mismo que el `name` valor del perfil del agente.\n\n## Lectura adicional\n\n* [Comparación de las características de personalización de la CLI de GitHub Copilot](/es/copilot/concepts/agents/copilot-cli/comparing-cli-features)\n* [Configuración de agentes personalizados](/es/copilot/reference/custom-agents-configuration)\n* [Referencia de comandos de la CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-command-reference#custom-agents-reference)\n* [Agentes personalizados](/es/copilot/tutorials/customization-library/custom-agents): una colección seleccionada de ejemplos"}