GitHub Copilot Cloud Agent: cómo delegar tareas de programación en GitHub
GitHub Copilot Cloud Agent, anteriormente conocido como Copilot Coding Agent, permite delegar tareas de desarrollo para que Copilot investigue un repositorio, prepare un plan, modifique código, ejecute pruebas y trabaje de forma independiente en un entorno remoto administrado por GitHub. Puedes revisar el diff, iterar mediante comentarios y crear un Pull Request cuando el trabajo esté listo.
¿Qué es GitHub Copilot Cloud Agent?
Copilot Cloud Agent es el agente remoto de desarrollo de GitHub Copilot. Trabaja en segundo plano dentro de un entorno de desarrollo aislado basado en infraestructura de GitHub Actions. Puede investigar código, crear planes, modificar una rama, ejecutar tests, revisar sus propios cambios y preparar el resultado para que una persona lo revise antes de integrarlo.
Copilot Coding Agent ahora se llama Copilot Cloud Agent
Copilot Coding Agent
Nombre utilizado originalmente para el agente autónomo de GitHub.
Copilot Cloud Agent
Refleja mejor que puede investigar, planificar y trabajar remotamente.
Esto permite cubrir tanto las búsquedas históricas como la nueva denominación oficial de GitHub.
Qué puede hacer Copilot Cloud Agent
Investigar
Analiza el repositorio antes de modificarlo.
Planificar
Puede preparar una estrategia antes de escribir código.
Corregir bugs
Investiga causas e implementa fixes.
Crear features
Implementa funcionalidades incrementales.
Mejorar tests
Añade y ejecuta cobertura automatizada.
Preparar PR
Puede convertir el trabajo en un Pull Request.
De una tarea escrita a cambios revisables en GitHub
Delegas
Issue, prompt o comentario.
Trabaja
Entorno remoto y aislado.
Verifica
Tests, lint y seguridad.
Revisas
Diff, branch y Pull Request.
Cloud Agent no trabaja directamente en tu computador
Cuando delegas una tarea, GitHub crea un entorno de desarrollo remoto donde Copilot puede trabajar independientemente. Puedes cerrar el editor, cambiar de tarea o incluso apagar tu equipo.
El agente continúa trabajando en GitHub hasta completar la sesión, necesitar feedback o alcanzar los límites del entorno.
Agent Mode vs Copilot Cloud Agent
| Agent Mode | Cloud Agent |
|---|---|
| Principalmente interactivo | Trabajo delegado |
| Usa tu entorno local | Usa entorno remoto |
| Ediciones inmediatas | Ediciones sobre branch |
| Tú observas el proceso | Puede trabajar en background |
| Ideal para iteración rápida | Ideal para tareas bien delimitadas |
| Resultado en workspace | Resultado revisable en GitHub |
Quién puede utilizar Copilot Cloud Agent
Copilot Cloud Agent está disponible para los planes de pago de GitHub Copilot, sujeto a las políticas y habilitación correspondientes de la cuenta, organización o empresa.
En organizaciones y empresas, un administrador puede controlar mediante políticas si los usuarios pueden utilizar agentes remotos.
Desde dónde puedes iniciar una tarea
GitHub ha ampliado considerablemente los puntos desde donde se puede iniciar una sesión.
Agents
Panel y pestaña de agentes.
Issues
Asignar una incidencia a Copilot.
Pull Requests
Pedir cambios sobre una PR.
VS Code
Delegar una sesión del IDE.
GitHub CLI
Iniciar tareas desde terminal.
MCP
Iniciar tareas desde clientes compatibles.
GitHub Mobile
Delegar desde móvil.
REST API
Automatizar creación de sesiones.
Integraciones
Jira, Slack, Teams, Linear y otras superficies.
Iniciar una tarea desde GitHub
Abre Agents
Desde el repositorio o panel global.
Selecciona repositorio
Elige dónde debe trabajar.
Define la tarea
Escribe un prompt concreto.
Elige branch base
Opcionalmente selecciona el punto de partida.
Elige agente y modelo
Cuando estén disponibles.
Ejecuta
La sesión comienza en background.
Ejemplo de tarea bien delimitada
Fix the duplicate email registration bug.
Current behavior:
Two users can register
using the same email.
Expected behavior:
Email must be unique.
Requirements:
- preserve the public API
- do not modify unrelated modules
- add a regression test
- use the existing validation pattern
Verify:
- valid registration
- duplicate registration
- email normalization
- existing users are unaffected
Run the relevant tests
and summarize the changes.Asignar una incidencia directamente a Copilot
También puedes crear un Issue bien definido y asignarlo a Copilot.
Title:
Prevent duplicate email registration
Problem:
The registration endpoint currently
allows multiple accounts
with the same normalized email.
Acceptance criteria:
- email uniqueness is enforced
- comparison is case insensitive
- existing accounts remain valid
- API response format does not change
- regression tests are added
- all related tests passCuanto mejor esté escrito el Issue, más información recibe el agente para ejecutar correctamente la tarea.
Qué información recibe Copilot al asignarle un Issue
Título del Issue.
Descripción.
Comentarios existentes al asignarlo.
Instrucciones adicionales.
Si necesitas modificar requisitos después de que Copilot empezó, proporciona ese feedback en la sesión o Pull Request.
Cloud Agent puede trabajar en una rama sin abrir inmediatamente un PR
El flujo actual ya no obliga a crear un Pull Request desde el primer momento.
Task
↓
Cloud Agent
↓
Branch
↓
Research / Plan / Code
↓
Review Diff
↓
Iterate
↓
Create Pull RequestSi ya sabes que quieres el resultado como Pull Request, puedes indicarlo expresamente al crear la tarea.
Dónde ejecuta Copilot el código
Cada tarea se ejecuta en un entorno de desarrollo separado del computador del usuario y basado en infraestructura de GitHub Actions.
Dentro de ese entorno, el agente puede:
Acceder al repositorio autorizado.
Instalar dependencias.
Modificar archivos.
Ejecutar tests.
Ejecutar linters.
Construir el proyecto.
Prepara el entorno con copilot-setup-steps.yml
En vez de obligar al agente a descubrir cómo instalar el proyecto en cada sesión, puedes definir:
.github/
└── workflows/
└── copilot-setup-steps.ymlEste workflow se ejecuta antes de que Copilot comience el trabajo.
name: Copilot Setup Steps
on:
workflow_dispatch:
jobs:
copilot-setup-steps:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Set up PHP
uses: shivammathur/setup-php@v2
with:
php-version: "8.2"
- name: Install dependencies
run: composer install --no-interactionGitHub indica que el workflow de setup no se ejecutará para Cloud Agent si el archivo no está disponible en la default branch.
Por qué conviene preparar el entorno
Descubrimiento
El agente debe averiguar cómo instalar y ejecutar todo.
Entorno listo
Dependencias y tooling disponibles desde el inicio.
Enseña al Cloud Agent cómo funciona tu proyecto
Copilot Cloud Agent puede utilizar distintas fuentes de instrucciones:
.github/copilot-instructions.md
.github/instructions/**/*.instructions.md
AGENTS.md
CLAUDE.md
GEMINI.mdInstrucciones útiles para un agente remoto
# Repository overview
This is a WordPress plugin
for managing customer requests.
## Stack
- PHP 8.2
- WordPress
- WooCommerce
- MySQL
- Vanilla JavaScript
## Before modifying code
- inspect similar implementations
- preserve existing public hooks
- preserve backwards compatibility
## Security
- validate untrusted input
- sanitize stored values
- escape output
- use nonces
- check capabilities
- use $wpdb->prepare()
## Verification
Run:
composer test
composer lint
Before finishing:
- inspect git diff
- confirm no unrelated files changed
- report unverified behaviorCloud Agent tiene un sistema separado para secretos y variables
GitHub dispone de secretos y variables específicos para Agents. No debes asumir que Cloud Agent recibe automáticamente los secretos configurados para Actions, Codespaces o Dependabot.
Los Agents secrets pueden utilizarse como variables de entorno dentro del entorno del agente.
Aun así, aplica siempre mínimo privilegio y evita proporcionar credenciales que la tarea no necesita.
Separar credenciales utilizadas por servidores MCP
Los secretos destinados específicamente a servidores MCP utilizan el prefijo:
COPILOT_MCP_GitHub separa su disponibilidad de los secrets generales del entorno del agente.
Cloud Agent no tiene Internet abierto por defecto
GitHub limita de forma predeterminada el acceso a Internet del Cloud Agent mediante un firewall.
La configuración permite:
Activar o desactivar firewall.
Utilizar la allowlist recomendada.
Definir política organizacional.
Definir ajustes por repositorio cuando se permite.
Amplía únicamente los hosts necesarios. El acceso abierto aumenta el riesgo de exfiltración de código o secretos.
GitHub ejecuta controles adicionales sobre el código generado
Entre las validaciones que GitHub puede aplicar al trabajo de Cloud Agent se encuentran:
CodeQL
Busca problemas de seguridad en código.
Secret scanning
Detecta tokens y secretos.
Dependency check
Revisa dependencias nuevas de alto riesgo.
Code Review
Obtiene una revisión adicional del cambio.
Sigue siendo necesaria la revisión humana antes de integrar una modificación.
Cloud Agent no puede modificar cualquier rama libremente
GitHub limita las capacidades de escritura del agente.
main
│
└── copilot/fix-registration
│
├── commit 1
├── commit 2
└── Pull RequestPara una tarea normal, se utiliza una rama específica para el agente.
El resultado necesita revisión humana antes de integrarse.
Los workflows no deberían ejecutarse ciegamente sobre código del agente
Como protección, GitHub puede requerir que una persona con acceso de escritura apruebe la ejecución de workflows provenientes del trabajo del agente.
Revisa primero los cambios del agente antes de permitir que código nuevo ejecute workflows con capacidades adicionales.
Extender el contexto y herramientas del Cloud Agent
Model Context Protocol permite conectar Cloud Agent con fuentes y herramientas adicionales.
GitHub
Issues, PR y contexto histórico.
Documentación
Fuentes técnicas externas.
Databases
Sistemas de información.
Services
Herramientas internas.
MCP puede ampliar el contexto, pero debe configurarse expresamente con los permisos necesarios.
Enseñar procedimientos especializados al Cloud Agent
.github/
└── skills/
└── wordpress-security/
├── SKILL.md
├── checklist.md
└── scripts/Una Skill puede enseñarle al agente cómo ejecutar un procedimiento específico y repetible.
Especializar Cloud Agent para distintos tipos de trabajo
.github/
└── agents/
├── wordpress-security.agent.md
├── test-engineer.agent.md
└── api-reviewer.agent.mdUn Custom Agent puede definir:
Rol especializado.
Instrucciones propias.
Tools disponibles.
Servidores MCP.
Puedes seleccionar un Custom Agent especializado cuando creas la tarea desde Agents o asignas un Issue.
Elegir modelo y nivel de razonamiento
Al iniciar determinadas sesiones puedes seleccionar:
Modelo de IA.
Selección automática.
Nivel de razonamiento cuando está disponible.
No conviene diseñar el workflow dependiendo de un único modelo específico salvo que exista una necesidad clara.
Copilot Cloud Agent puede convivir con Claude y Codex
GitHub permite, en planes y políticas compatibles, utilizar también agentes de terceros para tareas asíncronas.
Copilot
Cloud Agent nativo de GitHub.
OpenAI Codex
Coding agent de OpenAI integrado con GitHub.
Claude
Coding agent de Anthropic integrado con GitHub.
GitHub aplica controles de seguridad y políticas similares a los utilizados por Cloud Agent.
Dar feedback al agente desde el Pull Request
Cuando Copilot ha creado un Pull Request, puedes continuar la conversación mediante comentarios.
@copilot
Keep the current API contract.
Do not return a new error object.
Reuse the existing
validation error structure
and add a regression test
for uppercase email addresses.Copilot puede iniciar una nueva sesión para incorporar ese feedback sobre la misma PR.
Las iteraciones sobre la misma PR conservan contexto
Copilot puede utilizar el contexto acumulado de sesiones anteriores relacionadas con el mismo Pull Request, haciendo más eficiente el feedback posterior.
Convertir feedback de review en una nueva tarea del agente
GitHub permite delegar comentarios específicos de revisión mediante opciones como Fix with Copilot.
Review comment
Identifica el problema.
Fix with Copilot
Delega el comentario.
Instructions
Añade contexto opcional.
Implement
Copilot aplica el cambio.
Revisar exactamente qué hizo el agente
Las sesiones generan logs donde puedes inspeccionar:
Plan y pasos ejecutados.
Comandos utilizados.
Resultados de tests.
Validaciones de seguridad.
Errores encontrados.
Cambios realizados.
Esto facilita entender posteriormente por qué Copilot realizó una modificación concreta.
Administrar varias tareas remotas en paralelo
Agents
│
├── Session 1
│ └── Fix checkout bug
│
├── Session 2
│ └── Add API tests
│
├── Session 3
│ └── Refactor email service
│
└── Session 4
└── Update documentationEl panel de agentes permite revisar sesiones, progreso y resultados sin mezclar sus contextos.
Iniciar Cloud Agent desde la terminal
GitHub CLI dispone de comandos para crear y seguir agent tasks.
gh agent-task createTambién puedes proporcionar directamente la tarea:
gh agent-task create \
"Add regression tests for password reset tokens"Comprueba la versión actual de GitHub CLI y la documentación antes de automatizar procesos críticos.
Delegar desde otros agentes e IDE mediante MCP
El GitHub MCP Server puede exponer herramientas capaces de iniciar Cloud Agent desde clientes compatibles.
Open a pull request
in the repository
to expand unit test coverage
for the authentication module.Esto permite utilizar otro entorno agentic como punto de entrada y delegar finalmente el trabajo a GitHub.
Automatizar Cloud Agent mediante Agent Tasks API
GitHub también dispone de mecanismos programáticos para iniciar agent tasks y monitorizar su progreso.
Esto permite construir automatizaciones como: lanzar refactors repetitivos, preparar releases, generar cambios en múltiples proyectos o integrar agentes con herramientas internas.
Lo que Copilot Cloud Agent no puede hacer libremente
| Limitación | Implicación |
|---|---|
| Un repositorio por tarea | No puede modificar varios repositorios en una misma ejecución |
| Una rama a la vez | El trabajo se concentra en un branch |
| Un PR por tarea | No genera múltiples PR independientes desde la misma sesión |
| 59 minutos máximo | Las tareas enormes deben dividirse |
| GitHub repositories | No trabaja directamente sobre repositorios alojados en otros proveedores |
| Rulesets | Algunas protecciones pueden impedir que el agente trabaje |
Si una tarea probablemente requiere más tiempo, divídela en unidades independientes antes de delegarla.
Divide proyectos grandes en tareas delegables
“Reescribe toda la aplicación”
Demasiado alcance, decisiones y riesgo.
“Migra UserRepository a PDO”
Scope, criterios y tests definidos.
Cloud Agent utiliza AI Credits y GitHub Actions
Las sesiones de Cloud Agent consumen AI Credits por el procesamiento del modelo y GitHub Actions minutes por la infraestructura de ejecución.
El consumo puede variar según:
Modelo seleccionado.
Cantidad de contexto y generación.
Duración de la sesión.
Infraestructura utilizada.
Delegar un bug de WordPress al Cloud Agent
Fix the authorization vulnerability
in the REST endpoint
for editing customer requests.
Requirements:
- preserve the endpoint URL
- preserve the JSON response format
- check authentication
- verify ownership or administrator capability
- keep existing valid requests working
- add regression tests
Review:
- permission_callback
- capabilities
- sanitization
- escaping
- SQL queries
- nonce usage where applicable
Run all relevant tests
and open a pull request
with the fix.El agente necesita poder reproducir tu proyecto
Un repositorio WordPress puede necesitar:
Versión correcta de PHP.
Composer dependencies.
WordPress test environment.
Base de datos para integración.
Dependencias frontend.
Comandos de verificación documentados.
Si el agente puede reproducir, ejecutar y verificar el proyecto, tiene mucha más evidencia para saber si su cambio funciona.
Cómo obtener mejores resultados del Cloud Agent
Delega tareas acotadas.
Define criterios de aceptación.
Añade instrucciones al repositorio.
Documenta comandos de test.
Prepara el entorno de desarrollo.
Limita secretos y permisos.
Mantén el firewall restrictivo.
Revisa session logs.
Revisa el diff completo.
No hagas merge sin revisión humana.
Por qué una tarea puede fallar
| Problema | Qué revisar |
|---|---|
| No instala dependencias | copilot-setup-steps.yml y firewall |
| No puede acceder a una API | Firewall, secrets y MCP |
| No encuentra configuración | Instructions y branch base |
| Tests no ejecutan | Setup del entorno y comandos documentados |
| Ruleset bloquea el agente | Branch protection y políticas |
| La tarea expira | Reducir alcance; límite de sesión |
| No puede cambiar otro repo | Una tarea solo modifica un repositorio |
| CI no se ejecuta | Aprobar workflows cuando corresponda |
Cuándo usar cada superficie de Copilot
Plantilla para delegar una tarea al Cloud Agent
# Objective
[WHAT MUST BE ACHIEVED]
# Context
[WHY THIS CHANGE IS NEEDED]
# Current behavior
[CURRENT]
# Expected behavior
[EXPECTED]
# Scope
Modify:
[FILES OR MODULES]
Do not modify:
[OUT OF SCOPE]
# Constraints
- preserve public APIs
- preserve backwards compatibility
- follow existing architecture
- avoid unrelated refactors
- avoid unnecessary dependencies
- do not weaken security
# Acceptance criteria
1. [CRITERION]
2. [CRITERION]
3. [CRITERION]
# Verification
Run:
- relevant tests
- lint
- typecheck
- build
when available.
# Security
Review:
- authentication
- authorization
- validation
- secrets
- dependency changes
# Final result
Before finishing:
- inspect the complete diff
- remove temporary debugging
- summarize files changed
- report tests executed
- report anything not verified
Create a pull request
when the implementation
is ready for review.Guías relacionadas
Documentación de Copilot Cloud Agent
About Cloud Agent
Capacidades, seguridad, límites y funcionamiento.
Ver documentación →Start Agent Sessions
GitHub, Issues, IDE, CLI, MCP e integraciones.
Ver sesiones →Best Practices
Scope, instrucciones, MCP y setup.
Ver buenas prácticas →Risks and Mitigations
Seguridad, branches, secrets, PR y workflows.
Ver seguridad →FAQ sobre GitHub Copilot Cloud Agent
GitHub Copilot Cloud Agent es un agente remoto de desarrollo que puede investigar, planificar, modificar código, ejecutar verificaciones y trabajar en segundo plano sobre un repositorio alojado en GitHub.
Sí. Copilot Coding Agent fue renombrado por GitHub como Copilot Cloud Agent. El nuevo nombre refleja un alcance más amplio de investigación, planificación y desarrollo remoto.
Agent Mode se utiliza principalmente para desarrollo interactivo dentro del IDE o entorno local. Cloud Agent trabaja remotamente en GitHub y puede continuar en segundo plano.
No necesariamente. El flujo actual permite que Copilot investigue, planifique y trabaje sobre una rama antes de crear un Pull Request. También puedes pedir expresamente un PR desde el inicio.
Sí. Puedes asignar un Issue a Copilot para que utilice su título, descripción, comentarios existentes e instrucciones adicionales como contexto de la tarea.
Cloud Agent trabaja dentro de un entorno de desarrollo efímero y remoto basado en infraestructura de GitHub Actions.
Es un workflow especial que permite preparar el entorno de Cloud Agent, por ejemplo instalando runtimes, dependencias y herramientas antes de que el agente comience su tarea.
Sí, pero el acceso está limitado por un firewall por defecto. La organización o repositorio puede controlar la configuración y allowlists correspondientes.
No automáticamente. GitHub dispone de Agents secrets y variables específicos para Copilot. Los secretos de Actions, Codespaces o Dependabot no se entregan automáticamente al agente.
Sí. Puedes configurar servidores MCP para proporcionar herramientas y contexto adicional al Cloud Agent, sujeto a permisos y políticas del repositorio.
Sí. Agent Skills permiten proporcionar instrucciones, scripts y recursos especializados que Copilot puede cargar cuando resultan relevantes para una tarea.
Sí. Puedes crear perfiles de agentes especializados y seleccionarlos al iniciar determinadas tareas o asignar un Issue.
La documentación actual establece un máximo de 59 minutos de ejecución por sesión. Las tareas demasiado grandes deberían dividirse en unidades más pequeñas.
No dentro de una misma tarea. Cloud Agent solo puede realizar cambios en el repositorio seleccionado al iniciar esa sesión.
No. Los Pull Requests creados por Cloud Agent requieren revisión humana. El agente no puede aprobar ni fusionar su propio Pull Request.
Sí. Puede trabajar sobre plugins y themes, analizar PHP, WooCommerce, MySQL, REST API, AJAX y JavaScript, siempre que el repositorio y entorno permitan reproducir y verificar la tarea.
GitHub Copilot precio: planes, AI Credits y límites
Ahora que conoces las principales superficies de GitHub Copilot, el siguiente paso es entender cuánto cuesta utilizarlo, qué incluye cada plan y cómo funcionan los AI Credits, modelos, Agent Mode, Cloud Agent, Code Review y el consumo de GitHub Actions.
Ver precios de GitHub Copilot →