Características
Estas guías abarcan las funcionalidades que puede agregar a la aplicación del SDK de Copilot. Cada guía incluye ejemplos en lenguajes admitidos (TypeScript, Python, Go, .NET, Java y Rust) cuando estén disponibles.
Bucle del agente
Cómo la CLI de Copilot procesa un mensaje de usuario de un extremo a otro: desde la solicitud hasta session.idle.
Sesiones en la nube
Las sesiones en la nube ejecutan las tareas de Copilot en recursos de cómputo alojados en GitHub a través de Mission Control. Úselos cuando la aplicación debe crear una sesión que se ejecute de forma remota en lugar de iniciar una sesión de la CLI de Copilot local en el equipo del usuario o en el servidor.
Agentes personalizados y orquestación de subagentes
Defina agentes especializados con herramientas e instrucciones de alcance limitado y, a continuación, deje que Copilot los orqueste como subagentes dentro de una única sesión. Para enviar varios subagentes en paralelo, consulte Modo flota.
Modo flota
El modo flota es el patrón de orquestación en paralelo de Copilot para tareas que pueden dividirse entre subagentes independientes. En las notas de investigación del runtime, el modo flota se describe como «el patrón integrado del runtime para desplegar varios subagentes en paralelo a través de la herramienta task, con tareas SQL como estado compartido de coordinación». Úselo cuando una sesión principal deba coordinar varios trabajadores, recopilar sus resultados y continuar la conversación con el contexto combinado.
Trabajar con enlaces
Los enlaces permiten conectar lógica personalizada en cada fase de una sesión de Copilot, desde el momento en que se inicia, a través de cada solicitud de usuario y llamada a herramienta, hasta el momento en que finaliza. En esta guía se describen casos de uso prácticos para que pueda enviar permisos, auditorías, notificaciones y mucho más sin modificar el comportamiento del agente principal.
Entrada de imagen
Enviar imágenes a las sesiones de Copilot como archivos adjuntos. Hay dos maneras de adjuntar imágenes:
Uso de servidores MCP con el SDK de GitHub Copilot
El SDK de Copilot puede integrarse con servidores MCP (Protocolo de contexto de modelo) para ampliar las funcionalidades del asistente con herramientas externas. Los servidores MCP se ejecutan como procesos independientes y exponen herramientas (funciones) que Copilot pueden invocar durante las conversaciones.
Directorios de complementos
Un complemento es un directorio que agrupa extensiones del SDK (aptitudes, enlaces, servidores MCP, agentes personalizados y configuración de LSP) detrás de un único manifiesto. Apuntar el SDK a un directorio de complementos carga todo lo que aporta el complemento, por lo que puede distribuir paquetes reutilizables de capacidades sin tener que implementar la integración específica de cada extensión en cada aplicación anfitriona.
Sesiones remotas
Las sesiones remotas permiten a los usuarios acceder a su sesión de Copilot desde GitHub web y móvil a través de Mission Control. Cuando se habilita, el SDK conecta cada sesión a Mission Control, lo que genera una dirección URL que se puede compartir como un vínculo o código QR.
Session limits
Session limits let an application set an AI Credits budget for a Copilot session. Use sessionLimits when creating or resuming a session to set a soft cap for the current accounting window.
Reanudación y persistencia de sesión
Esta guía le guía a través de las funcionalidades de persistencia de sesión del SDK, cómo pausar el trabajo, reanudarlo más adelante y administrar sesiones en entornos de producción.
Aptitudes personalizadas
Las capacidades son módulos de indicaciones reutilizables que amplían las capacidades de Copilot. Cargue aptitudes de directorios para proporcionar Copilot capacidades especializadas para dominios o flujos de trabajo específicos.
Dirección y puesta en cola
Dos patrones de interacción permiten a los usuarios enviar mensajes mientras el agente ya está funcionando: redirección redirige al agente a mitad del turno, y poner en cola los mensajes para el procesamiento secuencial tras completar el turno actual.
Eventos de la sesión de transmisión
Cada acción que realiza el agente de Copilot —pensar, escribir código o ejecutar herramientas— se emite como un evento de sesión al que puedes suscribirte. Esta guía es una referencia de nivel de campo para cada tipo de evento para saber exactamente qué datos esperar sin leer el origen del SDK.