Configurar o SDK do Copilot

O BYOK (Bring Your Own Key - traga sua própria chave) do SDK do Copilot aceita chaves de API estáticas, mas as implantações Azure geralmente usam Identidade Gerenciada (Microsoft Entra ID) em vez de chaves de longa duração. Como o SDK não dá suporte nativo à autenticação Microsoft Entra, você pode usar um token de portador de curta duração por meio do campo de configuração do bearer_token provedor.

Execute o SDK Copilot em aplicativos do lado do servidor — APIs, back-ends da Web, microsserviços e trabalhos em segundo plano. A CLI é executada como um servidor sem cabeça ao qual o código de back-end se conecta pela rede.

Os SDKs de Node.js e .NET incluem a CLI Copilot como uma dependência— seu aplicativo é fornecido com tudo o que precisa, sem nenhuma instalação ou configuração adicional necessária.

Esses guias orientam você pela configuração do SDK do Copilot para seu caso de uso específico, desde projetos pessoais até plataformas de produção que atendem a milhares de usuários.

Permitir que os usuários se autentiquem com suas contas GitHub para usar Copilot por meio de seu aplicativo. Isso dá suporte a contas individuais, associações à organização e identidades empresariais.

Use um binário específico da CLI em vez do gerenciamento automático da CLI pelo SDK. Essa é uma opção avançada: você fornece o caminho da CLI explicitamente e é responsável por garantir a compatibilidade de versão com o SDK.

O modo de servidor multiusuário significa executar o SDK do Copilot a partir de um código de back-end que atende a mais de um usuário, locatário, workspace ou conta de integração. Nessa configuração, o aplicativo é responsável pelo roteamento das solicitações e pela autorização, enquanto o SDK e o runtime fornecem estado por sessão, autenticação por sessão e registro explícito de ferramentas, para que a sessão de um usuário não herde as ferramentas nem a identidade de outro usuário.

Projete sua implantação do SDK Copilot para atender a vários usuários, manipular sessões simultâneas e dimensionar horizontalmente em toda a infraestrutura. Este guia aborda padrões de isolamento de sessão, topologias de dimensionamento e práticas recomendadas de produção.