Introducción al modo de agente de Copilot de GitHub

Con el modo de agente de Copilot de GitHub en Visual Studio, puede usar lenguaje natural para especificar una tarea de alto nivel. La inteligencia artificial crea un plan, realiza modificaciones de código, ejecuta comandos de terminal, invoca herramientas y aplica cambios en el código base. Supervisa los resultados, como los resultados de la compilación, los errores de prueba unitaria o las salidas de herramientas, e itera según sea necesario.

A diferencia del modo ask, el modo de agente no se detiene después de una sola respuesta. Sigue ejecutándote y refinando los pasos hasta que llegues al objetivo en el mensaje o se requieran más datos.

Prerequisites

Necesita Visual Studio 2022, versión 17.14 o posterior.

Uso del modo de agente

En el modo de agente, Copilot funciona de forma autónoma y determina el contexto pertinente para el mensaje.

Para empezar, siga estos pasos:

1. Abra la ventana Chat de Copilot, seleccione Preguntar para expandir el menú desplegable modo y, a continuación, seleccione Agente.

   

2. Escriba el mensaje y, a continuación, seleccione Enviar o seleccione la tecla Entrar para enviarla. Puede especificar un requisito de alto nivel y no tiene que especificar los archivos en los que trabajar.

3. El modo de agente puede invocar varias herramientas para realizar diferentes tareas. Opcionalmente, seleccione el icono Herramientas para configurar qué herramientas adicionales puede usar el agente para responder a la solicitud.

   

4. Copilot solicita confirmación antes de ejecutar un comando de terminal o usar una herramienta que no está integrada.

   

5. Copilot detecta automáticamente problemas en los comandos de terminal o ediciones de código y, a continuación, realiza acciones. El proceso se repite hasta que se resuelven los problemas.

6. A medida que Copilot procesa la solicitud, transmite las modificaciones de código sugeridas directamente en el editor. Revise las modificaciones sugeridas y:

   • Mantenga o descarte las modificaciones sugeridas como un todo en Total de cambios en la ventana de chat.

     

   • Revise las diferencias de archivos individuales y aplíquelas de forma selectiva.

7. Si desea revisar los cambios de código individuales realizados por el agente, puede:

   • Revise el cambio específico en cada paso.

     

   • Revise los cambios acumulados de la última vez que se conservaron o deshaceron los cambios.

     

8. Continúe iterando en los cambios de código para refinar las ediciones o implementar más características.

Descripción de las herramientas del modo de agente

El modo de agente puede usar las siguientes herramientas para responder a una solicitud:

• Herramientas integradas
• Herramientas del Protocolo de contexto de modelo (MCP)

Para ver y administrar las herramientas disponibles en el modo de agente, seleccione el icono Herramientas en la ventana de chat.

En función del resultado de una herramienta, Copilot podría invocar otras herramientas para realizar la solicitud general. Por ejemplo, si una edición de código produce errores de sintaxis en el archivo, Copilot podría explorar otro enfoque y sugerir cambios de código diferentes.

Las herramientas adicionales que agregue mediante la ejecución de servidores MCP no están habilitadas automáticamente. Sus casillas están desactivadas de forma predeterminada y debe seleccionarlas para activar las herramientas.

Administración de aprobaciones de herramientas

Cuando Copilot invoca una herramienta, solicita confirmación para ejecutar la herramienta. El motivo es que las herramientas se pueden ejecutar localmente en la máquina y realizar acciones que modifiquen archivos o datos.

En la ventana de chat, después de una invocación de herramienta, use las opciones desplegable Permitir para confirmar automáticamente la herramienta específica de la sesión o solución actual, o todas las invocaciones futuras.

Puede restablecer las selecciones de confirmación de herramientas en el panel Opciones de herramientas>. Expanda la sección Todas las configuraciones> deGitHub>Copilot>Tools.

Aceptar o descartar modificaciones

Copilot enumera los archivos editados en la lista Total de cambios en la ventana de chat.

Seleccione cada archivo para revisar los cambios individualmente. Puede conservar o deshacer las modificaciones realizadas en cada fragmento de código.

Como alternativa, en la lista Total de cambios , seleccione Mantener o Deshacer para todas las modificaciones realizadas desde la última vez que seleccionó Mantener o Deshacer.

Reversión de las modificaciones

A medida que solicite modificaciones de código, es posible que quiera revertir algunos cambios. Para revertir, seleccione Restaurar junto al punto de control antes del aviso que incluya los cambios que no desee.

Actualmente, el agente de Visual Studio Copilot no admite deshacer o rehacer de forma gradual.

Interrumpir una solicitud en modo de agente

Para interrumpir una solicitud en curso, puede cancelarla. La cancelación de una solicitud detiene todas las herramientas en ejecución y los comandos de terminal.

Para detener una compilación, seleccione Compilar en la barra de herramientas superior y, a continuación, seleccione Cancelar. O bien, use el método abreviado de teclado Ctrl+Interrumpir .

Planeación en modo agente (versión preliminar)

Nota:

El planeamiento está disponible en versión preliminar pública con Visual Studio 2022, versión 17.14. Esta característica está en desarrollo activo y podría evolucionar en función de los comentarios de los usuarios.

Planear en modo agente permite a Copilot dividir solicitudes complejas o de varios pasos en tareas estructuradas y rastreables antes de la ejecución.

Cuando la Planificación está activa, Copilot:

• Crea un plan markdown orientado al usuario que describe los objetivos y el progreso.
• Mantiene un plan JSON interno (plan-{sessionId}.json) que actúa como un tablón temporal legible por LLM para el seguimiento de pasos, el razonamiento y la coordinación.

Esta estructura ayuda a Copilot a mantener la coherencia, actualizar su plan dinámicamente y proporcionar a los desarrolladores visibilidad sobre lo que está haciendo.

Cómo funciona

Análisis de solicitudes

Cuando una tarea requiere varios pasos, Copilot entra en modo de planeación.

Creación de planes

• Plan de Markdown: describe la tarea, los pasos y el progreso en un formato legible.
• Plan JSON: un formato estructurado y legible por LLM que captura el mismo plan en una forma analizable por máquina. Este archivo JSON permite a Copilot actualizar e interpretar el plan de forma coherente entre turnos.

Ejecución e iteración

Copilot ejecuta cada paso del plan, actualizando ambos archivos a medida que continúa.

• El plan markdown se actualiza visiblemente en el editor.
• El plan JSON evoluciona en segundo plano a medida que Copilot refina, reordena o adapta los pasos.

Almacenamiento

Ambos archivos se almacenan en C:\Users\username\AppData\Local\Temp\VisualStudio\copilot-vs.

Herramientas usadas en el planeamiento

Al habilitar Planning, se activa un conjunto dedicado de herramientas internas. Estas herramientas coordinan cómo Copilot crea, actualiza y finaliza los planes durante la ejecución.

Tool	Description
plan	Genera el plan estructurado inicial a partir de la solicitud de usuario.
plan_de_adaptación	Refina o ajusta el plan en función del nuevo contexto o comentarios.
update_plan_progress	Actualiza el estado de finalización del paso y sincroniza el estado del plan.
record_observation	Captura los resultados en tiempo de ejecución o la información que influyen en las siguientes acciones.
finalizar_plan	Finaliza el plan una vez completados todos los pasos.

Estas herramientas permiten a Copilot administrar flujos de trabajo de varios pasos de forma incremental, mantener el estado de ejecución y mantenerse alineados con la intención del usuario.

Habilitación y administración de herramientas de planificación

Para habilitar planning:

1. Abrael panel> y expanda la sección Todos los ajustes>de GitHub>Copilot>Copilot Chat.

2. Active la casilla Habilitar planeación .

Después de habilitar la planeación, las herramientas de planeación aparecen en la lista Herramientas de la ventana de chat:

Puede deshabilitar selectivamente el conjunto de herramientas de planeación directamente en la lista Herramientas de la ventana de chat. Si necesita deshabilitar las herramientas de planeación, se recomienda deshabilitar todo, no solo uno. Los cambios se aplican inmediatamente a la sesión de chat actual.

Sugerencia

Deshabilitar herramientas individuales le permite experimentar con diferentes comportamientos de planificación o depurar pasos específicos durante el desarrollo.

Limitaciones

• Los planes se almacenan temporalmente y se eliminan cuando finaliza la sesión, a menos que se guarde manualmente.
• Existe una ligera sobrecarga de latencia debido al seguimiento de estado estructurado.
• Es posible que algunos agentes especializados todavía no sean compatibles con la planificación de tareas.

Proporcionar comentarios

Estamos mejorando activamente la planeación en modo de agente. Comparta sus comentarios, informe de problemas o sugiera mejoras aquí: Planeación en chat de Copilot : Comunidad para desarrolladores de Visual Studio

Preguntas más frecuentes

¿Qué visibilidad tiene el modo de agente en mis archivos?

El modo de agente solo puede manipular:

• Archivos locales que forman parte de la solución.
• Archivos locales que se encuentran en el directorio de la solución abierta o en sus subdirectorios.

El modo de agente no puede acceder a archivos y directorios excluidos a través de la exclusión de archivos.

En el caso de los comandos de terminal, el modo de agente tiene los mismos permisos que el proceso de Visual Studio en ejecución y no se limita a las restricciones anteriores. Revise cuidadosamente los comandos de terminal propuestos antes de ejecutarlos.

No veo el modo de preguntar y el modo de agente en la ventana Chat de Copilot

Siga estos pasos de solución de problemas en el orden especificado:

1. Asegúrese de que usa Visual Studio 17.14 o posterior.

   • Consulte la versión en Ayuda>sobre Visual Studio.

   • Si no usa la versión 17.14 o posterior, abra el Instalador de Visual Studio y actualice la compilación.

2. Confirme que la opción Habilitar modo agente en el panel de chat está seleccionada.

   En el panel>Herramientas, expanda la sección Todas las configuraciones>GitHub>Copilot>Copilot Chat y verifique que la opción esté seleccionada.

3. Intente reiniciar Visual Studio.

¿Cuándo debo usar el modo de pregunta frente al modo de agente?

• El modo Preguntar es excelente cuando desea 100% confianza de que no se realicen modificaciones de código a menos que seleccione Explícitamente Aplicar o copiar y pegue el código usted mismo.
• El modo de agente puede controlar las mismas preguntas conceptuales y generar ejemplos de código sin aplicarlos, junto con sus funcionalidades de agente de edición de código.
• Si desea usar las funcionalidades de MCP, debe tener seleccionado el modo de agente.

¿Qué ha ocurrido con las ediciones de Copilot en Visual Studio?

El modo de agente es una evolución de las ediciones de Copilot, con una mayor capacidad de iterar los errores, usar herramientas y aplicar automáticamente cambios de código.

Como administrador, ¿cómo puedo controlar el uso del modo de agente para los usuarios de Visual Studio?

El modo de agente en Visual Studio se rige por la marca de características de vista previa del editor en el panel de GitHub Copilot para los administradores. Si el administrador desactiva esta configuración, los usuarios de esa suscripción no pueden usar el modo de agente en Visual Studio.

Para obtener más información, consulte Administración de directivas y características para GitHub Copilot en su empresa.

Contenido relacionado

• Ediciones de GitHub Copilot
• GitHub Copilot Gratis