Skip to main content

Features

Esses guias abordam os recursos que você pode adicionar ao seu aplicativo SDK Copilot. Cada guia inclui exemplos em idiomas com suporte (TypeScript, Python, Go, .NET, Java e Rust) quando disponível.

O ciclo do agente

Como a CLI do Copilot processa uma mensagem de usuário de ponta a ponta: do prompt ao session.idle.

Sessões de nuvem

As sessões de nuvem executam o trabalho do Copilot em recursos computacionais hospedados no GitHub por meio do Mission Control. Use-os quando seu aplicativo deve criar uma sessão que seja executada remotamente em vez de iniciar uma sessão da CLI de Copilot local no computador do usuário ou no servidor.

Agentes personalizados e orquestração de subagentes

Defina agentes especializados com ferramentas e prompts com escopo definido e, em seguida, permita que o Copilot os orquestre como subagentes em uma única sessão. Para executar vários subagentes em paralelo, consulte Modo de frota.

Modo de frota

Fleet mode é o padrão de orquestração paralela do Copilot para tarefas que podem ser divididas entre subagentes independentes. Nas notas de pesquisa sobre o runtime, o modo fleet é descrito como "o padrão interno do runtime para acionar vários subagentes em paralelo por meio da ferramenta task, tendo os itens de tarefas em SQL como estado compartilhado de coordenação." Use isso quando uma sessão principal precisar coordenar vários agentes, coletar seus resultados e continuar a conversa com o contexto combinado.

Trabalhando com ganchos

Os ganchos permitem que você conecte a lógica personalizada em cada estágio de uma sessão de Copilot, desde o momento em que ela começa, por meio de cada prompt de usuário e chamada de ferramenta, até o momento em que termina. Este guia percorre casos práticos de uso para que você possa enviar permissões, auditoria, notificações e muito mais sem modificar o comportamento do agente principal.

Entrada de imagem

Envie imagens para sessões do Copilot como anexos. Há duas maneiras de anexar imagens:

Usando servidores MCP com o SDK do GitHub Copilot

O SDK do Copilot pode se integrar aos servidores MCP (Protocolo de Contexto de Modelo) para estender os recursos do assistente com ferramentas externas. Os servidores MCP são executados como processos separados e expõem ferramentas (funções) que Copilot podem invocar durante as conversas.

Diretórios de plug-in

Um plug-in é um diretório que agrupa extensões do SDK — habilidades, ganchos, servidores MCP, agentes personalizados e configuração de LSP — por trás de um único manifesto. Apontar o SDK para um diretório de plug-ins carrega tudo o que os plug-ins fornecem, para que você possa disponibilizar pacotes reutilizáveis de recursos sem precisar escrever a integração específica de cada extensão em cada aplicação host.

Sessões remotas

As sessões remotas permitem que os usuários acessem sua sessão do Copilot pela Web e pelo aplicativo móvel do GitHub por meio do Mission Control. Quando habilitado, o SDK conecta cada sessão ao Controle de Missão, produzindo uma URL que pode ser compartilhada como um link ou 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.

Retomada e persistência da sessão

Este guia orienta você pelos recursos de persistência de sessão do SDK: como pausar o trabalho, retomá-lo mais tarde e gerenciar sessões em ambientes de produção.

Habilidades personalizadas

As habilidades são módulos reutilizáveis de prompt que expandem os recursos do Copilot. Carregue habilidades a partir de diretórios para fornecer ao Copilot capacidades especializadas em domínios específicos ou fluxos de trabalho.

Direção e fila

Dois padrões de interação permitem que os usuários enviem mensagens enquanto o agente já está em operação: direcionamento redireciona o agente no meio do turno e enfileiramento armazena mensagens em buffer para processamento sequencial após a conclusão do turno atual.

Eventos de sessão de streaming

Cada ação que o agente do Copilot realiza — pensar, escrever código e executar ferramentas — é registrada como um evento de sessão que você pode acompanhar. Este guia é uma referência de nível de campo para cada tipo de evento para que você saiba exatamente quais dados esperar sem ler a fonte do SDK.