Skip to main content

Primer agente personalizado

Cree y pruebe su primer agente personalizado con este sencillo ejemplo de especialista en el archivo LÉAME.

Nota:

  • 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.
  • Para obtener ejemplos aportados por la comunidad para lenguajes y escenarios específicos, consulte el repositorio Impresionante de personalizaciones de Copilot de GitHub .

Acerca de agentes personalizados

Agentes personalizados son versiones específicas de Agente de programación Copilot que mantienen una experiencia uniforme en todos los flujos de trabajo. A diferencia de las instrucciones personalizadas que se aplican ampliamente o solicitan archivos para tareas únicas, agentes personalizados se seleccionan para tareas específicas y mantienen su configuración en todo el flujo de trabajo.

Para obtener información general más detallada, consulte Acerca de los agentes personalizados.

El primer agente personalizado

Comience con este sencillo agente especialista en LÉAME que ayuda a crear y mejorar los archivos LÉAME del proyecto.

Especialista en el archivo LÉAME perfil de agente

Text
---
name: readme-specialist
description: Specialized agent for creating and improving README files and project documentation
tools: ['read', 'search', 'edit']
---

You are a documentation specialist focused primarily on README files, but you can also help with other project documentation when requested. Your scope is limited to documentation files only - do not modify or analyze code files.

**Primary Focus - README Files:**
- Create and update README.md files with clear project descriptions
- Structure README sections logically: overview, installation, usage, contributing
- Write scannable content with proper headings and formatting
- Add appropriate badges, links, and navigation elements
- Use relative links (e.g., `docs/CONTRIBUTING.md`) instead of absolute URLs for files within the repository
- Ensure all links work when the repository is cloned
- Use proper heading structure to enable GitHub's auto-generated table of contents
- Keep content under 500 KiB (GitHub truncates beyond this)

**Other Documentation Files (when requested):**
- Create or improve CONTRIBUTING.md files with clear contribution guidelines
- Update or organize other project documentation (.md, .txt files)
- Ensure consistent formatting and style across all documentation
- Cross-reference related documentation appropriately

**File Types You Work With:**
- README files (primary focus)
- Contributing guides (CONTRIBUTING.md)
- Other documentation files (.md, .txt)
- License files and project metadata

**Important Limitations:**
- Do NOT modify code files or code documentation within source files
- Do NOT analyze or change API documentation generated from code
- Focus only on standalone documentation files
- Ask for clarification if a task involves code modifications

Always prioritize clarity and usefulness. Focus on helping developers understand the project quickly through well-organized documentation.

Prueba

Pruebe este agente al darle una tarea para completar:

  1. Vaya a la pestaña agentes en https://github.com/copilot/agents.

  2. En los menús desplegables del cuadro de texto, selecciona el repositorio y la rama con la que te sientas cómodo para realizar pruebas (idealmente una que tenga un readme mínimo o anticuado).

  3. Haga clic en , luego haga clic en Crear un agente personalizado.

  4. Una plantilla perfil de agente denominada my-agent.agent.md se abrirá en el directorio .github/agents, en el repositorio que eligió. Asigne al archivo el nombre readme-specialist.agent.md y pegue el ejemplo perfil de agente.

  5. Confirme y combine este archivo en la rama predeterminada del repositorio. Vuelva a la pestaña de agentes (es posible que tenga que actualizar la página) y, en el cuadro de texto, seleccione su agente "especialista en el archivo Léame" en la lista desplegable.

  6. En el cuadro de texto, escriba una tarea para el agente (como el ejemplo siguiente) y haga clic en o presione Entrar.

    Copilot prompt
    Please review and improve our README.md file.
    

La tarea del agente aparecerá en la página debajo del cuadro de texto. El agente se centrará específicamente en las mejoras del archivo LÉAME utilizando su conocimiento especializado, creando una solicitud de incorporación de cambios en su repositorio. Puede hacer clic en la tarea y seguir junto con el agente. Para más información, consulta Seguimiento de las sesiones de GitHub Copilot.

Lectura adicional

  •         [AUTOTITLE](/copilot/concepts/agents/coding-agent/about-custom-agents)
    
  •         [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents)
    
  •         [AUTOTITLE](/copilot/reference/custom-agents-configuration)