{"meta":{"title":"Guias de configuração","intro":"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.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/copilot","title":"GitHub Copilot"},{"href":"/pt/copilot/how-tos","title":"Instruções"},{"href":"/pt/copilot/how-tos/copilot-sdk","title":"SDK do Copilot"},{"href":"/pt/copilot/how-tos/copilot-sdk/setup","title":"Configurar o SDK do Copilot"},{"href":"/pt/copilot/how-tos/copilot-sdk/setup/choosing-a-setup-path","title":"Escolhendo um caminho de instalação"}],"documentType":"article"},"body":"# Guias de configuração\n\nEsses 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.\n\n\n\n\n\n## Visão geral da arquitetura\n\nCada 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**.\n\n![Diagrama: Fluxograma mostrando o processo descrito.](/assets/images/help/copilot/copilot-sdk/setup-choosing-a-setup-path-diagram-0.png)\n\nOs guias de instalação abaixo ajudam você a configurar cada camada para seu cenário.\n\n## Quem é você?\n\n### 🧑‍💻 Amador\n\nVocê 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.\n\n**Comece com:**\n\n1. \\*\\*\n [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\n2. \\*\\*\n [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)\n\n### 🏢 Desenvolvedor de aplicativos interno\n\nVocê 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.\n\n**Comece com:**\n\n1. \\*\\*\n [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\n2. \\*\\*\n [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\n\n**Se o dimensionamento for além de um único servidor:**\n\n1. \\*\\*\n [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\n2. \\*\\*\n [Escalabilidade e multitenância](/pt/copilot/how-tos/copilot-sdk/setup/scaling)\\*\\*—Gerenciar vários usuários e serviços\n\n### 🚀 Desenvolvedor de aplicativos (ISV)\n\nVocê 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.\n\n**Comece com:**\n\n1. \\*\\*\n [Configuração do OAuth do GitHub](/pt/copilot/how-tos/copilot-sdk/setup/github-oauth)\\*\\* — Permitir que os clientes entrem com GitHub\n2. \\*\\*\n [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\n3. \\*\\*\n [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\n\n**Para produção:**\n\n1. \\*\\*\n [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\n2. \\*\\*\n [Escalabilidade e multitenância](/pt/copilot/how-tos/copilot-sdk/setup/scaling)\\*\\* — Atender muitos clientes de forma confiável\n\n### 🏗️ Desenvolvedor de plataforma\n\nVocê 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.\n\n**Comece com:**\n\n1. \\*\\*\n [Configuração de serviços de back-end](/pt/copilot/how-tos/copilot-sdk/setup/backend-services)\\*\\* — Integração principal do lado do servidor\n2. \\*\\*\n [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\n3. \\*\\*\n [Escalabilidade e multitenância](/pt/copilot/how-tos/copilot-sdk/setup/scaling)\\*\\* — Isolamento de sessão, dimensionamento horizontal, persistência\n\n**Dependendo do modelo de autenticação:**\n\n1. \\*\\*\n [Configuração do OAuth do GitHub](/pt/copilot/how-tos/copilot-sdk/setup/github-oauth)\\*\\* — Para usuários autenticados GitHub\n2. \\*\\*\n [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\n\n## Matriz de decisão\n\nUse esta tabela para encontrar os guias certos com base no que você precisa fazer:\n\n| O que você precisa | Guide |\n| ------------------------------------------------------------------------------------------------------- | ----- |\n| Introdução rápida | |\n| [Configuração padrão (CLI empacotada)](/pt/copilot/how-tos/copilot-sdk/setup/bundled-cli) | |\n| Usar seu próprio binário da CLI ou seu próprio servidor | |\n| [Configuração da CLI local](/pt/copilot/how-tos/copilot-sdk/setup/local-cli) | |\n| Usuários fazem login com o GitHub | |\n| [Configuração do OAuth do GitHub](/pt/copilot/how-tos/copilot-sdk/setup/github-oauth) | |\n| Use suas próprias chaves de modelo (OpenAI, Azure e muito mais) | |\n| [BYOK (Bring Your Own Key - traga sua própria chave)](/pt/copilot/how-tos/copilot-sdk/auth/byok) | |\n| BYOK do Azure com Identidade Gerenciada (sem chaves de API) | |\n| [Identidade gerenciada do Azure com BYOK](/pt/copilot/how-tos/copilot-sdk/setup/azure-managed-identity) | |\n| Executar o SDK em um servidor | |\n| [Configuração de serviços de back-end](/pt/copilot/how-tos/copilot-sdk/setup/backend-services) | |\n| Configurar opções de SDK para usuários simultâneos | |\n| [Multilocação e implantações de servidores](/pt/copilot/how-tos/copilot-sdk/setup/multi-tenancy) | |\n| Atender a vários usuários/dimensionar horizontalmente | |\n| [Escalabilidade e multitenância](/pt/copilot/how-tos/copilot-sdk/setup/scaling) | |\n\n## Comparação de configuração\n\n![Diagrama: Fluxograma mostrando o processo descrito.](/assets/images/help/copilot/copilot-sdk/setup-choosing-a-setup-path-diagram-1.png)\n\n## Pré-requisitos\n\nTodos os guias pressupõem que você tenha:\n\n* **Um dos SDKs** instalados (Node.js, Python e os SDKs do .NET incluem a CLI automaticamente):\n * Node.js: `npm install @github/copilot-sdk`\n * Python:`pip install github-copilot-sdk`\n * Go: `go get github.com/github/copilot-sdk/go` (requer instalação separada da CLI)\n * .NET:`dotnet add package GitHub.Copilot.SDK`\n\nSe 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.\n\n## Próximas Etapas \n\nEscolha 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."}