# Guias de configuração 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. ## Visão geral da arquitetura Cada integração do SDK Copilot segue o mesmo padrão principal: seu aplicativo conversa com o SDK, que se comunica com a CLI do Copilot por JSON-RPC. O que muda entre as configurações é **onde a CLI é executada**, **como os usuários se autenticam** e **como as sessões são gerenciadas**. ![Diagrama: Fluxograma mostrando o processo descrito.](/assets/images/help/copilot/copilot-sdk/setup-choosing-a-setup-path-diagram-0.png) Os guias de instalação abaixo ajudam você a configurar cada camada para seu cenário. ## Quem é você? ### 🧑‍💻 Amador Você está criando um assistente pessoal, um projeto lateral ou um aplicativo experimental. Você deseja o caminho mais simples para colocar Copilot em seu código. **Comece com:** 1. \*\* [Configuração padrão (CLI empacotada)](/pt/copilot/how-tos/copilot-sdk/setup/bundled-cli)\*\* — O SDK inclui a CLI automaticamente — basta instalar e ir 2. \*\* [Configuração da CLI local](/pt/copilot/how-tos/copilot-sdk/setup/local-cli)\*\*—Use seu próprio binário da CLI ou uma instância já em execução (avançado) ### 🏢 Desenvolvedor de aplicativos interno Você está criando ferramentas para sua equipe ou empresa. Os usuários são funcionários que precisam se autenticar com suas contas corporativas GitHub ou associações de organização. **Comece com:** 1. \*\* [Configuração do OAuth do GitHub](/pt/copilot/how-tos/copilot-sdk/setup/github-oauth)\*\*— Permitir que os funcionários entrem com suas contas GitHub 2. \*\* [Configuração de serviços de back-end](/pt/copilot/how-tos/copilot-sdk/setup/backend-services)\*\* – Executar o SDK em seus serviços internos **Se o dimensionamento for além de um único servidor:** 1. \*\* [Multilocação e implantações de servidores](/pt/copilot/how-tos/copilot-sdk/setup/multi-tenancy)\*\* — Configurar opções de SDK para o modo de servidor multiusuário 2. \*\* [Escalabilidade e multitenância](/pt/copilot/how-tos/copilot-sdk/setup/scaling)\*\*—Gerenciar vários usuários e serviços ### 🚀 Desenvolvedor de aplicativos (ISV) Você está criando um produto para os clientes. Você precisa lidar com a autenticação para seus usuários, seja por meio de GitHub ou gerenciando a identidade por conta própria. **Comece com:** 1. \*\* [Configuração do OAuth do GitHub](/pt/copilot/how-tos/copilot-sdk/setup/github-oauth)\*\* — Permitir que os clientes entrem com GitHub 2. \*\* [BYOK (Bring Your Own Key - traga sua própria chave)](/pt/copilot/how-tos/copilot-sdk/auth/byok)\*\*—Gerencie sua identidade por conta própria com suas próprias chaves de modelo 3. \*\* [Configuração de serviços de back-end](/pt/copilot/how-tos/copilot-sdk/setup/backend-services)\*\* — Habilitar seu produto a partir do código do lado do servidor **Para produção:** 1. \*\* [Multilocação e implantações de servidores](/pt/copilot/how-tos/copilot-sdk/setup/multi-tenancy)\*\* — Usar `mode: "empty"`tokens por sessão e estado de runtime isolado 2. \*\* [Escalabilidade e multitenância](/pt/copilot/how-tos/copilot-sdk/setup/scaling)\*\* — Atender muitos clientes de forma confiável ### 🏗️ Desenvolvedor de plataforma Você está inserindo o Copilot em uma plataforma — APIs, ferramentas de desenvolvedor ou infraestrutura na qual outros desenvolvedores se baseiam. Você precisa de controle refinado sobre sessões, dimensionamento e multilocação. **Comece com:** 1. \*\* [Configuração de serviços de back-end](/pt/copilot/how-tos/copilot-sdk/setup/backend-services)\*\* — Integração principal do lado do servidor 2. \*\* [Multilocação e implantações de servidores](/pt/copilot/how-tos/copilot-sdk/setup/multi-tenancy)\*\* — isolamento no nível do SDK, autenticação por sessão e opções de runtime compartilhado 3. \*\* [Escalabilidade e multitenância](/pt/copilot/how-tos/copilot-sdk/setup/scaling)\*\* — Isolamento de sessão, dimensionamento horizontal, persistência **Dependendo do modelo de autenticação:** 1. \*\* [Configuração do OAuth do GitHub](/pt/copilot/how-tos/copilot-sdk/setup/github-oauth)\*\* — Para usuários autenticados GitHub 2. \*\* [BYOK (Bring Your Own Key - traga sua própria chave)](/pt/copilot/how-tos/copilot-sdk/auth/byok)\*\*—Para identidade autogerenciada e acesso ao modelo ## Matriz de decisão Use esta tabela para encontrar os guias certos com base no que você precisa fazer: | O que você precisa | Guide | | ------------------------------------------------------------------------------------------------------- | ----- | | Introdução rápida | | | [Configuração padrão (CLI empacotada)](/pt/copilot/how-tos/copilot-sdk/setup/bundled-cli) | | | Usar seu próprio binário da CLI ou seu próprio servidor | | | [Configuração da CLI local](/pt/copilot/how-tos/copilot-sdk/setup/local-cli) | | | Usuários fazem login com o GitHub | | | [Configuração do OAuth do GitHub](/pt/copilot/how-tos/copilot-sdk/setup/github-oauth) | | | Use suas próprias chaves de modelo (OpenAI, Azure e muito mais) | | | [BYOK (Bring Your Own Key - traga sua própria chave)](/pt/copilot/how-tos/copilot-sdk/auth/byok) | | | BYOK do Azure com Identidade Gerenciada (sem chaves de API) | | | [Identidade gerenciada do Azure com BYOK](/pt/copilot/how-tos/copilot-sdk/setup/azure-managed-identity) | | | Executar o SDK em um servidor | | | [Configuração de serviços de back-end](/pt/copilot/how-tos/copilot-sdk/setup/backend-services) | | | Configurar opções de SDK para usuários simultâneos | | | [Multilocação e implantações de servidores](/pt/copilot/how-tos/copilot-sdk/setup/multi-tenancy) | | | Atender a vários usuários/dimensionar horizontalmente | | | [Escalabilidade e multitenância](/pt/copilot/how-tos/copilot-sdk/setup/scaling) | | ## Comparação de configuração ![Diagrama: Fluxograma mostrando o processo descrito.](/assets/images/help/copilot/copilot-sdk/setup-choosing-a-setup-path-diagram-1.png) ## Pré-requisitos Todos os guias pressupõem que você tenha: * **Um dos SDKs** instalados (Node.js, Python e os SDKs do .NET incluem a CLI automaticamente): * Node.js: `npm install @github/copilot-sdk` * Python:`pip install github-copilot-sdk` * Go: `go get github.com/github/copilot-sdk/go` (requer instalação separada da CLI) * .NET:`dotnet add package GitHub.Copilot.SDK` Se você for novo, comece com o **[Crie seu primeiro aplicativo com tecnologia do Copilot](/pt/copilot/how-tos/copilot-sdk/getting-started)** primeiro e volte aqui para a configuração de produção. ## Próximas Etapas  Escolha o guia que corresponde à sua situação na [matriz de decisão](#decision-matrix) acima ou comece com a descrição da persona mais próxima de sua função.