Skip to main content

Invocación de agentes personalizados

Use agentes personalizados, aptitudes y servidores MCP en Copilot CLI para ampliar sus funcionalidades.

¿Quién puede utilizar esta característica?

GitHub Copilot CLI está disponible con todos los Copilot planes. Si una organización le envía Copilot, la política Copilot CLI debe estar habilitada en la configuración de la organización.

Utilice custom agents

A custom agent es una versión especializada de Copilot. Custom agents ayudar a Copilot controlar flujos de trabajo únicos, convenciones de codificación concretas y casos de uso especializados.

Copilot CLI incluye un grupo predeterminado de custom agents para tareas comunes:

AgenteDescription
ExplorarRealiza un análisis rápido de código base, lo que le permite formular preguntas sobre el código sin agregar al contexto principal.
tareaEjecuta comandos como pruebas y compilaciones, lo que proporciona resúmenes breves sobre éxito y salida completa en caso de error.
Uso generalControla tareas complejas y de varios pasos que requieren el conjunto de herramientas completo y el razonamiento de alta calidad, que se ejecutan en un contexto independiente para mantener la conversación principal claramente centrada.
Revisión de códigoRevisa los cambios con un enfoque en identificar solo problemas genuinos, minimizando el ruido.

El modelo de IA que utiliza la CLI puede delegar una tarea a un proceso de subagente secundario, que opera utilizando un custom agent con experiencia específica, si considera que esto permitirá completar el trabajo de manera más eficaz. El modelo puede igualmente optar por gestionar el trabajo directamente en el agente principal.

Puede definir su propio custom agents usando archivos Markdown, llamados agent profiles, que especifican qué experiencia debe tener el agente, qué herramientas puede usar y las instrucciones específicas sobre cómo debe responder.

Puede definir custom agents en el nivel de usuario, repositorio, organización o empresa:

TipoLocationÁmbito
Nivel de usuario custom agentdirectorio local ~/.copilot/agentsTodos los proyectos
Nivel de repositorio custom agent
.github/agents directorio en los repositorios locales y remotosProyecto actual
Nivel de organización custom agent
/agentsdirectorio en el repositorio .github o .github-private de la organizaciónTodos los proyectos de la organización
Nivel empresarial custom agentEl directorio /agents del repositorio .github-private de una organización designada en la configuración de la empresa. Para obtener más información, vea Preparación para usar agentes personalizados en su empresa.Todos los proyectos de la cuenta de empresa

En el caso de conflictos de nomenclatura (donde los agentes comparten el mismo nombre de archivo), un agente de nivel de usuario invalida un agente de nivel de repositorio, un agente de nivel de repositorio invalida un agente de nivel de organización y un agente de nivel de organización invalida un agente de nivel empresarial.

Custom agents se puede usar de tres maneras:

  • Utilizando el comando de barra diagonal en la interfaz interactiva de la CLI para seleccionar en la lista de custom agents disponibles:

    /agent
    
  • Llamando directamente a custom agent en una solicitud:

    Use the refactoring agent to refactor this code block
    

Copilot deducirá automáticamente el agente que desea usar.

  • Especifique el custom agent que desea usar mediante la opción de línea de comandos. Por ejemplo:

    copilot --agent=refactor-agent --prompt "Refactor this code block"
    

Para obtener más información, vea Creación de agentes personalizados para Copilot cloud agent.

Usar capacidades

Puede crear aptitudes para mejorar la capacidad de Copilot realizar tareas especializadas con instrucciones, scripts y recursos.

Para obtener más información, vea Adición de habilidades de agente para GitHub Copilot CLI.

Agregar un servidor MCP

Copilot CLI viene con el GitHub servidor MCP ya configurado. Este servidor MCP permite interactuar con los recursos en GitHub.com, por ejemplo, permite fusionar pull requests desde la CLI.

Para ampliar la funcionalidad disponible en Copilot CLI, puede agregar más servidores MCP:

  1. Usa el siguiente comando de barra diagonal:

    /mcp add
    
  2. Rellena los detalles del servidor MCP que deseas agregar, con la tecla Tab para moverte entre los campos.

  3. Pulse Ctrl+S para guardar los detalles.

Los detalles de los servidores MCP configurados se almacenan en el archivo mcp-config.json, que se encuentra, de forma predeterminada, en el directorio ~/.copilot. Esta ubicación se puede cambiar estableciendo la variable de entorno COPILOT_HOME. Para obtener información sobre la estructura JSON de una definición de servidor, consulta Configuración de servidores MCP para el repositorio.

Para obtener información más detallada sobre cómo agregar y administrar servidores MCP en Copilot CLI, vea Adición de servidores MCP para GitHub Copilot CLI.

Pasos siguientes

Para obtener información sobre cómo guiar y refinar el comportamiento del agente durante la ejecución de tareas para seguir el trabajo, consulte Agentes de dirección en GitHub Copilot CLI.