{"meta":{"title":"Руководства по настройке","intro":"Эти руководства проводят вас через настройку SDK Copilot для вашего конкретного случая использования — от личных побочных проектов до производственных платформ, обслуживающих тысячи пользователей.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ru/copilot","title":"GitHub Copilot"},{"href":"/ru/copilot/how-tos","title":"Инструкции"},{"href":"/ru/copilot/how-tos/copilot-sdk","title":"Второй пилот SDK"},{"href":"/ru/copilot/how-tos/copilot-sdk/setup","title":"Настройте Copilot SDK"},{"href":"/ru/copilot/how-tos/copilot-sdk/setup/choosing-a-setup-path","title":"Выбор пути настройки"}],"documentType":"article"},"body":"# Руководства по настройке\n\nЭти руководства проводят вас через настройку SDK Copilot для вашего конкретного случая использования — от личных побочных проектов до производственных платформ, обслуживающих тысячи пользователей.\n\n<!-- markdownlint-disable GHD046 GHD005 -->\n\n<!-- Suppressed: GHD046 (outdated release terminology), GHD005 (hardcoded data variable) -->\n\n## Архитектура в каждом взгляде\n\nКаждая интеграция Copilot SDK следует одной и той же основной схеме: ваше приложение взаимодействует с SDK, который взаимодействует с Copilot CLI через JSON-RPC. Что меняется в зависимости от конфигурации — **это то, где работает CLI**, **как пользователи аутентифицируются** и **как управляются сессиями**.\n\n![Диаграмма: блок-схема, показывающая описанный процесс.](/assets/images/help/copilot/copilot-sdk/setup-choosing-a-setup-path-diagram-0.png)\n\nРуководства по настройке ниже помогут настроить каждый слой под ваш сценарий.\n\n## Ты кто?\n\n### 🧑 💻 Любитель\n\nВы создаёте личного ассистента, побочный проект или экспериментальное приложение. Вам нужен самый простой путь к внедрению Copilot в ваш код.\n\n**Начните с:**\n\n1. \\*\\*\n   [Настройка по умолчанию (в комплекте CLI)](/ru/copilot/how-tos/copilot-sdk/setup/bundled-cli)\\*\\* — SDK автоматически включает CLI — просто установите и запустите\n2. \\*\\*\n   [Локальная настройка CLI](/ru/copilot/how-tos/copilot-sdk/setup/local-cli)\\*\\* — Используйте свой собственный бинарный файл CLI или запущенный экземпляр (продвинутый)\n\n### 🏢 Внутренний разработчик приложений\n\nВы создаёте инструменты для своей команды или компании. Пользователи — это сотрудники, которым необходимо пройти аутентификацию через корпоративные аккаунты GitHub или членство в организации.\n\n**Начните с:**\n\n1. \\*\\*\n   [Настройка GitHub OAuth](/ru/copilot/how-tos/copilot-sdk/setup/github-oauth)\\*\\* — Позвольте сотрудникам войти через свои GitHub аккаунты\n2. \\*\\*\n   [Настройка серверных сервисов](/ru/copilot/how-tos/copilot-sdk/setup/backend-services)\\*\\* — Запустите SDK во внутренних сервисах\n\n**Если масштабироваться выше одного сервера:**\n\n1. \\*\\*\n   [Мультиарендные и серверные развертывания](/ru/copilot/how-tos/copilot-sdk/setup/multi-tenancy)\\*\\*—Настройка параметров SDK для многопользовательского серверного режима\n2. \\*\\*\n   [Масштабирование и многоарендность](/ru/copilot/how-tos/copilot-sdk/setup/scaling)\\*\\*—Управление несколькими пользователями и сервисами\n\n### 🚀 Разработчик приложений (ISV)\n\nВы создаёте продукт для клиентов. Вам нужно заниматься аутентификацией для пользователей — либо через GitHub, либо самостоятельно управляя идентификацией.\n\n**Начните с:**\n\n1. \\*\\*\n   [Настройка GitHub OAuth](/ru/copilot/how-tos/copilot-sdk/setup/github-oauth)\\*\\* — Позвольте клиентам войти с GitHub\n2. \\*\\*\n   [БЁК (принеси свой ключ)](/ru/copilot/how-tos/copilot-sdk/auth/byok)\\*\\* — Управляйте идентификацией самостоятельно с помощью ключей моделей\n3. \\*\\*\n   [Настройка серверных сервисов](/ru/copilot/how-tos/copilot-sdk/setup/backend-services)\\*\\* — Питание вашего продукта на серверной стороне кода\n\n**Для производства:**\n\n1. \\*\\*\n   [Мультиарендные и серверные развертывания](/ru/copilot/how-tos/copilot-sdk/setup/multi-tenancy)\\*\\*—Используйте `mode: \"empty\"`токены за сессию и изолированное состояние во время выполнения\n2. \\*\\*\n   [Масштабирование и многоарендность](/ru/copilot/how-tos/copilot-sdk/setup/scaling)\\*\\* — Надежно обслуживать многих клиентов\n\n### 🏗️ Разработчик платформы\n\nВы встраиваете Copilot в платформу — API, инструменты для разработчиков или инфраструктуру, на которой строят другие разработчики. Вам нужен тонкий контроль над сессиями, масштабированием и мультиарендой.\n\n**Начните с:**\n\n1. \\*\\*\n   [Настройка серверных сервисов](/ru/copilot/how-tos/copilot-sdk/setup/backend-services)\\*\\*—Основная серверная интеграция\n2. \\*\\*\n   [Мультиарендные и серверные развертывания](/ru/copilot/how-tos/copilot-sdk/setup/multi-tenancy)\\*\\*—изоляция на уровне SDK, аутентификация за сессию и общие опции выполнения\n3. \\*\\*\n   [Масштабирование и многоарендность](/ru/copilot/how-tos/copilot-sdk/setup/scaling)\\*\\* — Изоляция сессии, горизонтальное масштабирование, персистенция\n\n**В зависимости от вашей модели аутентификации:**\n\n1. \\*\\*\n   [Настройка GitHub OAuth](/ru/copilot/how-tos/copilot-sdk/setup/github-oauth)\\*\\* — Для пользователей с GitHub аутентификацией\n2. \\*\\*\n   [БЁК (принеси свой ключ)](/ru/copilot/how-tos/copilot-sdk/auth/byok)\\*\\*—Для самоуправляемой идентичности и доступа к модели\n\n## Матрица принятия решений\n\nИспользуйте эту таблицу, чтобы найти правильные руководства в зависимости от того, что вам нужно сделать:\n\n| Что вам нужно                                                                                                  | Guide |\n| -------------------------------------------------------------------------------------------------------------- | ----- |\n| Быстрый старт                                                                                                  |       |\n| [Настройка по умолчанию (в комплекте CLI)](/ru/copilot/how-tos/copilot-sdk/setup/bundled-cli)                  |       |\n| Используйте свой собственный CLI-бинар или сервер                                                              |       |\n| [Локальная настройка CLI](/ru/copilot/how-tos/copilot-sdk/setup/local-cli)                                     |       |\n| Пользователи входят через GitHub                                                                               |       |\n| [Настройка GitHub OAuth](/ru/copilot/how-tos/copilot-sdk/setup/github-oauth)                                   |       |\n| Используйте собственные ключи модели (OpenAI, Azure и многое другое)                                           |       |\n| [БЁК (принеси свой ключ)](/ru/copilot/how-tos/copilot-sdk/auth/byok)                                           |       |\n| Azure BYOK с управляемой идентификацией (без API-ключей)                                                       |       |\n| [управляемое удостоверение Azure с помощью BYOK](/ru/copilot/how-tos/copilot-sdk/setup/azure-managed-identity) |       |\n| Запустите SDK на сервере                                                                                       |       |\n| [Настройка серверных сервисов](/ru/copilot/how-tos/copilot-sdk/setup/backend-services)                         |       |\n| Настройте параметры SDK для одновременно используемых пользователей                                            |       |\n| [Мультиарендные и серверные развертывания](/ru/copilot/how-tos/copilot-sdk/setup/multi-tenancy)                |       |\n| Обслуживать нескольких пользователей / масштабироваться горизонтально                                          |       |\n| [Масштабирование и многоарендность](/ru/copilot/how-tos/copilot-sdk/setup/scaling)                             |       |\n\n## Сравнение конфигураций\n\n![Диаграмма: блок-схема, показывающая описанный процесс.](/assets/images/help/copilot/copilot-sdk/setup-choosing-a-setup-path-diagram-1.png)\n\n## Необходимые условия\n\nВсе гайды предполагают, что у вас есть:\n\n* **один из SDK** установленных (Node.js, Python и .NET SDK автоматически включают CLI):\n  * Node.js: `npm install @github/copilot-sdk`\n  * Питон (язык программирования): `pip install github-copilot-sdk`\n  * Go: `go get github.com/github/copilot-sdk/go` (требуется отдельная установка CLI)\n  * .NET:`dotnet add package GitHub.Copilot.SDK`\n\nЕсли вы новичок, начните с **[Создайте своё первое приложение на базе Copilot](/ru/copilot/how-tos/copilot-sdk/getting-started)** , а потом возвращайтесь сюда для серийной конфигурации.\n\n## Дальнейшие действия\n\nВыберите гайд, который соответствует вашей ситуации, из [матрицы решений](#decision-matrix) выше, или начните с описания персонажа, наиболее близкого к вашей роли."}