Este inicio rápido le guía a través de la personalización de GitHub Copilot para un repositorio. Al final, Copilot conocerá las convenciones del proyecto, tendrá un agente especializado para tareas comunes y ha mantenido el contexto del proyecto.
**Escenario:** Trabaja en el repositorio de aplicaciones web de un equipo con un conjunto de pruebas establecido, convenciones de codificación y problemas activos. Desea que Copilot trabaje eficazmente con el código base desde el primer día.
Prerequisites
- Plan Copilot que incluye agente en la nube de Copilot (GitHub Copilot Pro+, Copilot Businesso Copilot Enterprise). Para obtener más información, vea Planes para GitHub Copilot.
- Agente en la nube está habilitado para su organización o cuenta. Para obtener más información, vea Administración del acceso a agente de nube de GitHub Copilot.
- Acceso de escritura a un GitHub repositorio.
Paso 1: Enseñar Copilot las convenciones del proyecto
Las instrucciones personalizadas del repositorio proporcionan Copilot contexto persistente sobre el proyecto: su estructura, estándares de codificación y cómo compilar y probar código. Cada Copilot interacción del repositorio usa estas instrucciones automáticamente.
Pida agente en la nube de Copilot que genere un copilot-instructions.md archivo:
-
Vaya a github.com/copilot/agents.
-
Seleccione el repositorio en el menú desplegable del campo de solicitud.
-
Escriba el siguiente mensaje:
Text Onboard this repository to Copilot cloud agent by adding a .github/copilot-instructions.md file. Include information about project structure, coding conventions, the test framework, and how to build and run the project.
Onboard this repository to Copilot cloud agent by adding a .github/copilot-instructions.md file. Include information about project structure, coding conventions, the test framework, and how to build and run the project. -
Revise el archivo generado y fusione el pull request.
Copilot ahora comprende las convenciones de tu proyecto en el chat, la revisión de código y las sesiones del agente. Consulte [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions).
Paso 2: Creación de un agente especializado
Agentes personalizados permiten crear asistentes centrados para tareas periódicas. En este ejemplo, cree un agente que diagnostique y corrija errores.
-
Vaya a github.com/copilot/agents y seleccione el repositorio.
-
En el campo de aviso, haga clic en . A continuación, haga clic en Crear un agente personalizado.
-
Cambie el nombre del archivo a
bug-fixer.agent.md. -
Reemplace el contenido de la plantilla por:
YAML --- name: Bug Fixer description: Diagnoses and fixes bugs reported in GitHub issues. tools: - read - edit - terminal - search --- You are a bug-fixing specialist. When given a bug report or issue: 1. Reproduce the bug by writing a failing test. 2. Identify the root cause. 3. Fix the code. 4. Verify the fix passes the test and doesn't break existing tests. Always follow the project's testing conventions and coding standards.
--- name: Bug Fixer description: Diagnoses and fixes bugs reported in GitHub issues. tools: - read - edit - terminal - search --- You are a bug-fixing specialist. When given a bug report or issue: 1. Reproduce the bug by writing a failing test. 2. Identify the root cause. 3. Fix the code. 4. Verify the fix passes the test and doesn't break existing tests. Always follow the project's testing conventions and coding standards. -
Confirme el archivo y combítelo en la rama predeterminada.
Ahora, su agente de corrección de errores aparece en el menú desplegable de la pestaña de agentes. Selecciónelo antes de pegar una URL de problema para iniciar una sesión de depuración enfocada. Consulte Creación de agentes personalizados para agente en la nube de Copilot.
Paso 3: Organizar el contexto del proyecto con un espacio
Espacios de Copilot le permite seleccionar el contexto exacto que Copilot necesita para un área específica de su proyecto. Las respuestas se basan en archivos, problemas y documentación pertinentes.
-
Vaya a github.com/copilot/spaces y haga clic en Crear espacio.
-
Asigne un nombre al espacio (por ejemplo, "Arquitectura de API") y elija un propietario.
-
Haga clic en Agregar orígenes y agregue contexto que sea relevante para el proyecto:
<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-file-code" aria-label="file-code" role="img"><path d="M4 1.75C4 .784 4.784 0 5.75 0h5.586c.464 0 .909.184 1.237.513l2.914 2.914c.329.328.513.773.513 1.237v8.586A1.75 1.75 0 0 1 14.25 15h-9a.75.75 0 0 1 0-1.5h9a.25.25 0 0 0 .25-.25V6h-2.75A1.75 1.75 0 0 1 10 4.25V1.5H5.75a.25.25 0 0 0-.25.25v2.5a.75.75 0 0 1-1.5 0Zm1.72 4.97a.75.75 0 0 1 1.06 0l2 2a.75.75 0 0 1 0 1.06l-2 2a.749.749 0 0 1-1.275-.326.749.749 0 0 1 .215-.734l1.47-1.47-1.47-1.47a.75.75 0 0 1 0-1.06ZM3.28 7.78 1.81 9.25l1.47 1.47a.751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018l-2-2a.75.75 0 0 1 0-1.06l2-2a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042Zm8.22-6.218V4.25c0 .138.112.25.25.25h2.688l-.011-.013-2.914-2.914-.013-.011Z"></path></svg> Agregar archivos y repositorios** : agregue documentos de arquitectura, esquemas de API o archivos de configuración de claves.
<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-link" aria-label="link" role="img"><path d="m7.775 3.275 1.25-1.25a3.5 3.5 0 1 1 4.95 4.95l-2.5 2.5a3.5 3.5 0 0 1-4.95 0 .751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018 1.998 1.998 0 0 0 2.83 0l2.5-2.5a2.002 2.002 0 0 0-2.83-2.83l-1.25 1.25a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042Zm-4.69 9.64a1.998 1.998 0 0 0 2.83 0l1.25-1.25a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042l-1.25 1.25a3.5 3.5 0 1 1-4.95-4.95l2.5-2.5a3.5 3.5 0 0 1 4.95 0 .751.751 0 0 1-.018 1.042.751.751 0 0 1-1.042.018 1.998 1.998 0 0 0-2.83 0l-2.5 2.5a1.998 1.998 0 0 0 0 2.83Z"></path></svg> Vincular archivos, solicitudes de incorporación de cambios y problemas** : pegue direcciones URL para problemas activos o discusiones de diseño. -
En el chat del espacio, haga una pregunta como: "¿Qué patrones usa nuestra API para el control de errores?"
Copilot respuestas usando solo el contexto que ha recopilado. Consulte [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/copilot-spaces/create-copilot-spaces).
Pasos siguientes
[AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-personal-instructions)** : establezca preferencias personales que se apliquen en todos los repositorios.
[AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/add-skills)** : agregue nuevas funcionalidades a los agentes.
[AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/extend-cloud-agent-with-mcp)** : conecte agentes a servicios y herramientas externos.
[AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/copilot-spaces/collaborate-with-others)** : comparta sus espacios con sus compañeros de equipo.