{"meta":{"title":"Creación de agentes personalizados para Copilot cloud agent","intro":"Puede crear agentes especializados con conocimientos personalizados 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-on-github","title":"Copilot en GitHub"},{"href":"/es/copilot/how-tos/copilot-on-github/customize-copilot","title":"Personalizar Copilot"},{"href":"/es/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent","title":"Personalizar cloud agent"},{"href":"/es/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents","title":"Creación de agentes personalizados"}],"documentType":"article"},"body":"# Creación de agentes personalizados para Copilot cloud agent\n\nPuede crear agentes especializados con conocimientos personalizados para tareas de desarrollo específicas.\n\nCustom agents le permiten adaptar la experiencia de Copilot a tareas específicas. Para obtener información general conceptual sobre custom agents, consulte [Acerca de los agentes personalizados](/es/copilot/concepts/agents/cloud-agent/about-custom-agents).\n\n> \\[!NOTE]\n> Custom agents se encuentran en versión preliminar pública para los IDEs de JetBrains, Eclipse y Xcode y pueden estar sujetos a cambios.\n\n## Creación de un perfil en un repositorio en custom agent\n\n1. Vaya a la pestaña agentes en [https://github.com/copilot/agents](https://github.com/copilot/agents?ref_product=copilot\\&ref_type=engagement\\&ref_style=text).\n\n2. Con el menú desplegable del cuadro de solicitud, seleccione el repositorio en el que desea crear el custom agent perfil.\n\n > \\[!NOTE]\n > Los propietarios de la organización pueden crear custom agents a nivel de organización en el repositorio `.github` o `.github-private` de la organización, que están disponibles en todos los repositorios de su organización. Los propietarios de empresas pueden crear un nivel custom agents de empresa en el `.github-private` repositorio de una organización designada en la configuración empresarial, disponible en todas las organizaciones de la empresa. Para obtener más información, vea [Preparación para usar agentes personalizados en su organización](/es/copilot/how-tos/administer-copilot/manage-for-organization/prepare-for-custom-agents) y [Preparación para usar agentes personalizados en su empresa](/es/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents).\n\n3. De forma opcional, seleccione la rama en la cual desea crear el agent profile. El valor predeterminado es la rama principal.\n\n4. Haga clic en y, a continuación, haga clic en ** Crear un agente**. Se abrirá un perfil de agente de plantilla denominado `my-agent.agent.md` en el directorio `.github/agents` del repositorio de destino.\n\n5. Si está creando una organización o una empresa de nivel custom agent empresarial, elimine la parte `.github/` de la ruta de acceso del archivo para mover su plantilla al directorio raíz `agents`.\n\n6. Edite el nombre de archivo (el texto anterior a `.agent.md`), seleccionando un nombre único y descriptivo que identifique el propósito del agente. Tenga en cuenta que el nombre de archivo solo puede contener los siguientes caracteres: `.`, `-`, `_``a-z`, , `A-Z`, . `0-9`\n\n7. Configure el agent profile, incluido el nombre, la descripción, las herramientas y las indicaciones. Para obtener más información sobre lo que agent profile puede incluir, vea [Configuración de un agent profile](#configuring-an-agent-profile).\n\n8. Confirme el archivo en el repositorio y combítelo en la rama predeterminada. Vuelva a la pestaña agentes y actualice la página si es necesario. Ahora custom agent aparecerá en la lista desplegable al hacer clic en el cuadro de diálogo.\n\n## Configuración de un agent profile\n\nUn agent profile es un archivo Markdown con frontmatter de YAML que especifica el nombre, la descripción, las herramientas disponibles y las configuraciones del servidor MCP de custom agent. La configuración de un agent profile elemento implica definir la identidad, las funcionalidades, el acceso a herramientas y las instrucciones de comportamiento del agente.\n\nPara obtener información detallada sobre las propiedades YAML, las herramientas, la configuración del servidor MCP, los alias de herramientas y cómo se procesan custom agents, consulte [Configuración de agentes personalizados](/es/copilot/reference/custom-agents-configuration).\n\nPara configurar agent profile:\n\n1. Opcionalmente, escriba un `name` para custom agent. Si no se establece, el nombre tendrá como valor predeterminado el nombre de archivo (sin el `.md` sufijo o `.agent.md` ).\n2. Escriba un breve `description` (obligatorio) explicando lo que hace tu agente y sus capacidades específicas o su expertise en el dominio.\n3. En la `tools` propiedad , defina qué herramientas puede usar el agente. Se trata de una lista de nombres o alias de herramientas, incluidas las herramientas de los servidores MCP configurados en la configuración del repositorio o en agent profile (por ejemplo, `tools: [\"read\", \"edit\", \"search\", \"some-mcp-server/tool-1\"]`). Si omite esta propiedad, el agente tendrá acceso a todas las herramientas disponibles. Consulte \"Herramientas\" en [Configuración de agentes personalizados](/es/copilot/reference/custom-agents-configuration#tools).\n4. Opcionalmente, en la `mcp-servers` propiedad , puede configurar servidores MCP que solo estarán disponibles para este agente para ampliar sus funcionalidades. Consulte \"Detalles de configuración del servidor MCP\" en [Configuración de agentes personalizados](/es/copilot/reference/custom-agents-configuration#mcp-server-configuration-details).\n5. Si van a crear y usar agent profile en VS Code, los IDEs de JetBrains, Eclipse o Xcode, también pueden usar la propiedad `model` para controlar qué modelo de IA debe usar el agente.\n6. Opcionalmente, establezca la propiedad `target` en `vscode` o `github-copilot` si solo desea usar el agente en un entorno específico. El agente estará disponible en ambos entornos si omite la propiedad.\n7. Escriba el mensaje del agente. Defina el comportamiento, la experiencia y las instrucciones del agente en el contenido de Markdown debajo del frontmatter de YAML. El mensaje puede tener un máximo de 30 000 caracteres.\n\n## Por ejemplo, agent profiles\n\nEn los ejemplos siguientes se muestra lo que un agent profile podría parecer para las tareas comunes de realizar pruebas o planificar la implementación de un proyecto. Para obtener más inspiración, consulte los ejemplos [de Custom agents](/es/copilot/tutorials/customization-library/custom-agents) en la biblioteca de personalización. También puede encontrar ejemplos más específicos en la colección de comunidad [awesome-copilot](https://github.com/github/awesome-copilot/tree/main/agents) .\n\n### Especialista en pruebas\n\nEn este ejemplo se habilitan todas las herramientas omitiendo la `tools` propiedad .\n\n```text copy\n---\nname: test-specialist\ndescription: Focuses on test coverage, quality, and testing best practices without modifying production code\n---\n\nYou are a testing specialist focused on improving code quality through comprehensive testing. Your responsibilities:\n\n- Analyze existing tests and identify coverage gaps\n- Write unit tests, integration tests, and end-to-end tests following best practices\n- Review test quality and suggest improvements for maintainability\n- Ensure tests are isolated, deterministic, and well-documented\n- Focus only on test files and avoid modifying production code unless specifically requested\n\nAlways include clear test descriptions and use appropriate testing patterns for the language and framework.\n```\n\n### Planificador de implementación\n\nEn este ejemplo solo se habilita un subconjunto de herramientas.\n\n```text copy\n---\nname: implementation-planner\ndescription: Creates detailed implementation plans and technical specifications in markdown format\ntools: [\"read\", \"search\", \"edit\"]\n---\n\nYou are a technical planning specialist focused on creating comprehensive implementation plans. Your responsibilities:\n\n- Analyze requirements and break them down into actionable tasks\n- Create detailed technical specifications and architecture documentation\n- Generate implementation plans with clear steps, dependencies, and timelines\n- Document API designs, data models, and system interactions\n- Create markdown files with structured plans that development teams can follow\n\nAlways structure your plans with clear headings, task breakdowns, and acceptance criteria. Include considerations for testing, deployment, and potential risks. Focus on creating thorough documentation rather than implementing code.\n```\n\n## Usar custom agents\n\nUna vez que haya creado un custom agent, puede usarlo donde Copilot cloud agent esté disponible.\n\n* Cuando solicite a Copilot cloud agent una tarea en GitHub.com, use el menú desplegable del panel de agentes o de la pestaña de agentes para seleccionar la opción custom agent en lugar de la predeterminada cloud agent.\n* Al asignar Copilot cloud agent a un problema, puede seleccionar custom agent del menú desplegable para gestionar la incidencia con su configuración especializada.\n* Al usar GitHub Copilot CLI, puede optar por usar un custom agent concreto mediante el comando de barra oblicua `/agent` o haciendo referencia al agente en un indicador del sistema o a través de un argumento de línea de comandos. Para obtener más información, vea [Uso de la CLI de GitHub Copilot](/es/copilot/how-tos/copilot-cli/use-copilot-cli/overview#use-custom-agents).\n\nCuando Copilot abre solicitudes de incorporación de datos, anotará qué custom agent se usó para completar la descripción de la solicitud de incorporación de datos.\n\nPara más información sobre el uso de Copilot cloud agent, consulta [Inicio de sesiones de GitHub Copilot](/es/copilot/how-tos/use-copilot-agents/cloud-agent/start-copilot-sessions).\n\n## Pasos siguientes\n\n* Para ver un tutorial práctico para crear su primer custom agent, consulte [Primer agente personalizado](/es/copilot/tutorials/customization-library/custom-agents/your-first-custom-agent).\n* Para obtener información detallada sobre la configuración, consulte [Configuración de agentes personalizados](/es/copilot/reference/custom-agents-configuration).\n* Para obtener información sobre el uso de agentes en la nube, incluido custom agents, para iniciar Copilot sesiones, consulte [Inicio de sesiones de GitHub Copilot](/es/copilot/how-tos/use-copilot-agents/cloud-agent/start-copilot-sessions)."}