# Руководства по настройке

Эти руководства проводят вас через настройку SDK Copilot для вашего конкретного случая использования — от личных побочных проектов до производственных платформ, обслуживающих тысячи пользователей.

<!-- markdownlint-disable GHD046 GHD005 -->

<!-- Suppressed: GHD046 (outdated release terminology), GHD005 (hardcoded data variable) -->

## Архитектура в каждом взгляде

Каждая интеграция Copilot SDK следует одной и той же основной схеме: ваше приложение взаимодействует с SDK, который взаимодействует с Copilot CLI через JSON-RPC. Что меняется в зависимости от конфигурации — **это то, где работает CLI**, **как пользователи аутентифицируются** и **как управляются сессиями**.

![Диаграмма: блок-схема, показывающая описанный процесс.](/assets/images/help/copilot/copilot-sdk/setup-choosing-a-setup-path-diagram-0.png)

Руководства по настройке ниже помогут настроить каждый слой под ваш сценарий.

## Ты кто?

### 🧑 💻 Любитель

Вы создаёте личного ассистента, побочный проект или экспериментальное приложение. Вам нужен самый простой путь к внедрению Copilot в ваш код.

**Начните с:**

1. \*\*
   [Настройка по умолчанию (в комплекте CLI)](/ru/copilot/how-tos/copilot-sdk/setup/bundled-cli)\*\* — SDK автоматически включает CLI — просто установите и запустите
2. \*\*
   [Локальная настройка CLI](/ru/copilot/how-tos/copilot-sdk/setup/local-cli)\*\* — Используйте свой собственный бинарный файл CLI или запущенный экземпляр (продвинутый)

### 🏢 Внутренний разработчик приложений

Вы создаёте инструменты для своей команды или компании. Пользователи — это сотрудники, которым необходимо пройти аутентификацию через корпоративные аккаунты GitHub или членство в организации.

**Начните с:**

1. \*\*
   [Настройка GitHub OAuth](/ru/copilot/how-tos/copilot-sdk/setup/github-oauth)\*\* — Позвольте сотрудникам войти через свои GitHub аккаунты
2. \*\*
   [Настройка серверных сервисов](/ru/copilot/how-tos/copilot-sdk/setup/backend-services)\*\* — Запустите SDK во внутренних сервисах

**Если масштабироваться выше одного сервера:**

1. \*\*
   [Мультиарендные и серверные развертывания](/ru/copilot/how-tos/copilot-sdk/setup/multi-tenancy)\*\*—Настройка параметров SDK для многопользовательского серверного режима
2. \*\*
   [Масштабирование и многоарендность](/ru/copilot/how-tos/copilot-sdk/setup/scaling)\*\*—Управление несколькими пользователями и сервисами

### 🚀 Разработчик приложений (ISV)

Вы создаёте продукт для клиентов. Вам нужно заниматься аутентификацией для пользователей — либо через GitHub, либо самостоятельно управляя идентификацией.

**Начните с:**

1. \*\*
   [Настройка GitHub OAuth](/ru/copilot/how-tos/copilot-sdk/setup/github-oauth)\*\* — Позвольте клиентам войти с GitHub
2. \*\*
   [БЁК (принеси свой ключ)](/ru/copilot/how-tos/copilot-sdk/auth/byok)\*\* — Управляйте идентификацией самостоятельно с помощью ключей моделей
3. \*\*
   [Настройка серверных сервисов](/ru/copilot/how-tos/copilot-sdk/setup/backend-services)\*\* — Питание вашего продукта на серверной стороне кода

**Для производства:**

1. \*\*
   [Мультиарендные и серверные развертывания](/ru/copilot/how-tos/copilot-sdk/setup/multi-tenancy)\*\*—Используйте `mode: "empty"`токены за сессию и изолированное состояние во время выполнения
2. \*\*
   [Масштабирование и многоарендность](/ru/copilot/how-tos/copilot-sdk/setup/scaling)\*\* — Надежно обслуживать многих клиентов

### 🏗️ Разработчик платформы

Вы встраиваете Copilot в платформу — API, инструменты для разработчиков или инфраструктуру, на которой строят другие разработчики. Вам нужен тонкий контроль над сессиями, масштабированием и мультиарендой.

**Начните с:**

1. \*\*
   [Настройка серверных сервисов](/ru/copilot/how-tos/copilot-sdk/setup/backend-services)\*\*—Основная серверная интеграция
2. \*\*
   [Мультиарендные и серверные развертывания](/ru/copilot/how-tos/copilot-sdk/setup/multi-tenancy)\*\*—изоляция на уровне SDK, аутентификация за сессию и общие опции выполнения
3. \*\*
   [Масштабирование и многоарендность](/ru/copilot/how-tos/copilot-sdk/setup/scaling)\*\* — Изоляция сессии, горизонтальное масштабирование, персистенция

**В зависимости от вашей модели аутентификации:**

1. \*\*
   [Настройка GitHub OAuth](/ru/copilot/how-tos/copilot-sdk/setup/github-oauth)\*\* — Для пользователей с GitHub аутентификацией
2. \*\*
   [БЁК (принеси свой ключ)](/ru/copilot/how-tos/copilot-sdk/auth/byok)\*\*—Для самоуправляемой идентичности и доступа к модели

## Матрица принятия решений

Используйте эту таблицу, чтобы найти правильные руководства в зависимости от того, что вам нужно сделать:

| Что вам нужно                                                                                    | Guide |
| ------------------------------------------------------------------------------------------------ | ----- |
| Быстрый старт                                                                                    |       |
| [Настройка по умолчанию (в комплекте CLI)](/ru/copilot/how-tos/copilot-sdk/setup/bundled-cli)    |       |
| Используйте свой собственный CLI-бинар или сервер                                                |       |
| [Локальная настройка CLI](/ru/copilot/how-tos/copilot-sdk/setup/local-cli)                       |       |
| Пользователи входят через GitHub                                                                 |       |
| [Настройка GitHub OAuth](/ru/copilot/how-tos/copilot-sdk/setup/github-oauth)                     |       |
| Используйте свои собственные ключи модели (OpenAI, Azure и др.)                                  |       |
| [БЁК (принеси свой ключ)](/ru/copilot/how-tos/copilot-sdk/auth/byok)                             |       |
| Azure BYOK с управляемой идентификацией (без API-ключей)                                         |       |
| [Azure managed identity with BYOK](/ru/copilot/how-tos/copilot-sdk/setup/azure-managed-identity) |       |
| Запустите SDK на сервере                                                                         |       |
| [Настройка серверных сервисов](/ru/copilot/how-tos/copilot-sdk/setup/backend-services)           |       |
| Настройте параметры SDK для одновременно используемых пользователей                              |       |
| [Мультиарендные и серверные развертывания](/ru/copilot/how-tos/copilot-sdk/setup/multi-tenancy)  |       |
| Обслуживать нескольких пользователей / масштабироваться горизонтально                            |       |
| [Масштабирование и многоарендность](/ru/copilot/how-tos/copilot-sdk/setup/scaling)               |       |

## Сравнение конфигураций

![Диаграмма: блок-схема, показывающая описанный процесс.](/assets/images/help/copilot/copilot-sdk/setup-choosing-a-setup-path-diagram-1.png)

## Необходимые условия

Все гайды предполагают, что у вас есть:

* **один из SDK** установленных (Node.js, Python и .NET SDK автоматически включают CLI):
  * Node.js: `npm install @github/copilot-sdk`
  * Питон (язык программирования): `pip install github-copilot-sdk`
  * Go: `go get github.com/github/copilot-sdk/go` (требуется отдельная установка CLI)
  * .NET: `dotnet add package GitHub.Copilot.SDK`

Если вы новичок, начните с **[Создайте своё первое приложение на базе Copilot](/ru/copilot/how-tos/copilot-sdk/getting-started)** , а потом возвращайтесь сюда для серийной конфигурации.

## Дальнейшие действия

Выберите гайд, который соответствует вашей ситуации, из [матрицы решений](#decision-matrix) выше, или начните с описания персонажа, наиболее близкого к вашей роли.