{"meta":{"title":"Referencia de comandos de la CLI de GitHub Copilot","intro":"Busque comandos y métodos abreviados de teclado para ayudarle a usar CLI de Copilot de forma eficaz.","product":"GitHub Copilot","breadcrumbs":[{"href":"/es/copilot","title":"GitHub Copilot"},{"href":"/es/copilot/reference","title":"Referencia"},{"href":"/es/copilot/reference/copilot-cli-reference","title":"Referencia CLI de Copilot"},{"href":"/es/copilot/reference/copilot-cli-reference/cli-command-reference","title":"Referencia de los comandos CLI"}],"documentType":"article"},"body":"# Referencia de comandos de la CLI de GitHub Copilot\n\nBusque comandos y métodos abreviados de teclado para ayudarle a usar CLI de Copilot de forma eficaz.\n\n## Comandos de la línea de comandos\n\n| Comando | propósito |\n| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `copilot` | Inicie la interfaz de usuario interactiva. |\n| `copilot help [TOPIC]` | Mostrar información de ayuda. Los temas de ayuda incluyen: `config`, `commands`, `environment`, `logging`, `monitoring`, `permissions`y `providers`. |\n| `copilot init` | Inicialice instrucciones personalizadas de Copilot para este repositorio. |\n| `copilot login` | Autentíquese con Copilot a través del flujo del dispositivo OAuth. |\n\n```\n `--host HOST` Acepta para especificar la dirección URL del GitHub host (valor predeterminado: `https://github.com`). |\n```\n\n\\| `copilot login` \\[OPCIÓN] | Autentíquese con Copilot a través del flujo del dispositivo OAuth. Consulte [`copilot login` las opciones](#copilot-login-options). |\n\\| `copilot mcp` | Administre las configuraciones del servidor MCP desde la línea de comandos. |\n\\| `copilot plugin` | Administrar complementos y mercados de complementos. |\n\\| `copilot update` | Descargue e instale la versión más reciente. |\n\\| `copilot version` | Mostrar información de versión y comprobar si hay actualizaciones. |\n\n###\n\n```\n `copilot login` opciones\n```\n\n| Opción | propósito |\n| ------------- | --------- |\n| `--host HOST` | |\n\n```\n GitHub dirección URL de host (valor predeterminado: `https://github.com`). Úselo para autenticarse con una GitHub Enterprise Cloud instancia que use la residencia de datos (por ejemplo, `https://example.ghe.com`). |\n```\n\n\\| `--config-dir PATH` | Establezca el directorio de configuración (valor predeterminado: `~/.copilot`). |\n\nEl modo de autenticación predeterminado es un flujo de explorador basado en web. Después de la finalización, un token de autenticación se almacena de forma segura en el almacén de credenciales del sistema. Si no se encuentra un almacén de credenciales, el token se almacena en un archivo de configuración de texto sin formato en `~/.copilot/`.\n\nComo alternativa, CLI de Copilot usará un token de autenticación que se encuentra en variables de entorno. A continuación se comprueban en orden de prioridad: `COPILOT_GITHUB_TOKEN`, `GH_TOKEN`, `GITHUB_TOKEN`. Este método es más adecuado para su uso sin interfaz gráfica, como en la automatización.\n\nLos tipos de tokens admitidos incluyen fine-grained personal access tokens (v2 PAT) con el permiso \"Solicitudes de Copilot\", tokens de OAuth de la aplicación CLI Copilot, y tokens de OAuth de la aplicación GitHub CLI (`gh`). No se admiten los clásicos personal access tokens (`ghp_`).\n\n```\n **Ejemplos:**\n```\n\n```shell\n# Authenticate with github.com\ncopilot login\n\n# Authenticate with GitHub Enterprise Cloud (data residency)\ncopilot login --host https://example.ghe.com\n\n# Use a fine-grained PAT via environment variable\nCOPILOT_GITHUB_TOKEN=github_pat_... copilot\n```\n\n## Accesos directos globales en la interfaz interactiva\n\n| Shortcut | propósito |\n| ------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `@ FILENAME` | Incluya el contenido del archivo en el contexto. |\n| `# NUMBER` | Incluya un problema o una GitHub solicitud de incorporación de cambios en el contexto. |\n| `! COMMAND` | Ejecute un comando en su shell local, omitiendo Copilot. |\n| `?` | Abrir ayuda rápida (en un indicador vacío). |\n| Esc | Cancele la operación actual. |\n| Ctrl+C | Cancelar operación/borrar entrada. Presione dos veces para salir. |\n| Ctrl+D | Apagado. |\n| Ctrl+G | Edite la instrucción en un editor externo (`$EDITOR`). |\n| Ctrl+L | Borre la pantalla. |\n| Ctrl+Escriba o Ctrl+Q. | Poner en cola un mensaje para enviar mientras el agente está ocupado. |\n| Ctrl+R | Búsqueda inversa a través del historial de comandos. |\n| Ctrl+V | Pegue desde el Portapapeles como archivo adjunto. |\n| Ctrl+X después `/` | Después de empezar a escribir un mensaje, esto le permite ejecutar un comando de barra, por ejemplo, si desea cambiar el modelo sin tener que volver a escribir el mensaje. |\n| Ctrl+X después `e` | Editar el indicador en un editor externo (`$EDITOR`). |\n| Ctrl+X después `o` | Abra el vínculo más reciente de la línea de tiempo. |\n| Ctrl+Z | Suspenda el proceso en segundo plano (Unix). |\n| Mayús+Intro o Opción+Intro (Mac) / Alt+Intro (Windows/Linux) | Inserte una nueva línea en la entrada. |\n| Mayús+Tabulador | Ciclo entre el modo estándar, plan y Autopilot. |\n\n## Accesos directos de escala de tiempo en la interfaz interactiva\n\n| Shortcut | propósito |\n| ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Ctrl+O | Si bien no hay nada en la entrada de la solicitud, expande los elementos recientes en la línea de tiempo de respuesta de Copilot para mostrar más detalles. |\n| Ctrl+E | Si bien no hay nada en la entrada del mensaje, expande todos los elementos en la línea de tiempo de respuesta de Copilot. |\n| Ctrl+T | Expandir o contraer la visualización del razonamiento en las respuestas. |\n| Subir/ páginaPágina abajo | Desplazar la línea de tiempo hacia arriba o hacia abajo en una página. |\n\n## Accesos directos de navegación en la interfaz interactiva\n\n| Shortcut | propósito |\n| ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------- |\n| Ctrl+A | Ir al principio de la línea (al escribir). |\n| Ctrl+B | Vaya al carácter anterior. |\n| Ctrl+E | Vaya al final de la línea (al escribir). |\n| Ctrl+F | Vaya al siguiente carácter. |\n| Ctrl+H | Elimine el carácter anterior. |\n| Ctrl+K | Eliminar desde el cursor hasta el final de la línea. Si el cursor está al final de la línea, elimine el salto de línea. |\n| Ctrl+U | Eliminar desde el cursor hasta el principio de la línea. |\n| Ctrl+W | Elimine la palabra anterior. |\n| Página principal | Vaya al principio del texto. |\n| Fin | Vaya al final del texto. |\n| Alt+/←→ (Windows/Linux)
| |\n\n```\n Opción+←/→ (Mac) | Mueva el cursor una palabra a la vez. |\n```\n\n\\| ↑/↓ | Navegue por el historial de comandos. |\n\n## Comandos de barra en la interfaz interactiva\n\n| Comando | propósito |\n| ------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `/add-dir PATH` | Agregue un directorio a la lista de permitidos para el acceso a archivos. |\n| `/agent` | Examine y seleccione entre los agentes disponibles (si los hay). Consulte [Acerca de los agentes personalizados](/es/copilot/concepts/agents/copilot-cli/about-custom-agents). |\n| `/ask QUESTION` | Haga una pregunta rápida sin agregar al historial de conversación. Solo está disponible en modo experimental. |\n| `/allow-all [on\\|off\\|show]`, `/yolo [on\\|off\\|show]` | Habilite todos los permisos (herramientas, rutas de acceso y direcciones URL). |\n| `/changelog [summarize] [VERSION\\|last N\\|since VERSION]`, `/release-notes [summarize] [VERSION\\|last N\\|since VERSION]` | Muestra el registro de cambios de la CLI. Opcionalmente, especifique una versión, un recuento de versiones recientes o una versión inicial. Agregue la palabra clave `summarize` para un resumen generado por IA. |\n| `/chronicle ` | Herramientas de análisis del historial de sesiones. Solo está disponible en modo experimental. |\n| `/clear [PROMPT]`, , `/new [PROMPT]`, `/reset [PROMPT]` | Inicie una nueva conversación. |\n| `/compact` | Resumir el historial de conversaciones para reducir el uso de la ventana de contexto. Consulte [Administración del contexto en CLI de GitHub Copilot](/es/copilot/concepts/agents/copilot-cli/context-management#compaction). |\n| `/context` | Muestra el uso y la visualización del token de la ventana de contexto. Consulte [Administración del contexto en CLI de GitHub Copilot](/es/copilot/concepts/agents/copilot-cli/context-management#checking-your-context-usage). |\n| `/copy` | Copie la última respuesta en el Portapapeles. |\n| `/cwd`, `/cd [PATH]` | Cambie el directorio de trabajo o muestre el directorio actual. |\n| `/delegate [PROMPT]` | Delegar cambios en un repositorio remoto con una solicitud de incorporación de cambios generada por IA. Consulte [Delegación de tareas a CLI de GitHub Copilot](/es/copilot/how-tos/copilot-cli/use-copilot-cli-agents/delegate-tasks-to-cca). |\n| `/diff` | Revise los cambios realizados en el directorio actual. |\n| `/env` | Mostrar los detalles del entorno cargados (instrucciones, servidores MCP, aptitudes, agentes, complementos, LSP, extensiones). |\n| `/exit`, `/quit` | Salir de la CLI. |\n| `/experimental [on\\|off\\|show]` | Alternar, establecer o mostrar funciones experimentales. |\n| `/feedback`, `/bug` | Proporcione comentarios sobre la CLI. |\n| `/fleet [PROMPT]` | Habilite la ejecución paralela de subagentes de partes de una tarea. Consulte [Ejecución de tareas en paralelo con el \\`/fleet\\` comando](/es/copilot/concepts/agents/copilot-cli/fleet). |\n| `/help` | Mostrar la ayuda para comandos interactivos. |\n| `/ide` | Conéctese a un área de trabajo del IDE. Consulte [CLI de GitHub Copilot Conexión aVS Code](/es/copilot/how-tos/copilot-cli/connecting-vs-code#managing-the-connection-with-the-ide-slash-command). |\n| `/init` | Inicialice instrucciones personalizadas y características de agente de Copilot para este repositorio. Vea [Inicialización del proyecto para Copilot](#project-initialization-for-copilot). |\n| `/instructions` | Ver y activar o desactivar archivos de instrucciones personalizadas. |\n| `/keep-alive [on\\|busy\\|NUMBERm\\|NUMBERh]` | Impedir que la máquina se ponga en suspensión: mientras una sesión de la línea de comandos está activa, mientras el agente está ocupado o durante un período de tiempo definido. Solo está disponible en modo experimental. |\n| `/list-dirs` | Muestra todos los directorios para los que se ha permitido el acceso a archivos. |\n| `/login` | Inicie sesión en Copilot. |\n| `/logout` | Cierre sesión en Copilot. |\n| `/lsp [show\\|test\\|reload\\|help] [SERVER-NAME]` | Administrar la configuración del servidor de idioma. |\n| `/mcp [show\\|add\\|edit\\|delete\\|disable\\|enable\\|auth\\|reload] [SERVER-NAME]` | Administrar la configuración del servidor MCP. Consulte [Adición de servidores MCP para CLI de GitHub Copilot](/es/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers#managing-mcp-servers). |\n| `/model`, `/models [MODEL]` | Seleccione el modelo de IA que desea usar. |\n| `/plan [PROMPT]` | Cree un plan de implementación antes de codificar. |\n| `/plugin [marketplace\\|install\\|uninstall\\|update\\|list] [ARGS...]` | Administrar complementos y mercados de complementos. Consulte [Acerca de los complementos para CLI de GitHub Copilot](/es/copilot/concepts/agents/copilot-cli/about-cli-plugins). |\n| `/pr [view\\|create\\|fix\\|auto]` | Administrar solicitudes de incorporación de cambios para la rama actual. Consulte [Gestión de pull requests con el comando /pr](/es/copilot/how-tos/copilot-cli/manage-pull-requests). |\n| `/remote` | Habilite el acceso remoto a esta sesión desde GitHub.com y GitHub Mobile. Consulte [Controlar una CLI de GitHub Copilot sesión desde otro dispositivo](/es/copilot/how-tos/copilot-cli/steer-remotely). |\n| `/rename [NAME]` | Cambie el nombre de la sesión actual (genera automáticamente un nombre si se omite; alias para `/session rename`). |\n| `/research TOPIC` | Realice una investigación profunda utilizando GitHub fuentes de búsqueda y web. Consulte [Investigación con CLI de GitHub Copilot](/es/copilot/concepts/agents/copilot-cli/research). |\n| `/reset-allowed-tools` | Restablezca la lista de herramientas permitidas. |\n| `/restart` | Reinicie la CLI, conservando la sesión actual. |\n| `/resume [SESSION-ID]`, `/continue [SESSION-ID]` | Cambie a otra sesión eligiendo entre una lista (opcionalmente, especifique un identificador de sesión). |\n| `/review [PROMPT]` | Ejecute el agente de revisión de código para analizar los cambios. Consulte [Solicitud de una revisión de código con CLI de GitHub Copilot](/es/copilot/how-tos/copilot-cli/use-copilot-cli-agents/agentic-code-review). |\n| `/session [checkpoints [n]\\|files\\|plan\\|rename NAME]`, `/sessions [checkpoints [n]\\|files\\|plan\\|rename NAME]` | Mostrar información de sesión y un resumen del área de trabajo. Use los subcomandos para obtener más información. |\n| `/share [file\\|html\\|gist] [session\\|research] [PATH]`, `/export [file\\|html\\|gist] [session\\|research] [PATH]` | Comparta la sesión en un archivo Markdown, un archivo HTML interactivo o un gist GitHub. |\n| `/skills [list\\|info\\|add\\|remove\\|reload] [ARGS...]` | Gestionar habilidades para capacidades mejoradas. Consulte [Adición de habilidades de agente para CLI de GitHub Copilot](/es/copilot/how-tos/copilot-cli/customize-copilot/create-skills). |\n| `/statusline`, `/footer` | Configure los elementos que aparecen en la línea de estado. |\n| `/tasks` | Ver y administrar tareas en segundo plano (subagentes y sesiones de shell). |\n| `/terminal-setup` | Configure el terminal para la compatibilidad con la entrada multilínea (Mayús+Entrar y Ctrl+Entrar). |\n| `/theme [default\\|dim\\|high-contrast\\|colorblind]` | Ver o establecer el modo de color. |\n| `/undo`, `/rewind` | Rebobinar el último turno y revertir los cambios de archivo. |\n| `/update`, `/upgrade` | Actualice la CLI a la versión más reciente. |\n| `/usage` | Muestra las estadísticas y métricas de uso de la sesión. |\n| `/user [show\\|list\\|switch]` | Administrar al usuario actual GitHub. |\n| `/version` | Mostrar información de versión y comprobar si hay actualizaciones. |\n\nPara obtener una lista completa de los comandos de barra diagonal disponibles, escriba `/help` en la interfaz interactiva de la CLI.\n\n## Opciones de la línea de comandos\n\n| Opción | propósito |\n| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `--add-dir=PATH` | Agregue un directorio a la lista de permitidos para el acceso a archivos (se puede usar varias veces). |\n| `--add-github-mcp-tool=TOOL` | Agregue una herramienta para habilitar para el GitHub servidor MCP, en lugar del subconjunto predeterminado de la CLI (se puede usar varias veces). Utilice `*` para todas las herramientas. |\n| `--add-github-mcp-toolset=TOOLSET` | Agregue un conjunto de herramientas para habilitar para el GitHub servidor MCP, en lugar del subconjunto predeterminado de la CLI (se puede usar varias veces). Use `all` para todos los conjuntos de herramientas. |\n| `--additional-mcp-config=JSON` | Agregue un servidor MCP solo para esta sesión. La configuración del servidor se puede proporcionar como una cadena JSON o una ruta de acceso de archivo (prefijo con `@`). Amplía la configuración de `~/.copilot/mcp-config.json`. Invalida cualquier configuración de servidor MCP instalada con el mismo nombre. Consulte [Adición de servidores MCP para CLI de GitHub Copilot](/es/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers). |\n| `--agent=AGENT` | Especifique un agente personalizado que se va a usar. Consulte [Acerca de los agentes personalizados](/es/copilot/concepts/agents/copilot-cli/about-custom-agents). |\n| `--allow-all` | Habilite todos los permisos (equivalentes a `--allow-all-tools --allow-all-paths --allow-all-urls`). |\n| `--allow-all-paths` | Deshabilite la comprobación de la ruta de acceso del archivo y permita el acceso a cualquier ruta de acceso. |\n| `--allow-all-tools` | Permitir que todas las herramientas se ejecuten automáticamente sin confirmación. Necesario cuando se usa la CLI mediante programación (env: `COPILOT_ALLOW_ALL`). |\n| `--allow-all-urls` | Permitir el acceso a todas las direcciones URL sin confirmación. |\n| `--allow-tool=TOOL ...` | Herramientas que la CLI tiene permiso para usar. No solicitará permiso. Para varias herramientas, use una lista entrecomillada y separada por comas. Consulte [Permitir y denegar el uso de la herramienta](/es/copilot/how-tos/copilot-cli/allowing-tools#allowing-or-denying-permission-for-specific-tools). |\n| `--allow-url=URL ...` | Permitir el acceso a direcciones URL o dominios específicos. Para varias direcciones URL, use una lista entrecomillada y separada por comas. |\n| `--autopilot` | Habilite la continuación del piloto automático en modo aviso. Consulte [Permitir que la CLI de GitHub Copilot funcione de forma autónoma](/es/copilot/concepts/agents/copilot-cli/autopilot). |\n| `--available-tools=TOOL ...` | Solo estas herramientas estarán disponibles para el modelo. Para varias herramientas, use una lista entrecomillada y separada por comas. Consulte [Permitir y denegar el uso de la herramienta](/es/copilot/how-tos/copilot-cli/allowing-tools). |\n| `--banner`, `--no-banner` | Mostrar u ocultar el banner de inicio. |\n| `--bash-env` | Habilitar la `BASH_ENV` compatibilidad con las shells Bash. |\n| `--config-dir=PATH` | Establezca el directorio de configuración (valor predeterminado: `~/.copilot`). |\n| `--connect[=SESSION-ID]` | Conéctese directamente a una sesión remota (opcionalmente, especifique un identificador de sesión o un identificador de tarea). Entra en conflicto con `--resume` y `--continue`. |\n| `--continue` | Reanude la sesión más reciente. |\n| `--deny-tool=TOOL ...` | Herramientas que la CLI no tiene permiso para usar. No solicitará permiso. Para varias herramientas, use una lista entrecomillada y separada por comas. |\n| `--deny-url=URL ...` | Denegar el acceso a direcciones URL o dominios específicos tiene prioridad sobre `--allow-url`. Para varias direcciones URL, use una lista entrecomillada y separada por comas. |\n| `--disable-builtin-mcps` | Deshabilite todos los servidores MCP integrados (actualmente: `github-mcp-server`). |\n| `--disable-mcp-server=SERVER-NAME` | Deshabilite un servidor MCP específico (se puede usar varias veces). |\n| `--disallow-temp-dir` | Impedir el acceso automático al directorio temporal del sistema. |\n| `--effort=LEVEL`, `--reasoning-effort=LEVEL` | Establezca el nivel de esfuerzo de razonamiento (`low`, `medium`, `high`). |\n| `--enable-all-github-mcp-tools` | Habilite todas las GitHub herramientas del servidor MCP, en lugar del subconjunto predeterminado de la CLI. Invalida las opciones `--add-github-mcp-toolset` y `--add-github-mcp-tool`. |\n| `--enable-reasoning-summaries` | Solicite resúmenes de razonamiento para modelos openAI que lo admitan. |\n| `--excluded-tools=TOOL ...` | Estas herramientas no estarán disponibles para el modelo. Para varias herramientas, use una lista entrecomillada y separada por comas. |\n| `--experimental` | Habilite las características experimentales (use `--no-experimental` para deshabilitar). |\n| `-h`, `--help` | Mostrar ayuda. |\n| `-i PROMPT`, `--interactive=PROMPT` | Inicie una sesión interactiva y ejecute automáticamente esta solicitud. |\n| `--log-dir=DIRECTORY` | Establezca el directorio del archivo de registro (valor predeterminado: `~/.copilot/logs/`). |\n| `--log-level=LEVEL` | Configure el nivel de registro (opciones: `none`, `error`, `warning`, `info`, `debug`, `all`, `default`). |\n| `--max-autopilot-continues=COUNT` | Número máximo de mensajes de continuación en el modo autopilot (valor predeterminado: ilimitado). Consulte [Permitir que la CLI de GitHub Copilot funcione de forma autónoma](/es/copilot/concepts/agents/copilot-cli/autopilot). |\n| `--mode=MODE` | Establezca el modo de agente inicial (opciones: `interactive`, `plan`, `autopilot`). No se puede combinar con `--autopilot` o `--plan`. |\n| `--model=MODEL` | Establezca el modelo de IA que desea usar. Pase `auto` para permitir que Copilot seleccione automáticamente el mejor modelo disponible. |\n| `--mouse[=VALUE]` | Habilite la compatibilidad con el mouse en el modo de pantalla alternativo. VALUE puede ser `on` (valor predeterminado) o `off`. Cuando está habilitada, la CLI captura los eventos del mouse en el modo de pantalla alt: rueda de desplazamiento, clics, etc. Cuando está deshabilitado, se conserva el comportamiento nativo del mouse del terminal. Una vez establecida la configuración, se conserva escribiéndola en su archivo de configuración. |\n| `--no-ask-user` | Deshabilite la `ask_user` herramienta (el agente funciona de forma autónoma sin formular preguntas). |\n| `--no-auto-update` | Deshabilite la descarga automática de actualizaciones de la CLI. |\n| `--no-bash-env` | Deshabilite la compatibilidad de `BASH_ENV` con los shells de Bash. |\n| `--no-color` | Deshabilite toda la salida de color. |\n| `--no-custom-instructions` | Deshabilite la carga de instrucciones personalizadas desde `AGENTS.md` y archivos relacionados. |\n| `--no-experimental` | Desactivar las funciones experimentales. |\n| `--no-mouse` | Desactive el soporte para el ratón. |\n| `--no-remote` | Deshabilite el acceso remoto para esta sesión. |\n| `--output-format=FORMAT` | FORMAT puede ser `text` (valor predeterminado) o `json` (genera JSONL: un objeto JSON por línea). |\n| `-p PROMPT`, `--prompt=PROMPT` | Ejecute un comando programáticamente (se cierra al finalizar). Consulte [Ejecución CLI de GitHub Copilot de forma programática](/es/copilot/how-tos/copilot-cli/automate-copilot-cli/run-cli-programmatically). |\n| `--plan` | Iniciar en modo de planificación. Abreviatura de `--mode plan`. No se puede combinar con `--mode` o `--autopilot`. |\n| `--plain-diff` | Deshabilitar la representación de diferencias enriquecidas (resaltado de sintaxis mediante la herramienta de diferencias especificada por la configuración de Git). |\n| `--plugin-dir=DIRECTORY` | Cargue un complemento desde un directorio local (se puede usar varias veces). |\n| `--remote` | Habilite el acceso remoto a esta sesión desde GitHub.com y GitHub Mobile. Consulte [Controlar una CLI de GitHub Copilot sesión desde otro dispositivo](/es/copilot/how-tos/copilot-cli/steer-remotely). |\n| `--resume=SESSION-ID` | Reanude una sesión interactiva anterior eligiendo entre una lista (opcionalmente, especifique un identificador de sesión o un prefijo único de 7 caracteres hexadecimales). |\n| `-s`, `--silent` | Genera solo la respuesta del agente (sin estadísticas de uso), útil para el scripting con `-p`. |\n| `--screen-reader` | Habilite las optimizaciones del lector de pantalla. |\n| `--secret-env-vars=VAR ...` | Redacte una variable de entorno desde entornos de servidor de shell y MCP (se pueden usar varias veces). Para varias variables, use una lista entrecomillada y separada por comas. Los valores de las variables de entorno `GITHUB_TOKEN` y `COPILOT_GITHUB_TOKEN` se eliminan de la salida de manera predeterminada. |\n| `--share=PATH` | Comparta una sesión en un archivo Markdown después de completar una sesión programática (ruta de acceso predeterminada: `./copilot-session-.md`). |\n| `--share-gist` | Comparta una sesión con un gist GitHub de secreto después de la finalización de una sesión mediante programación. |\n| `--stream=MODE` | Habilite o deshabilite el modo de streaming (opciones de modo: `on` o `off`). |\n| `-v`, `--version` | Mostrar información de versión. |\n| `--yolo` | Habilite todos los permisos (equivalentes a `--allow-all`). |\n\nPara obtener una lista completa de comandos y opciones, ejecute `copilot help`.\n\n> \\[!NOTE]\n> Las opciones `--remote`, `--no-remote` y `--connect` requieren que la característica de sesiones remotas esté disponible en su cuenta.\n\n## Valores de disponibilidad de herramientas\n\nLas `--available-tools` opciones y `--excluded-tools` admiten estos valores:\n\n### Herramientas de Shell\n\n| Nombre de la herramienta | Descripción |\n| --------------------------------- | ------------------------------------------- |\n| `bash` / `powershell` | Ejecutar comandos |\n| `read_bash` / `read_powershell` | Lectura de la salida de una sesión de shell |\n| `write_bash` / `write_powershell` | Enviar entrada a una sesión de shell |\n| `stop_bash` / `stop_powershell` | Finalizar una sesión de shell |\n| `list_bash` / `list_powershell` | Enumerar sesiones de shell activas |\n\n### Herramientas de operación de archivos\n\n| Nombre de la herramienta | Descripción |\n| ------------------------ | -------------------------------------------------------------------------- |\n| `view` | Leer archivos o directorios |\n| `create` | Crear nuevos archivos |\n| `edit` | Edición de archivos mediante reemplazo de cadenas |\n| `apply_patch` | Aplicar parches (que algunos modelos utilizan en lugar de `edit`/`create`) |\n\n### Herramientas de delegación de agentes y tareas\n\n| Nombre de la herramienta | Descripción |\n| ------------------------ | ----------------------------------------------- |\n| `task` | Ejecutar subagentes |\n| `read_agent` | Comprobar el estado del agente en segundo plano |\n| `list_agents` | Enumerar agentes disponibles |\n\n### Otras herramientas\n\n| Nombre de la herramienta | Descripción |\n| ------------------------ | ------------------------------------------- |\n| `grep` (o `rg`) | Buscar texto en archivos |\n| `glob` | Buscar patrones de coincidencia de archivos |\n| `web_fetch` | Capturar y analizar contenido web |\n| `skill` | Invocación de aptitudes personalizadas |\n| `ask_user` | Formular una pregunta al usuario |\n\n## Patrones de permisos de herramientas\n\nLas `--allow-tool` opciones y `--deny-tool` aceptan patrones de permisos con el formato `Kind(argument)`. El argumento es opcional: si se omite, coincide con todas las herramientas de ese tipo.\n\n| Kind | Descripción | Patrones de ejemplo |\n| ------- | ------------------------------ | ------------------- |\n| `shell` | Ejecución de comandos de Shell | |\n\n```\n `shell(git push)`, , `shell(git:*)`, `shell` |\n```\n\n\\| `write` | Creación o modificación de archivos |\n`write`, `write(src/*.ts)` |\n\\| `read` | Lecturas de archivos o directorios |\n`read`, `read(.env)` |\n\\| SERVER-NAME | Invocación de la herramienta de servidor MCP |\n`MyMCP(create_issue)`, `MyMCP` |\n\\| `url` | Acceso a la URL a través de web-fetch o shell |\n`url(github.com)`, `url(https://*.api.com)` |\n\\| `memory` | Almacenamiento de hechos en la memoria del agente | `memory` |\n\nPara las reglas de `shell`, el sufijo `:*` coincide con la raíz del comando seguido de un espacio, evitando coincidencias parciales. Por ejemplo, `shell(git:*)` coincide con `git push` y `git pull`, pero no coincide con `gitea`.\n\nLas reglas de denegación siempre tienen prioridad sobre las reglas de autorización, incluso cuando `--allow-all` está configurado.\n\n```shell\n# Allow all git commands except git push\ncopilot --allow-tool='shell(git:*)' --deny-tool='shell(git push)'\n\n# Allow a specific MCP server tool\ncopilot --allow-tool='MyMCP(create_issue)'\n\n# Allow all tools from a server\ncopilot --allow-tool='MyMCP'\n```\n\n## Variables de entorno\n\n| Variable | Descripción |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `COPILOT_MODEL` | Establezca el modelo de IA. |\n| `COPILOT_ALLOW_ALL` | Establézcalo en `true` para permitir todos los permisos automáticamente (equivalente a `--allow-all`). |\n| `COPILOT_AUTO_UPDATE` | Establézcalo en `false` para deshabilitar las actualizaciones automáticas. |\n| `COPILOT_CUSTOM_INSTRUCTIONS_DIRS` | Lista separada por comas de directorios adicionales para obtener instrucciones personalizadas. |\n| `COPILOT_SKILLS_DIRS` | Lista de directorios adicionales separada por comas para habilidades. |\n| `COPILOT_EDITOR` | Comando del editor para la edición interactiva (activada después de `$VISUAL` y `$EDITOR`). El valor predeterminado es `vi` si no se establece ninguno. |\n| `COPILOT_GITHUB_TOKEN` | Token de autenticación. Tiene prioridad sobre `GH_TOKEN` y `GITHUB_TOKEN`. |\n| `COPILOT_HOME` | Invalide la configuración y el directorio de estado. Predeterminado: `$HOME/.copilot`. |\n| `COPILOT_CACHE_HOME` | Invalide el directorio de caché (que se usa para cachés de Marketplace, paquetes de actualización automática y otros datos efímeros). Consulte [directorio de configuración de la CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-config-dir-reference#changing-the-location-of-the-configuration-directory) para conocer los valores predeterminados de la plataforma. |\n| `COPILOT_SUBAGENT_MAX_DEPTH` | Profundidad máxima de anidamiento de subagentes. Predeterminado: `6`. Intervalo: `1`–`256`. |\n| `COPILOT_SUBAGENT_MAX_CONCURRENT` | Máximo de subagentes concurrentes en todo el árbol de sesiones. Predeterminado: `32`. Intervalo: `1`–`256`. |\n| `GH_TOKEN` | Token de autenticación. Tiene prioridad sobre `GITHUB_TOKEN`. |\n| `GITHUB_TOKEN` | Token de autenticación. |\n| `USE_BUILTIN_RIPGREP` | Establézcalo en `false` para usar el ripgrep del sistema en lugar de la versión incluida. |\n| `PLAIN_DIFF` | Establézcalo en `true` para deshabilitar la representación de diferencias enriquecidas. |\n| `COLORFGBG` | Solución alternativa para la detección de fondo oscuro/claro del terminal. |\n\n## Configuración del archivo de configuración\n\nLa configuración pasa de usuario a repositorio a local, con ámbitos más específicos que reemplazan a más generales. Las marcas de línea de comandos y las variables de entorno siempre tienen la prioridad más alta.\n\n| Ámbito | Ubicación | propósito |\n| ----------- | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Usuario | `~/.copilot/config.json` | Valores predeterminados globales para todos los repositorios. Use la variable de `COPILOT_HOME` entorno para especificar una ruta de acceso alternativa. |\n| Repositorio | `.github/copilot/settings.json` | Configuración del repositorio compartido (registrada en el repositorio). |\n| Local | `.github/copilot/settings.local.json` | Excepciones personales (agregue esto a `.gitignore`). |\n\n### Configuración del usuario (`~/.copilot/config.json`)\n\n| Key | Tipo | Predeterminado | Descripción |\n| ------------- | ---------- | -------------- | -------------------------------------------------------- |\n| `allowedUrls` | `string[]` | `[]` | Direcciones URL o dominios permitidos sin preguntar. |\n| `autoUpdate` | `boolean` | `true` | Descargue automáticamente las actualizaciones de la CLI. |\n| `banner` | | | |\n\n```\n `\"always\"`\n \\|\n `\"once\"`\n \\|\n `\"never\"`\n | `\"once\"` | Frecuencia de visualización de banner animado. |\n```\n\n\\| `bashEnv` | `boolean` | `false` | Habilitar la `BASH_ENV` compatibilidad con las shells Bash. |\n\\| `beep` | `boolean` | `true` | Reproduce un pitido audible cuando se requiere atención. |\n\\| `compactPaste` | `boolean` | `true` | Contraiga grandes elementos en tokens compactos. |\n\\| `custom_agents.default_local_only` | `boolean` | `false` | Use solo agentes personalizados locales. |\n\\| `denied_urls` | `string[]` | `[]` | Direcciones URL o dominios bloqueados (tiene prioridad sobre `allowed_urls`). |\n\\| `experimental` | `boolean` | `false` | Habilite las características experimentales. |\n\\| `includeCoAuthoredBy` | `boolean` | `true` | Agregue un finalizador `Co-authored-by` a las confirmaciones de Git realizadas por el agente. |\n\\| `companyAnnouncements` | `string[]` | `[]` | Mensajes personalizados mostrados aleatoriamente durante el inicio. |\n\\| `logLevel` |\n`\"none\"`\n|\n`\"error\"`\n|\n`\"warning\"`\n|\n`\"info\"`\n|\n`\"debug\"`\n|\n`\"all\"`\n|\n`\"default\"`\n\\| `\"default\"` | Nivel de detalle de registro. |\n\\| `model` | `string` | Varía | Modelo de IA que se va a usar (consulte el `/model` comando ). Establézcalo en `\"auto\"` para permitir seleccionar Copilot automáticamente el mejor modelo disponible. |\n\\| `powershellFlags` | `string[]` | `[\"-NoProfile\", \"-NoLogo\"]` | Marcas pasadas a PowerShell (`pwsh`) en el inicio. Solo para Windows. |\n\\| `effortLevel` | `string` | `\"medium\"` | Nivel de esfuerzo de razonamiento para el pensamiento extendido (por ejemplo, `\"low\"`, `\"medium\"`, `\"high\"`, `\"xhigh\"`). Los niveles superiores usan más recursos de computación. |\n\\| `mergeStrategy` |\n`\"rebase\"`\n|\n`\"merge\"`\n\\| — | Estrategia de resolución de conflictos para `/pr fix conflicts`. Cuando se establece en `\"rebase\"`, los conflictos se resuelven rebasando sobre la rama base. Cuando se establece en `\"merge\"`, la rama base se combina en la rama de características. Si no está configurado, se muestra un cuadro de diálogo del selector. |\n\\| `renderMarkdown` | `boolean` | `true` | Representar Markdown en la salida del terminal. |\n\\| `screenReader` | `boolean` | `false` | Habilite las optimizaciones del lector de pantalla. |\n\\| `stream` | `boolean` | `true` | Habilite las respuestas de streaming. |\n\\| `storeTokenPlaintext` | `boolean` | `false` | Almacene tokens de autenticación en texto sin formato en el archivo de configuración cuando no haya ninguna cadena de claves del sistema disponible. |\n\\| `streamerMode` | `boolean` | `false` | Ocultar los nombres de modelo de vista previa y los detalles de cuota (útiles al mostrar CLI de Copilot). |\n\\| `theme` |\n`\"auto\"`\n|\n`\"dark\"`\n|\n`\"light\"`\n\\| `\"auto\"` | Tema de color de terminal. |\n\\| `mouse` | `boolean` | `true` | Habilite la compatibilidad con el mouse en el modo de pantalla alternativo. |\n\\| `respectGitignore` | `boolean` | `true` | Excluya los archivos gitignored del `@` selector de archivos. |\n\\| `disableAllHooks` | `boolean` | `false` | Deshabilite todos los ganchos. |\n\\| `hooks` | `object` | — | Definiciones de enlace de nivel de usuario en línea. |\n\\| `copyOnSelect` | `boolean` |\n`true` (macOS), `false` (otro) | Copie automáticamente el texto seleccionado por el mouse en el Portapapeles del sistema en modo de pantalla alternativo. |\n\\| `statusLine` | `object` | — | Visualización de línea de estado personalizada.\n`type`: debe ser `\"command\"`.\n`command`: ruta de acceso a un script que recibe JSON de sesión en stdin e imprime el contenido de estado en stdout.\n`padding`: espacios opcionales de relleno a la izquierda. |\n\\| `suppress_init_folders` | `string[]` | `[]` | Carpetas en las que se ha descartado la `/init` sugerencia. Administrado automáticamente por `/init suppress`. |\n\\| `updateTerminalTitle` | `boolean` | `true` | Mostrar la intención actual en el título del terminal. |\n\n### Configuración del repositorio (`.github/copilot/settings.json`)\n\nLa configuración del repositorio se aplica a todos los usuarios que trabajan en el repositorio. Solo se admiten las claves enumeradas en la tabla siguiente en el nivel de repositorio. Cualquier otra clave, incluidas las claves válidas en el archivo de configuración de usuario, se omiten silenciosamente.\n\n| Key | Tipo | Comportamiento de fusión | Descripción |\n| ------------------------ | ------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |\n| `companyAnnouncements` | `string[]` | Reemplazado: el repositorio tiene prioridad | Mensajes mostrados aleatoriamente durante el inicio. |\n| `disableAllHooks` | `boolean` | El repositorio tiene prioridad | Deshabilite todos los ganchos. |\n| `enabledPlugins` | `Record` | Combinado: el repositorio invalida al usuario para la misma clave. | Instalación automática del complemento declarativo. |\n| `extraKnownMarketplaces` | `Record` | Combinado: el repositorio invalida al usuario para la misma clave. | Mercados de plugins disponibles en este repositorio. |\n| `hooks` | `object` | Concatenado: los enlaces de repositorio se ejecutan después de los enlaces de usuario | Definiciones de ganchos definidos para este repositorio. Consulte [Referencia de enlaces](#hooks-reference). |\n| `mergeStrategy` | | | |\n\n```\n `\"rebase\"`\n \\|\n `\"merge\"`\n | El repositorio tiene prioridad | Estrategia de resolución de conflictos para `/pr fix conflicts`. |\n```\n\n### Configuración local (`.github/copilot/settings.local.json`)\n\nCree `.github/copilot/settings.local.json` en el repositorio, para anulaciones personales que no se deben confirmar. Agregue este archivo a `.gitignore`.\n\nEl archivo de configuración local usa el mismo esquema que el archivo de configuración del repositorio (`.github/copilot/settings.json`) y tiene prioridad sobre él.\n\n## Inicialización del proyecto para Copilot\n\nCuando usas el comando `copilot init` o el comando de barra inclinada `/init` dentro de una sesión interactiva, Copilot analiza tu código base y escribe o actualiza un archivo `.github/copilot-instructions.md` en el repositorio. Este archivo de instrucciones personalizado contiene instrucciones específicas del proyecto que mejorarán las sesiones futuras de la CLI.\n\nNormalmente, usará `copilot init`, o `/init`, cuando inicie un nuevo proyecto o cuando empiece a usar CLI de Copilot en un repositorio existente.\n\nEl `copilot-instructions.md` archivo que se crea o actualiza normalmente documenta:\n\n* Compilar, probar y ejecutar comandos lint.\n* Arquitectura de alto nivel.\n* Convenciones específicas del código base.\n\nSi el archivo ya existe, Copilot sugiere mejoras que puede optar por aplicar o rechazar.\n\nLa CLI busca el `copilot-instructions.md` archivo al iniciarse y, si falta, muestra el mensaje:\n\n>\n\n```\n 💡 No se encontraron instrucciones de copilot. Ejecute /init para generar un archivo copilot-instructions.md para este proyecto.\n```\n\nSi no desea crear este archivo, puede ocultar permanentemente este mensaje de inicio mediante el `/init suppress` comando de barra diagonal, que agrega una `suppress_init_folders` configuración para este repositorio al Copilot archivo de configuración.\n\nPara obtener más información, vea [Agregar instrucciones personalizadas del repositorio para GitHub Copilot](/es/copilot/how-tos/configure-custom-instructions/add-repository-instructions).\n\n## Referencia de enlaces\n\nLos enlaces son comandos externos que se ejecutan en puntos de ciclo de vida específicos durante una sesión, lo que permite la automatización personalizada, los controles de seguridad y las integraciones. Los archivos de configuración de hook se cargan automáticamente desde `.github/hooks/*.json` de tu repositorio.\n\n### Formato de configuración de gancho\n\nLos archivos de configuración de enlace usan el formato JSON con la versión `1`.\n\n#### Ganchos de comando\n\nLos ganchos de comando ejecutan scripts de shell y son compatibles con todos los tipos de gancho.\n\n```json\n{\n \"version\": 1,\n \"hooks\": {\n \"preToolUse\": [\n {\n \"type\": \"command\",\n \"bash\": \"your-bash-command\",\n \"powershell\": \"your-powershell-command\",\n \"cwd\": \"optional/working/directory\",\n \"env\": { \"VAR\": \"value\" },\n \"timeoutSec\": 30\n }\n ]\n }\n}\n```\n\n| Campo | Tipo | Obligatorio | Descripción |\n| ------------ | --------------- | -------------------------- | -------------------------------------------------------------------------------------- |\n| `type` | `\"command\"` | Sí | Debe ser `\"command\"`. |\n| `bash` | cuerda / cadena | Uno de `bash`/`powershell` | Comando shell para Unix. |\n| `powershell` | cuerda / cadena | Uno de `bash`/`powershell` | Comando shell para Windows. |\n| `cwd` | cuerda / cadena | No | Directorio de trabajo para el comando (relativo a la raíz del repositorio o absoluto). |\n| `env` | objeto | No | Variables de entorno que se van a establecer (admite la expansión de variables). |\n| `timeoutSec` | número | No | Tiempo de expiración en segundos. Predeterminado: `30`. |\n\n#### Enlaces de solicitudes\n\nLos ganchos de solicitud envían automáticamente texto como si lo hubiera escrito el usuario. Solo se admiten en `sessionStart` y se ejecutan antes de que se pase cualquier mensaje inicial a través de `--prompt`. El texto puede ser una solicitud en lenguaje natural o un comando de barra.\n\n```json\n{\n \"version\": 1,\n \"hooks\": {\n \"sessionStart\": [\n {\n \"type\": \"prompt\",\n \"prompt\": \"Your prompt text or /slash-command\"\n }\n ]\n }\n}\n```\n\n| Campo | Tipo | Obligatorio | Descripción |\n| -------- | --------------- | ----------- | ----------------------------------------------------------------------------------------- |\n| `type` | `\"prompt\"` | Sí | Debe ser `\"prompt\"`. |\n| `prompt` | cuerda / cadena | Sí | Texto que se va a enviar: puede ser un mensaje en lenguaje natural o un comando de barra. |\n\n### Eventos de enlace\n\n| Event | Se activa cuando | Salida procesada |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |\n| `sessionStart` | Comienza una sesión nueva o reanudada. | No |\n| `sessionEnd` | La sesión finaliza. | No |\n| `userPromptSubmitted` | El usuario envía una sugerencia. | No |\n| `preToolUse` | Antes de que se ejecute cada herramienta. | Sí: puede permitir, denegar o modificar. |\n| `postToolUse` | Una vez que cada herramienta haya completado su tarea correctamente. | Sí: puede reemplazar el resultado exitoso (solo hooks programáticos del SDK). |\n| `postToolUseFailure` | Después de que una herramienta finalice con un error. | Sí — puede proporcionar instrucciones de recuperación a través de `additionalContext` (código `2` de salida para ganchos de comandos). |\n| `agentStop` | El agente principal finaliza un turno. | Sí: puede bloquear y forzar la continuación. |\n| `subagentStop` | Se completa un subagente. | Sí: puede bloquear y forzar la continuación. |\n| `subagentStart` | Se genera un subagente (antes de que se ejecute). Devuelve `additionalContext` antepuesto al mensaje del subagente. Admite `matcher` para filtrar por nombre del agente. | No: no se puede bloquear la creación. |\n| `preCompact` | La compactación de contexto está a punto de comenzar (manual o automática). Admite `matcher` para filtrar por desencadenador (`\"manual\"` o `\"auto\"`). | No: solo notificación. |\n| `permissionRequest` | Antes de mostrar un cuadro de diálogo de permisos al usuario, después de que las comprobaciones basadas en reglas no encuentren ninguna regla de permiso o denegación coincidente. Admite `matcher` regex en `toolName`. | Sí: puede permitir o denegar mediante programación. |\n| `errorOccurred` | Se produce un error durante la ejecución. | No |\n| `notification` | Se desencadena de forma asincrónica cuando la CLI emite una notificación del sistema (finalización del shell, finalización del agente o inactividad, notificaciones de permisos, diálogos de solicitud). Fire-and-forget: nunca bloquea la sesión. Admite `matcher` regex en `notification_type`. | Opcional: puede insertar `additionalContext` en la sesión. |\n\n### Cargas de entrada de eventos de enlace\n\nCada evento de enlace entrega una carga JSON al controlador de enlace. Se admiten dos formatos de carga, seleccionados por el nombre de evento usado en la configuración del enlace:\n\n* **formato camelCase** : configure el nombre del evento en camelCase (por ejemplo, `sessionStart`). Los campos emplean el formato camelCase.\n\n***\n\n```\n VS Code formato compatible** : configure el nombre del evento en PascalCase (por ejemplo, `SessionStart`). Los campos usan snake_case para coincidir con el formato de extensión VS CodeCopilot.\n```\n\n#### `sessionStart` / `SessionStart`\n\n```\n **entrada CamelCase:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number; // Unix timestamp in milliseconds\n cwd: string;\n source: \"startup\" | \"resume\" | \"new\";\n initialPrompt?: string;\n}\n```\n\n```\n **\n VS Code entrada compatible:**\n```\n\n```typescript\n{\n hook_event_name: \"SessionStart\";\n session_id: string;\n timestamp: string; // ISO 8601 timestamp\n cwd: string;\n source: \"startup\" | \"resume\" | \"new\";\n initial_prompt?: string;\n}\n```\n\n#### `sessionEnd` / `SessionEnd`\n\n```\n **entrada CamelCase:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number;\n cwd: string;\n reason: \"complete\" | \"error\" | \"abort\" | \"timeout\" | \"user_exit\";\n}\n```\n\n```\n **\n VS Code entrada compatible:**\n```\n\n```typescript\n{\n hook_event_name: \"SessionEnd\";\n session_id: string;\n timestamp: string; // ISO 8601 timestamp\n cwd: string;\n reason: \"complete\" | \"error\" | \"abort\" | \"timeout\" | \"user_exit\";\n}\n```\n\n#### `userPromptSubmitted` / `UserPromptSubmit`\n\n```\n **entrada CamelCase:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number;\n cwd: string;\n prompt: string;\n}\n```\n\n```\n **\n VS Code entrada compatible:**\n```\n\n```typescript\n{\n hook_event_name: \"UserPromptSubmit\";\n session_id: string;\n timestamp: string; // ISO 8601 timestamp\n cwd: string;\n prompt: string;\n}\n```\n\n#### `preToolUse` / `PreToolUse`\n\n```\n **entrada CamelCase:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number;\n cwd: string;\n toolName: string;\n toolArgs: unknown;\n}\n```\n\n```\n **\n VS Code entrada compatible:**\n```\n\nCuando se configura con el nombre del evento `PreToolUse` PascalCase, la carga utiliza nombres de campo snake\\_case para que coincidan con el formato de extensión VS CodeCopilot.\n\n```typescript\n{\n hook_event_name: \"PreToolUse\";\n session_id: string;\n timestamp: string; // ISO 8601 timestamp\n cwd: string;\n tool_name: string;\n tool_input: unknown; // Tool arguments (parsed from JSON string when possible)\n}\n```\n\n#### `postToolUse` / `PostToolUse`\n\n```\n **entrada CamelCase:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number;\n cwd: string;\n toolName: string;\n toolArgs: unknown;\n toolResult: {\n resultType: \"success\";\n textResultForLlm: string;\n }\n}\n```\n\n```\n **\n VS Code entrada compatible:**\n```\n\n```typescript\n{\n hook_event_name: \"PostToolUse\";\n session_id: string;\n timestamp: string; // ISO 8601 timestamp\n cwd: string;\n tool_name: string;\n tool_input: unknown;\n tool_result: {\n result_type: \"success\" | \"failure\" | \"denied\" | \"error\";\n text_result_for_llm: string;\n }\n}\n```\n\n#### `postToolUseFailure` / `PostToolUseFailure`\n\n```\n **entrada CamelCase:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number;\n cwd: string;\n toolName: string;\n toolArgs: unknown;\n error: string;\n}\n```\n\n```\n **\n VS Code entrada compatible:**\n```\n\n```typescript\n{\n hook_event_name: \"PostToolUseFailure\";\n session_id: string;\n timestamp: string; // ISO 8601 timestamp\n cwd: string;\n tool_name: string;\n tool_input: unknown;\n error: string;\n}\n```\n\n#### `agentStop` / `Stop`\n\n```\n **entrada CamelCase:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number;\n cwd: string;\n transcriptPath: string;\n stopReason: \"end_turn\";\n}\n```\n\n```\n **\n VS Code entrada compatible:**\n```\n\n```typescript\n{\n hook_event_name: \"Stop\";\n session_id: string;\n timestamp: string; // ISO 8601 timestamp\n cwd: string;\n transcript_path: string;\n stop_reason: \"end_turn\";\n}\n```\n\n#### `subagentStart`\n\n```\n **Entrada:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number;\n cwd: string;\n transcriptPath: string;\n agentName: string;\n agentDisplayName?: string;\n agentDescription?: string;\n}\n```\n\n#### `subagentStop` / `SubagentStop`\n\n```\n **entrada CamelCase:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number;\n cwd: string;\n transcriptPath: string;\n agentName: string;\n agentDisplayName?: string;\n stopReason: \"end_turn\";\n}\n```\n\n```\n **\n VS Code entrada compatible:**\n```\n\n```typescript\n{\n hook_event_name: \"SubagentStop\";\n session_id: string;\n timestamp: string; // ISO 8601 timestamp\n cwd: string;\n transcript_path: string;\n agent_name: string;\n agent_display_name?: string;\n stop_reason: \"end_turn\";\n}\n```\n\n#### `errorOccurred` / `ErrorOccurred`\n\n```\n **entrada CamelCase:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number;\n cwd: string;\n error: {\n message: string;\n name: string;\n stack?: string;\n };\n errorContext: \"model_call\" | \"tool_execution\" | \"system\" | \"user_input\";\n recoverable: boolean;\n}\n```\n\n```\n **\n VS Code entrada compatible:**\n```\n\n```typescript\n{\n hook_event_name: \"ErrorOccurred\";\n session_id: string;\n timestamp: string; // ISO 8601 timestamp\n cwd: string;\n error: {\n message: string;\n name: string;\n stack?: string;\n };\n error_context: \"model_call\" | \"tool_execution\" | \"system\" | \"user_input\";\n recoverable: boolean;\n}\n```\n\n#### `preCompact` / `PreCompact`\n\n```\n **entrada CamelCase:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number;\n cwd: string;\n transcriptPath: string;\n trigger: \"manual\" | \"auto\";\n customInstructions: string;\n}\n```\n\n```\n **\n VS Code entrada compatible:**\n```\n\n```typescript\n{\n hook_event_name: \"PreCompact\";\n session_id: string;\n timestamp: string; // ISO 8601 timestamp\n cwd: string;\n transcript_path: string;\n trigger: \"manual\" | \"auto\";\n custom_instructions: string;\n}\n```\n\n###\n\n```\n `preToolUse` control de decisión\n```\n\nEl gancho `preToolUse` puede controlar la ejecución de la herramienta escribiendo un objeto JSON en la salida estándar (stdout).\n\n| Campo | Valores | Descripción |\n| -------------------- | ------- | ----------- |\n| `permissionDecision` | | |\n\n```\n `\"allow\"`, , `\"deny\"`, `\"ask\"` | Si se ejecuta la herramienta. La salida vacía usa el comportamiento predeterminado. |\n```\n\n\\| `permissionDecisionReason` | cuerda / cadena | Motivo que se muestra al agente. Obligatorio cuando la decisión es `\"deny\"`. |\n\\| `modifiedArgs` | objeto | Sustituya los argumentos de la herramienta para usarlos en lugar de los originales. |\n\n###\n\n```\n `agentStop`\n / \n `subagentStop` control de decisión\n```\n\n| Campo | Valores | Descripción |\n| ---------- | ------- | ----------- |\n| `decision` | | |\n\n```\n `\"block\"`, `\"allow\"` | \n `\"block\"` obliga a otro agente a realizar un turno usando `reason` como solicitud. |\n```\n\n\\| `reason` | cuerda / cadena | Solicite el siguiente turno cuando `decision` sea `\"block\"`. |\n\n###\n\n```\n `permissionRequest` control de decisión\n```\n\nEl `permissionRequest` gancho se activa cuando se va a mostrar un cuadro de diálogo de permisos de nivel de herramienta. Se activa después de que las comprobaciones de permisiones basadas en reglas no encuentran ninguna regla de permisión o denegación coincidente. Úselo para aprobar o denegar llamadas a herramientas mediante programación, especialmente útiles en el modo de canalización (`-p`) y entornos de CI en los que no haya ninguna solicitud interactiva disponible.\n\n```\n **Comparador:** Expresión regular opcional probada en `toolName`. Cuando se establece, el gancho se activa solo para los nombres de herramientas coincidentes.\n```\n\nGenera JSON en stdout para controlar la decisión de permisos:\n\n| Campo | Valores | Descripción |\n| ---------- | ------- | ----------- |\n| `behavior` | | |\n\n```\n `\"allow\"`, `\"deny\"` | Aprobar o denegar la llamada a la herramienta. |\n```\n\n\\| `message` | cuerda / cadena | Motivo comunicado al LLM cuando se rechaza. |\n\\| `interrupt` | boolean | Cuando `true` se combina con `\"deny\"`, detiene completamente el agente. |\n\nDevuelve una salida vacía o `{}` para pasar al comportamiento predeterminado (mostrar el cuadro de diálogo al usuario o denegar en modo de canalización). El código `2` de salida se trata como denegación; si el enlace también genera JSON en stdout, esos campos se combinan con la decisión de denegación.\n\n###\n\n```\n `notification` gancho\n```\n\nEl `notification` gancho se dispara de forma asincrónica cuando la CLI emite una notificación de sistema. Estos enlaces se activan y olvidan: nunca bloquean la sesión y se registran y omiten los errores.\n\n```\n **Entrada:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number;\n cwd: string;\n hook_event_name: \"Notification\";\n message: string; // Human-readable notification text\n title?: string; // Short title (e.g., \"Permission needed\", \"Shell completed\")\n notification_type: string; // One of the types listed below\n}\n```\n\n```\n **Tipos de notificación:**\n```\n\n| Tipo | Cuando se activa |\n| -------------------------- | ------------------------------------------------------------------------------------------------- |\n| `shell_completed` | Un comando de shell en segundo plano (asincrónico) ha finalizado. |\n| `shell_detached_completed` | Se completa una sesión de shell desconectada |\n| `agent_completed` | Un subagente en segundo plano finaliza (completado o fallido) |\n| `agent_idle` | Un agente en segundo plano finaliza un turno y entra en estado inactivo (esperando `write_agent`) |\n| `permission_prompt` | El agente solicita permiso para ejecutar una herramienta. |\n| `elicitation_dialog` | El agente solicita información adicional del usuario. |\n\n```\n **Salida:**\n```\n\n```typescript\n{\n additionalContext?: string; // Injected into the session as a user message\n}\n```\n\nSi `additionalContext` se devuelve, el texto se inserta en la sesión como mensaje de usuario antepuesto. Esto puede desencadenar el procesamiento adicional del agente si la sesión está inactiva. Devuelve `{}` o una salida vacía para no realizar ninguna acción.\n\n```\n **Buscador de coincidencias:** Regex opcional en `notification_type`. El patrón está anclado como `^(?:pattern)$`. \n `matcher` Omitir para recibir todos los tipos de notificación.\n```\n\n### Nombres de herramientas para la coincidencia de ganchos\n\n| Nombre de la herramienta | Descripción |\n| ------------------------ | ------------------------------------ |\n| `bash` | Ejecute comandos de shell (Unix). |\n| `powershell` | Ejecute comandos de shell (Windows). |\n| `view` | Leer el contenido del archivo. |\n| `edit` | Modifique el contenido del archivo. |\n| `create` | Cree nuevos archivos. |\n| `glob` | Buscar archivos por patrón. |\n| `grep` | Buscar contenido del archivo. |\n| `web_fetch` | Capturar páginas web. |\n| `task` | Ejecutar tareas de subagentes. |\n\nSi se configuran varios ganchos del mismo tipo, se ejecutan en orden. Para `preToolUse`, si algún gancho devuelve `\"deny\"`, la herramienta se bloquea. En `postToolUseFailure` el caso de los enlaces de comandos, salir con código `2` hace que stderr se devuelva como guía de recuperación para el asistente. Los errores de enlace (códigos de salida distintos de cero o tiempos de espera) se registran y omiten; nunca bloquean la ejecución del agente.\n\n## Configuración del servidor MCP\n\nLos servidores MCP proporcionan herramientas adicionales al agente de la CLI. Configure servidores persistentes en `~/.copilot/mcp-config.json`. Use `--additional-mcp-config` para agregar servidores para una sola sesión.\n\n###\n\n```\n `copilot mcp` subcomando\n```\n\nUse `copilot mcp` para administrar configuraciones de servidor MCP desde la línea de comandos sin iniciar una sesión interactiva.\n\n| Subcommand | Descripción |\n| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |\n| `list [--json]` | Enumere todos los servidores MCP configurados agrupados por origen. |\n| `get [--json]` | Mostrar la configuración y las herramientas de un servidor específico. |\n| `add ` | Agregue un servidor a la configuración del usuario. Escribe en `~/.copilot/mcp-config.json`. |\n| `remove ` | Quite un servidor de nivel de usuario. Los servidores del espacio de trabajo deben ser editados directamente en sus archivos de configuración. |\n\n```\n **\n `copilot mcp add` Opciones:**\n```\n\n| Opción | Descripción |\n| ------------------------ | ------------------------------------------------------------------------------------------- |\n| `-- [args...]` | Comandos y argumentos para servidores locales (stdio). |\n| `--url ` | Dirección URL de los servidores remotos. |\n| `--type ` | Tipo de transporte: `local`, `stdio`, `http`o `sse`. |\n| `--env KEY=VALUE` | Variable de entorno (repetible). |\n| `--header KEY=VALUE` | Encabezado HTTP para servidores remotos (repetible). |\n| `--tools ` | Filtro de herramientas: `\"*\"` para todos, una lista separada por comas o `\"\"` para ninguna. |\n| `--timeout ` | Tiempo de espera en milisegundos. |\n| `--json` | La salida agregó la configuración como JSON. |\n| `--show-secrets` | Mostrar los valores completos de las variables de entorno y de los encabezados. |\n| `--config-dir ` | Ruta de acceso al directorio de configuración. |\n\n> \\[!CAUTION]\n\n```\n `--show-secrets` puede imprimir valores confidenciales de variables de entorno y encabezados en el terminal o los registros. Use solo esta opción en entornos de confianza y evite copiar, pegar o capturar la salida en registros o historial compartidos.\n```\n\n### Tipos de transporte\n\n| Tipo | Descripción | Campos obligatorios |\n| ----------------- | ------------------------------------------------------- | ------------------- |\n| `local` / `stdio` | Proceso local que se comunica a través de stdin/stdout. | |\n\n```\n `command`, `args` |\n```\n\n\\| `http` | Servidor remoto mediante transporte HTTP transmisible. | `url` |\n\\| `sse` | Servidor remoto mediante transporte de eventos enviados por el servidor. | `url` |\n\n### Campos de configuración del servidor local\n\n| Campo | Obligatorio | Descripción |\n| --------- | ----------- | ----------------------------------------------------------------------------------------------------------- |\n| `command` | Sí | Comando para iniciar el servidor. |\n| `args` | Sí | Argumentos de comando (matriz). |\n| `tools` | Sí | Herramientas que se van a habilitar: `[\"*\"]` para todos o una lista de nombres de herramientas específicos. |\n| `env` | No | Variables de entorno. Admite `$VAR`, `${VAR}` y `${VAR:-default}` expansión. |\n| `cwd` | No | Directorio de trabajo para el servidor. |\n| `timeout` | No | Tiempo de espera en milisegundos para la llamada a herramienta. |\n| `type` | No | |\n\n```\n `\"local\"` o `\"stdio\"`. Predeterminado: `\"local\"`. |\n```\n\n### Campos de configuración de servidor remoto\n\n| Campo | Obligatorio | Descripción |\n| ------ | ----------- | ----------- |\n| `type` | Sí | |\n\n```\n `\"http\"` o `\"sse\"`. |\n```\n\n\\| `url` | Sí | Dirección URL del servidor. |\n\\| `tools` | Sí | Herramientas para habilitar. |\n\\| `headers` | No | Encabezados HTTP. Admite la expansión de variables. |\n\\| `oauthClientId` | No | Identificador de cliente de OAuth estático (omite el registro dinámico). |\n\\| `oauthPublicClient` | No | Si el cliente de OAuth es público. Predeterminado: `true`. |\n\\| `oidc` | No | Habilite la inserción de tokens OIDC. Cuando `true`, inserta una `GITHUB_COPILOT_OIDC_MCP_TOKEN` variable de entorno (servidores locales) o un `Bearer``Authorization` encabezado (servidores remotos). |\n\\| `timeout` | No | Tiempo de espera en milisegundos para la llamada a herramienta. |\n\n### Re-autenticación de OAuth\n\nLos servidores MCP remotos que usan OAuth pueden mostrar un `needs-auth` estado cuando un token expira o cuando se requiere una cuenta diferente. Use `/mcp auth ` para desencadenar un flujo de OAuth nuevo. Se abre un mensaje de autenticación del explorador, lo que le permite iniciar sesión o cambiar de cuenta. Después de completar el flujo, el servidor se vuelve a conectar automáticamente.\n\n### Asignación de filtros\n\nControlar cómo se procesa la salida de la herramienta MCP mediante el `filterMapping` campo en la configuración de un servidor.\n\n| Modo | Descripción |\n| ------------------- | ------------------------------------------------------ |\n| `none` | Sin filtrado. |\n| `markdown` | Dar formato a la salida como Markdown. |\n| `hidden_characters` | Quite caracteres ocultos o de control. Predeterminado. |\n\n### Servidores MCP integrados\n\nLa CLI incluye servidores MCP integrados que están disponibles sin configuración adicional.\n\n| Servidor | Descripción |\n| ------------------- | ----------- |\n| `github-mcp-server` | |\n\n```\n GitHub Integración de API: problemas, solicitudes de incorporación de cambios, confirmaciones, búsqueda de código y GitHub Actions. |\n```\n\n\\| `playwright` | Automatización del explorador: navegue, haga clic, escriba, captura de pantalla y control de formularios. |\n\\| `fetch` | Solicitudes HTTP mediante la herramienta `fetch`. |\n\\| `time` | Utilidades de tiempo: `get_current_time` y `convert_time`. |\n\nUse `--disable-builtin-mcps` para deshabilitar todos los servidores integrados o `--disable-mcp-server SERVER-NAME` para deshabilitar uno específico.\n\n### Niveles de confianza del servidor MCP\n\nLos servidores MCP se cargan desde varios orígenes, cada uno con un nivel de confianza diferente.\n\n| Fuente | Nivel de confianza | Revisión necesaria |\n| -------------------------------------------------------- | ------------------ | --------------------------- |\n| Integrado | Alto | No |\n| Repositorio (`.github/mcp.json`) | Medio | Recomendado |\n| Área de trabajo (`.mcp.json`) | Medio | Recomendado |\n| Configuración del usuario (`~/.copilot/mcp-config.json`) | User-defined | Responsabilidad del usuario |\n| Servidores remotos | Low | Siempre |\n\nTodas las invocaciones de la herramienta MCP requieren permiso explícito. Esto se aplica incluso a las operaciones de solo lectura en servicios externos.\n\n### Lista de autorización empresarial de MCP\n\n```\n GitHub Enterprise las organizaciones pueden aplicar una lista blanca de servidores MCP permitidos. Cuando la CLI está activa, evalúa cada servidor no predeterminado según la política empresarial antes de establecer la conexión.\n```\n\nCuando se detecta una GitHub Enterprise directiva del Registro (o la `MCP_ENTERPRISE_ALLOWLIST` marca de característica experimental está habilitada), la CLI:\n\n1. Calcula una huella digital para cada servidor no predeterminado configurado en función de su comando, argumentos y dirección URL remota.\n2. Envía las huellas digitales al punto de conexión de evaluación de lista de permitidos de empresa.\n3. Permite solo servidores cuyas huellas digitales están aprobadas; todos los demás se bloquean con un mensaje que menciona el nombre de la empresa.\n\nEsta comprobación está cerrada por error: si el punto de conexión de evaluación no es accesible o devuelve un error, los servidores no predeterminados se bloquean hasta que se pueda comprobar la directiva.\n\nCuando un servidor está bloqueado por una lista de permitidos de empresa, la CLI muestra:\n\n```text\nMCP server \"SERVER-NAME\" was blocked by your enterprise \"ENTERPRISE-NAME\".\nContact your enterprise administrator to add this server to the allowlist.\n```\n\nLos servidores predeterminados integrados siempre están exentos de la aplicación de la lista de permitidos.\n\n### Migración desde `.vscode/mcp.json`\n\nSi el proyecto usa `.vscode/mcp.json` (formato de configuración MCP de VS Code), migre a `.mcp.json` para CLI de GitHub Copilot. La migración reasigna la `servers` tecla a `mcpServers`.\n\n```\n **Intérpretes de comandos POSIX (bash, zsh, fish y otros):**\n```\n\n```shell\njq '{mcpServers: .servers}' .vscode/mcp.json > .mcp.json\n```\n\nRequiere [`jq`](https://jqlang.github.io/jq/).\n\n```\n **PowerShell**:\n```\n\n```powershell\npwsh -NoProfile -Command \"`$json = Get-Content '.vscode/mcp.json' -Raw | ConvertFrom-Json; `$content = ([pscustomobject]@{ mcpServers = `$json.servers } | ConvertTo-Json -Depth 100); [System.IO.File]::WriteAllText('.mcp.json', `$content, (New-Object System.Text.UTF8Encoding `$false))\"\n```\n\nEn Windows, reemplace `pwsh` por `powershell` si usa Windows PowerShell en lugar de PowerShell Core.\n\n## Referencia sobre aptitudes\n\nLas aptitudes son archivos markdown que amplían lo que puede hacer la CLI. Cada aptitud reside en su propio directorio que contiene un `SKILL.md` archivo. Cuando se invoca (a través de `/SKILL-NAME` o automáticamente por el agente), el contenido de la habilidad se inserta en la conversación.\n\n### Campos de texto preliminar de aptitudes\n\n| Campo | Tipo | Obligatorio | Descripción |\n| -------------------------- | ---------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `name` | cuerda / cadena | Sí | Identificador único de la aptitud. Solo letras, números y guiones. Máximo de 64 caracteres. |\n| `description` | cuerda / cadena | Sí | Qué hace la aptitud y cuándo usarla. Máximo de 1024 caracteres. |\n| `allowed-tools` | \"string\" o \"string\\[]\" | No | Lista separada por comas o matriz YAML de herramientas que se permiten automáticamente cuando la aptitud está activa. Utilice `\"*\"` para todas las herramientas. |\n| `user-invocable` | boolean | No | Si los usuarios pueden invocar la aptitud con `/SKILL-NAME`. Predeterminado: `true`. |\n| `disable-model-invocation` | boolean | No | Impedir que el agente invoque automáticamente esta aptitud. Predeterminado: `false`. |\n\n### Ubicaciones de habilidades\n\nLas habilidades se cargan desde estas ubicaciones en orden de prioridad (la primera encontrada prevalece sobre nombres duplicados).\n\n| Ubicación | Ámbito | Descripción |\n| --------------------------- | ------------- | ------------------------------------------------------------------------------------------------ |\n| `.github/skills/` | Proyecto | Habilidades específicas del proyecto. |\n| `.agents/skills/` | Proyecto | Ubicación alternativa del proyecto. |\n| `.claude/skills/` | Proyecto | Ubicación compatible con Claude. |\n| Padre `.github/skills/` | Inherited | Compatibilidad con directorios primarios de un repositorio. |\n| `~/.copilot/skills/` | Personal | Habilidades personales para todos los proyectos. |\n| `~/.agents/skills/` | Personal | Habilidades del agente compartidas en todos los proyectos. |\n| `~/.claude/skills/` | Personal | Ubicación personal compatible con Claude. |\n| Directorios de complementos | Plugin | Aptitudes de complementos instalados. |\n| `COPILOT_SKILLS_DIRS` | Personalizada | Directorios adicionales (separados por comas). |\n| (agrupado con la CLI) | Integrado | Funcionalidades incluidas con la CLI. Prioridad más baja: invalidable por cualquier otro origen. |\n\n### Comandos (formato de habilidad alternativo)\n\nLos comandos son una alternativa a las habilidades almacenadas como archivos individuales `.md` en `.claude/commands/`. El nombre del comando se deriva del nombre de archivo. Los archivos de comandos usan un formato simplificado (sin `name` campo necesario) y admiten `description`, `allowed-tools`y `disable-model-invocation`. Los comandos tienen menor prioridad que las aptitudes con el mismo nombre.\n\n## Referencia de agentes personalizados\n\nLos agentes personalizados son agentes de IA especializados definidos en archivos Markdown. El nombre de archivo (sin la extensión) se convierte en el identificador del agente. Use `.agent.md` o `.md` como extensión de archivo.\n\n### Agentes integrados\n\n| Agente | Modelo predeterminado | Descripción |\n| ----------------- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `code-review` | claude-sonnet-4.5 | Revisión de código con alta relación señal a ruido. Analiza diferencias en el código para detectar fallos, problemas de seguridad y errores lógicos. |\n| `rubber-duck` | modelo complementario | Utilice un modelo complementario para proporcionar una crítica constructiva de propuestas, diseños, implementaciones o pruebas. Identifica puntos débiles y sugiere mejoras. Solo está disponible en modo experimental. |\n| `explore` | claude-haiku-4.5 | Exploración rápida del código base. Busca archivos, lee código y responde preguntas. Devuelve respuestas centradas en menos de 300 palabras. Seguro para ejecutarse en paralelo. |\n| `general-purpose` | claude-sonnet-4.5 | Agente de funcionalidad completa para tareas complejas de varios pasos. Se ejecuta en una ventana de contexto independiente. |\n| `research` | claude-sonnet-4.6 | Agente de investigación profundo. Genera un informe basado en la información de su código base, en repositorios pertinentes y en la web. |\n| `task` | claude-haiku-4.5 | Ejecución de comandos (pruebas, compilaciones, lints). Devuelve un breve resumen en caso de éxito y la salida completa en caso de fallo. |\n\n### Campos de frontmatter del agente personalizado\n\n| Campo | Tipo | Obligatorio | Descripción |\n| ------------- | --------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `description` | cuerda / cadena | Sí | Descripción que se muestra en la lista del agente y en la herramienta `task`. |\n| `infer` | boolean | No | Permitir la delegación automática del agente principal. Predeterminado: `true`. |\n| `mcp-servers` | objeto | No | Servidores MCP para conectarse. Usa el mismo esquema que `~/.copilot/mcp-config.json`. |\n| `model` | cuerda / cadena | No | Modelo de IA para este agente. Cuando no se establece, hereda el modelo del agente externo. Cuando el modelo de sesión se establece en `Auto` (seleccionado por el servidor), los subagentes siempre heredan el modelo de sesión resuelto independientemente de este campo. |\n| `name` | cuerda / cadena | No | Nombre para mostrar. El valor predeterminado es el nombre de archivo. |\n| `tools` | string\\[] | No | Herramientas disponibles para el agente. Valor predeterminado: `[\"*\"]` (todas las herramientas). |\n\n### Ubicaciones de agente personalizadas\n\n| Ámbito | Ubicación |\n| -------- | --------- |\n| Proyecto | |\n\n```\n `.github/agents/` o `.claude/agents/` |\n```\n\n\\| Usuario |\n`~/.copilot/agents/` o `~/.claude/agents/` |\n\\| Plugin | `/agents/` |\n\nLos agentes a nivel de proyecto tienen prioridad sobre los agentes a nivel de usuario. Los agentes de complementos tienen la prioridad más baja.\n\n### Límites de subagentes\n\nLa CLI aplica límites de profundidad y concurrencia para evitar la generación incontrolada de agentes.\n\n| Limit | Predeterminado | Variable del entorno |\n| ---------------------------- | -------------- | --------------------------------- |\n| Profundidad máxima | `6` | `COPILOT_SUBAGENT_MAX_DEPTH` |\n| Número máximo de simultáneos | `32` | `COPILOT_SUBAGENT_MAX_CONCURRENT` |\n\n```\n **La profundidad** cuenta cuántos agentes se anidan entre sí. Cuando se alcanza el límite de profundidad, el agente más interno no puede generar más subagentes. \n **Concurrencia** cuenta cuántos subagentes se ejecutan de manera simultánea en todo el árbol de sesión. Cuando se alcanza el límite, se rechazan las nuevas solicitudes de subagentes hasta que un agente activo finaliza su tarea. Los valores se limitan entre `1` y `256`.\n```\n\n## Respuestas de aprobación de permisos\n\nCuando la CLI solicita permiso para ejecutar una operación, puede responder con las siguientes claves.\n\n| Key | Efecto |\n| --- | -------------------------------------------------------------------- |\n| `y` | Permitir esta solicitud específica una vez. |\n| `n` | Deniegue esta solicitud específica una vez. |\n| `!` | Permitir todas las solicitudes similares para el resto de la sesión. |\n| `#` | Deniegue todas las solicitudes similares para el resto de la sesión. |\n| `?` | Mostrar información detallada sobre la solicitud. |\n\nLas aprobaciones de sesión se restablecen al ejecutar `/clear` o iniciar una nueva sesión.\n\n## Supervisión de OpenTelemetry\n\n```\n CLI de Copilot puede exportar seguimientos y métricas a través [de OpenTelemetry](https://opentelemetry.io/) (OTel), lo que proporciona visibilidad sobre las interacciones del agente, las llamadas LLM, las ejecuciones de herramientas y el uso de tokens. Todos los nombres y atributos de señal siguen las [convenciones semánticas de OTel GenAI](https://github.com/open-telemetry/semantic-conventions/blob/main/docs/gen-ai/).\n```\n\nOTel está desactivado por defecto y no genera ninguna sobrecarga. Se activa cuando se cumple cualquiera de las condiciones siguientes:\n\n* `COPILOT_OTEL_ENABLED=true`\n* `OTEL_EXPORTER_OTLP_ENDPOINT` está establecido\n* `COPILOT_OTEL_FILE_EXPORTER_PATH` está establecido\n\n### Variables de entorno de OTel\n\n| Variable | Predeterminado | Descripción |\n| ---------------------------------------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `COPILOT_OTEL_ENABLED` | `false` | Habilite explícitamente OTel. No es necesario si `OTEL_EXPORTER_OTLP_ENDPOINT` está configurado. |\n| `OTEL_EXPORTER_OTLP_ENDPOINT` | — | Dirección URL del punto de conexión de OTLP. Si se establece esta opción, se habilita automáticamente OTel. |\n| `COPILOT_OTEL_EXPORTER_TYPE` | `otlp-http` | Tipo de exportador: `otlp-http` o `file`. Selecciona automáticamente `file` cuando `COPILOT_OTEL_FILE_EXPORTER_PATH` se establece. |\n| `OTEL_SERVICE_NAME` | `github-copilot` | Nombre del servicio en los atributos de recursos. |\n| `OTEL_RESOURCE_ATTRIBUTES` | — | Atributos de recursos adicionales como pares separados por comas `key=value` . Utiliza la codificación de porcentaje para caracteres especiales. |\n| `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT` | `false` | Capturar el contenido completo del mensaje y de la respuesta. Consulte [Captura de contenido](#content-capture). |\n| `OTEL_LOG_LEVEL` | — | Nivel de registro de diagnóstico de OTel: `NONE`, `ERROR`, `WARN``INFO`, `DEBUG`, , `VERBOSE`, `ALL`. |\n| `COPILOT_OTEL_FILE_EXPORTER_PATH` | — | Escriba todas las señales en este archivo como líneas JSON. Si se establece esta opción, se habilita automáticamente OTel. |\n| `COPILOT_OTEL_SOURCE_NAME` | `github.copilot` | Nombre del ámbito de instrumentación para el rastreador y el medidor. |\n| `OTEL_EXPORTER_OTLP_HEADERS` | — | Encabezados de autenticación para el exportador de OTLP (por ejemplo, `Authorization=Bearer token`). |\n\n### Huellas\n\nEl entorno de ejecución emite un árbol jerárquico de segmentos para cada interacción del agente. Cada árbol contiene un intervalo raíz `invoke_agent`, con intervalos secundarios `chat` y `execute_tool`.\n\n####\n\n```\n `invoke_agent` atributos de span\n```\n\nEnvuelve la invocación completa del agente: todas las llamadas LLM y las ejecuciones de herramientas de un mensaje de usuario.\n\n* **Las sesiones de nivel superior** usan el tipo de traza `CLIENT` (invocación de servicio remoto) con `server.address` y `server.port`.\n* **Las invocaciones de subagentes** (por ejemplo, explorar, tarea) usan el tipo de intervalo `INTERNAL` (en proceso) sin atributos de servidor.\n\n| Atributo | Descripción | Tipo de intervalo |\n| -------------------------------- | ----------------------------------------------- | ----------------- |\n| `gen_ai.operation.name` | `invoke_agent` | Ambas |\n| `gen_ai.provider.name` | Proveedor (por ejemplo, `github`, `anthropic`) | Ambas |\n| `gen_ai.agent.id` | Identificador de sesión | Ambas |\n| `gen_ai.agent.name` | Nombre del agente (cuando está disponible) | Ambas |\n| `gen_ai.agent.description` | Descripción del agente (cuando está disponible) | Ambas |\n| `gen_ai.agent.version` | Versión del entorno de ejecución | Ambas |\n| `gen_ai.conversation.id` | Identificador de sesión | Ambas |\n| `gen_ai.request.model` | Modelo solicitado | Ambas |\n| `gen_ai.response.finish_reasons` | | |\n\n```\n `[\"stop\"]` o `[\"error\"]` | Ambas |\n```\n\n\\| `gen_ai.usage.input_tokens` | Total de tokens de entrada (todos los turnos) | Ambas |\n\\| `gen_ai.usage.output_tokens` | Total de tokens de salida (todos los turnos) | Ambas |\n\\| `gen_ai.usage.cache_read.input_tokens` | Lectura de tokens de entrada almacenados en caché | Ambas |\n\\| `gen_ai.usage.cache_creation.input_tokens` | Tokens de entrada creados y almacenados en caché | Ambas |\n\\| `github.copilot.turn_count` | Número de recorridos de ida y vuelta de LLM | Ambas |\n\\| `github.copilot.cost` | Costo monetario | Ambas |\n\\| `github.copilot.aiu` | Unidades de IA consumidas | Ambas |\n\\| `server.address` | Nombre de host del servidor | Solo `CLIENT` |\n\\| `server.port` | Puerto de servidor | Solo `CLIENT` |\n\\| `error.type` | Nombre de clase de error (en caso de error) | Ambas |\n\\| `gen_ai.input.messages` | Mensajes de entrada completos como JSON (solo captura de contenido) | Ambas |\n\\| `gen_ai.output.messages` | Mensajes de salida completos como JSON (solo captura de contenido) | Ambas |\n\\| `gen_ai.system_instructions` | Contenido del mensaje del sistema como JSON (captura solo de contenido) | Ambas |\n\\| `gen_ai.tool.definitions` | Esquemas de herramientas como JSON (solo captura de contenido) | Ambas |\n\n####\n\n```\n `chat` atributos de span\n```\n\nUn intervalo por solicitud de LLM. Tipo de intervalo: `CLIENT`.\n\n| Atributo | Descripción |\n| ------------------------------------------ | -------------------------------------------------------------------------- |\n| `gen_ai.operation.name` | `chat` |\n| `gen_ai.provider.name` | Nombre del proveedor |\n| `gen_ai.request.model` | Modelo solicitado |\n| `gen_ai.conversation.id` | Identificador de sesión |\n| `gen_ai.response.id` | ID de respuesta |\n| `gen_ai.response.model` | Modelo resuelto |\n| `gen_ai.response.finish_reasons` | Motivos de detención |\n| `gen_ai.usage.input_tokens` | Tokens de entrada en este turno |\n| `gen_ai.usage.output_tokens` | Tokens de salida este turno |\n| `gen_ai.usage.cache_read.input_tokens` | Lectura de tokens almacenados en caché |\n| `gen_ai.usage.cache_creation.input_tokens` | Tokens creados y almacenados en caché |\n| `github.copilot.cost` | Costo de turnos |\n| `github.copilot.aiu` | Unidades de IA consumidas en este turno |\n| `github.copilot.server_duration` | Duración del lado servidor |\n| `github.copilot.initiator` | Iniciador de solicitudes |\n| `github.copilot.turn_id` | Identificador de turno |\n| `github.copilot.interaction_id` | Identificador de interacción |\n| `github.copilot.time_to_first_chunk` | Tiempo para el primer fragmento de streaming, en segundos (solo streaming) |\n| `server.address` | Nombre de host del servidor |\n| `server.port` | Puerto de servidor |\n| `error.type` | Nombre de clase de error (en caso de error) |\n| `gen_ai.input.messages` | Mensajes de solicitud completos como JSON (solo captura de contenido) |\n| `gen_ai.output.messages` | Mensajes de respuesta completos como JSON (solo captura de contenido) |\n| `gen_ai.system_instructions` | Contenido del mensaje del sistema como JSON (captura solo de contenido) |\n\n####\n\n```\n `execute_tool` atributos de span\n```\n\nUn intervalo por llamada a herramienta. Tipo de intervalo: `INTERNAL`.\n\n| Atributo | Descripción |\n| ---------------------------- | --------------------------------------------------------------------------- |\n| `gen_ai.operation.name` | `execute_tool` |\n| `gen_ai.provider.name` | Nombre del proveedor (cuando está disponible) |\n| `gen_ai.tool.name` | Nombre de la herramienta (por ejemplo, `readFile`) |\n| `gen_ai.tool.type` | `function` |\n| `gen_ai.tool.call.id` | Identificador de llamada de herramienta |\n| `gen_ai.tool.description` | Descripción de la herramienta |\n| `error.type` | Nombre de clase de error (en caso de error) |\n| `gen_ai.tool.call.arguments` | Argumentos de entrada de herramientas como JSON (solo captura de contenido) |\n| `gen_ai.tool.call.result` | Salida de la herramienta como JSON (solo captura de contenido) |\n\n### Métricas\n\n#### Métricas de convención de GenAI\n\n| Métrica | Tipo | Unidad | Descripción |\n| ----------------------------------------------- | ---------- | ------ | -------------------------------------------------------------------- |\n| `gen_ai.client.operation.duration` | Histograma | s | Duración de la llamada a la API de LLM y de la invocación del agente |\n| `gen_ai.client.token.usage` | Histograma | tokens | Recuentos de tokens por tipo (`input`/`output`) |\n| `gen_ai.client.operation.time_to_first_chunk` | Histograma | s | Hora de recibir el primer fragmento de streaming |\n| `gen_ai.client.operation.time_per_output_chunk` | Histograma | s | Latencia entre fragmentos después del primer fragmento |\n\n#### Métricas específicas del proveedor\n\n| Métrica | Tipo | Unidad | Descripción |\n| ----------------------------------- | ---------- | -------- | --------------------------------------------------------------- |\n| `github.copilot.tool.call.count` | Contador | llamadas | Invocaciones de herramientas por `gen_ai.tool.name` y `success` |\n| `github.copilot.tool.call.duration` | Histograma | s | Latencia de ejecución de herramientas por `gen_ai.tool.name` |\n| `github.copilot.agent.turn.count` | Histograma | turnos | Recorridos de ida y vuelta de LLM por cada invocación de agente |\n\n### Eventos de intervalo\n\nEventos de ciclo de vida registrados en el intervalo activo `chat` o `invoke_agent`.\n\n| Event | Descripción | Atributos clave |\n| --------------------------- | ------------------------------ | --------------- |\n| `github.copilot.hook.start` | Un gancho comenzó a ejecutarse | |\n\n```\n `github.copilot.hook.type`, `github.copilot.hook.invocation_id` |\n```\n\n\\| `github.copilot.hook.end` | Un enlace se ha completado correctamente |\n`github.copilot.hook.type`, `github.copilot.hook.invocation_id` |\n\\| `github.copilot.hook.error` | Error de enlace |\n`github.copilot.hook.type`, , `github.copilot.hook.invocation_id`, `github.copilot.hook.error_message` |\n\\| `github.copilot.session.truncation` | El historial de conversaciones se ha truncado |\n`github.copilot.token_limit`, `github.copilot.pre_tokens`, `github.copilot.post_tokens`, `github.copilot.pre_messages`, `github.copilot.post_messages`, `github.copilot.tokens_removed`, , `github.copilot.messages_removed``github.copilot.performed_by` |\n\\| `github.copilot.session.compaction_start` | Se inició la compactación de historia | Ninguno |\n\\| `github.copilot.session.compaction_complete` | Compactación del historial completada |\n`github.copilot.success`, `github.copilot.pre_tokens`, `github.copilot.post_tokens`, `github.copilot.tokens_removed`, , `github.copilot.messages_removed`( `github.copilot.message` solo captura de contenido) |\n\\| `github.copilot.skill.invoked` | Se invocó una habilidad |\n`github.copilot.skill.name`, `github.copilot.skill.path`, , `github.copilot.skill.plugin_name`, `github.copilot.skill.plugin_version` |\n\\| `github.copilot.session.shutdown` | La sesión se está cerrando |\n`github.copilot.shutdown_type`, `github.copilot.total_premium_requests`, `github.copilot.lines_added`, , `github.copilot.lines_removed`, `github.copilot.files_modified_count` |\n\\| `github.copilot.session.abort` | El usuario canceló la operación actual | `github.copilot.abort_reason` |\n\\| `exception` | Error de sesión |\n`github.copilot.error_type`, , `github.copilot.error_status_code`, `github.copilot.error_provider_call_id` |\n\n### Atributos del recurso\n\nTodas las señales llevan estos atributos de recurso.\n\n| Atributo | Importancia |\n| -------------- | ----------- |\n| `service.name` | |\n\n```\n `github-copilot` (configurable a través de `OTEL_SERVICE_NAME`) |\n```\n\n\\| `service.version` | Versión del entorno de ejecución |\n\n### Captura de contenido\n\nDe forma predeterminada, no se captura ningún contenido de solicitud, respuestas o argumentos de herramienta, solo metadatos como nombres de modelo, recuentos de tokens y duraciones. Para capturar contenido completo, establezca `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true`.\n\n> \\[!WARNING]\n> La captura de contenido puede incluir información confidencial, como el código, el contenido del archivo y las indicaciones del usuario. Habilite esto solo en entornos de confianza.\n\nCuando la captura de contenido está habilitada, se rellenan los atributos siguientes.\n\n| Atributo | Contenido |\n| ---------------------------- | ------------------------------------------- |\n| `gen_ai.input.messages` | Mensajes de solicitud completos (JSON) |\n| `gen_ai.output.messages` | Mensajes de respuesta completos (JSON) |\n| `gen_ai.system_instructions` | Contenido del mensaje del sistema (JSON) |\n| `gen_ai.tool.definitions` | Esquemas de herramientas (JSON) |\n| `gen_ai.tool.call.arguments` | Los argumentos de entrada de la herramienta |\n| `gen_ai.tool.call.result` | Salida de la herramienta |\n\n## Lectura adicional\n\n* [CLI de GitHub Copilot](/es/copilot/how-tos/copilot-cli)\n* [Referencia del plugin CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-plugin-reference)\n* [Referencia programática de la CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-programmatic-reference)\n* [directorio de configuración de la CLI de GitHub Copilot](/es/copilot/reference/copilot-cli-reference/cli-config-dir-reference)"}