TypeScript
```typescript
import { CopilotClient } from "@github/copilot-sdk";
import type { ModelInfo } from "@github/copilot-sdk";
const client = new CopilotClient({
onListModels: () => [
{
id: "my-custom-model",
name: "My Custom Model",
capabilities: {
supports: { vision: false, reasoningEffort: false },
limits: { max_context_window_tokens: 128000 },
},
},
],
});
```
Python
```python
from copilot import CopilotClient
from copilot.client import ModelInfo, ModelCapabilities, ModelSupports, ModelLimits
client = CopilotClient(
on_list_models=lambda: [
ModelInfo(
id="my-custom-model",
name="My Custom Model",
capabilities=ModelCapabilities(
supports=ModelSupports(vision=False, reasoning_effort=False),
limits=ModelLimits(max_context_window_tokens=128000),
),
)
],
)
```
Go
```golang
package main
import (
"context"
copilot "github.com/github/copilot-sdk/go"
)
func main() {
client := copilot.NewClient(&copilot.ClientOptions{
OnListModels: func(ctx context.Context) ([]copilot.ModelInfo, error) {
return []copilot.ModelInfo{
{
ID: "my-custom-model",
Name: "My Custom Model",
Capabilities: copilot.ModelCapabilities{
Supports: copilot.ModelSupports{Vision: false, ReasoningEffort: false},
Limits: copilot.ModelLimits{MaxContextWindowTokens: copilot.Int(128000)},
},
},
}, nil
},
})
_ = client
}
```
.NET
```csharp
using GitHub.Copilot;
var client = new CopilotClient(new CopilotClientOptions
{
OnListModels = (ct) => Task.FromResult
>(new List
{
new()
{
Id = "my-custom-model",
Name = "My Custom Model",
Capabilities = new ModelCapabilities
{
Supports = new ModelSupports { Vision = false, ReasoningEffort = false },
Limits = new ModelLimits { MaxContextWindowTokens = 128000 }
}
}
})
});
```
Java
```java
import com.github.copilot.CopilotClient;
import com.github.copilot.rpc.*;
import java.util.List;
import java.util.concurrent.CompletableFuture;
var client = new CopilotClient(new CopilotClientOptions()
.setOnListModels(() -> CompletableFuture.completedFuture(List.of(
new ModelInfo()
.setId("my-custom-model")
.setName("My Custom Model")
.setCapabilities(new ModelCapabilities()
.setSupports(new ModelSupports().setVision(false).setReasoningEffort(false))
.setLimits(new ModelLimits().setMaxContextWindowTokens(128000)))
)))
);
```
Результаты кэшируются после первого вызова, как и по умолчанию. Обработчик полностью заменяет RPC CLI `models.list` — резервного перехода к серверу не происходит.
## Ограничения
### Ограничения функций
Некоторые функции Copilot могут вести себя иначе с BYOK:
* **Доступность моделей** — доступны только модели, поддерживаемые вашим провайдером
* **Rate limiting** — Подчиняется тарифным лимитам вашего провайдера, а не Copilot
* **отслеживание использования** - Использование отслеживается вашим провайдером, а не GitHub Copilot
* **Запросы на премии** - Не учитываются в квотах Copilot премиум
### Ограничения, специфичные для поставщика,
| Provider | Ограничения |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| [Microsoft Foundry Local](https://foundrylocal.ai) | Только местные; Доступность модели зависит от аппаратного обеспечения устройства; API-ключ не требуется |
| Ollama | Нет ключа API; только местные; Поддержка моделей варьируется |
| OpenAI | С учетом ограничений и квот OpenAI |
## Troubleshooting
### Ошибка «Модель не указана»
При использовании BYOK `model` следующий \*\*\*\* параметр:
```typescript
// ❌ Error: Model required with custom provider
const session = await client.createSession({
provider: { type: "openai", baseUrl: "..." },
});
// ✅ Correct: Model specified
const session = await client.createSession({
model: "gpt-4", // Required!
provider: { type: "openai", baseUrl: "..." },
});
```
### путаница типа конечной точки Azure
Для Azure конечных точек OpenAI (`*.openai.azure.com`) используйте правильный тип:
```typescript
// ❌ Wrong: Using "openai" type with native Azure endpoint
provider: {
type: "openai", // This won't work correctly
baseUrl: "https://my-resource.openai.azure.com",
}
// ✅ Correct: Using "azure" type
provider: {
type: "azure",
baseUrl: "https://my-resource.openai.azure.com",
}
```
Однако если развертывание Microsoft Foundry предоставляет путь конечной точки, совместимый с OpenAI (например, `/openai/v1/`), используйте`type: "openai"`:
```typescript
// ✅ Correct: OpenAI-compatible Microsoft Foundry endpoint
provider: {
type: "openai",
baseUrl: "https://your-resource.openai.azure.com/openai/v1/",
}
```
### Соединение отказано (Оллама)
Убедитесь, что Ollama работает и доступна:
```bash
# Check Ollama is running
curl http://localhost:11434/v1/models
# Start Ollama if not running
ollama serve
```
### Соединение отказано (Foundry Local)
Foundry Local использует динамический порт, который может меняться между перезапусками. Подтвердите активный порт:
```bash
# Check the service status and port
foundry service status
```
Обновите свой `baseUrl` порт, чтобы он совпадал с портом, показанным на выходе. Если сервис не запущен, запустите модель для его запуска:
```bash
foundry model run phi-4-mini
```
### Сбой проверки подлинности
1. Убедитесь, что ваш API ключ правильный и не просрочен
2. Проверьте `baseUrl` формат соответствия ожидаемому провайдером
3. Для токенов носителя убедитесь, что префикс полностью предоставлен (а не просто префикс).
## Дальнейшие действия
* [АВТОТИТРЫ](/ru/copilot/how-tos/copilot-sdk/auth) — Изучите обо всех методах аутентификации
* [Создайте своё первое приложение на базе Copilot](/ru/copilot/how-tos/copilot-sdk/getting-started) — Создайте своё первое приложение на базе Copilot