codai docs
Integrări

GitHub Copilot

Folosești codai în Copilot Chat din VS Code printr-un Custom Endpoint și în Copilot CLI prin BYOK.

VS Code Chat are nevoie de o intrare Custom Endpoint pentru codai; Copilot CLI are nevoie de patru variabile de mediu. Niciunul nu cere plan Copilot sau autentificare GitHub.

Înainte să începi

  • O cheie codai din hub.codai.ro → Keys → Create key (detalii în quickstart).
  • Pe Copilot Business sau Enterprise, organizația ta trebuie să activeze politica Bring Your Own Language Model Key in VS Code.

VS Code Chat (Custom Endpoint)

Calea cea mai rapidă e configurația gata făcută pe care gateway-ul o servește la https://ai.codai.ro/vscode/chatLanguageModels.json — trei intrări în picker, butonul de effort și header-e reglate. Urmezi pașii din clienți.

Ca să scrii intrarea de mână: picker-ul de modele → Manage Language Models → Add Models → Custom Endpoint, apoi editezi chatLanguageModels.json pe care îl deschide VS Code:

chatLanguageModels.json
[
  {
    "name": "codai",
    "vendor": "customendpoint",
    "apiKey": "${input:codaiApiKey}",
    "apiType": "chat-completions",
    "models": [
      {
        "id": "codai",
        "name": "codai",
        "url": "https://ai.codai.ro/v1/chat/completions",
        "toolCalling": true,
        "vision": true,
        "thinking": true,
        "maxInputTokens": 168000,
        "maxOutputTokens": 32000
      }
    ]
  }
]
  • Dai URL-ul complet al endpoint-ului, inclusiv /chat/completions.
  • toolCalling: true e obligatoriu pentru modul agent.
  • maxInputTokens + maxOutputTokens nu trebuie să depășească fereastra de context. Valorile de mai sus sunt o fereastră prudentă de 200k; configurația servită la https://ai.codai.ro/vscode/chatLanguageModels.json este sursa de adevăr și anunță ferestrele mai mari pe care le poate servi gateway-ul.
  • Pentru formatul Anthropic setezi "apiType": "messages" și "url": "https://ai.codai.ro/v1/messages".

Vechea setare github.copilot.chat.customOAIModels și provider-ul OpenAI Compatible sunt depreciate. Folosești Custom Endpoint.

MCP în VS Code

mcp.json
{
  "servers": {
    "codai": {
      "type": "http",
      "url": "https://ai.codai.ro/mcp",
      "headers": { "Authorization": "Bearer ${input:codai-key}" }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "codai-key", "description": "codai API key", "password": true }
  ]
}

Deschizi fișierul de utilizator cu MCP: Open User Configuration sau folosești .vscode/mcp.json per workspace.

Copilot CLI (BYOK)

$env:COPILOT_PROVIDER_BASE_URL   = 'https://ai.codai.ro/v1'
$env:COPILOT_PROVIDER_TYPE       = 'openai'
$env:COPILOT_PROVIDER_API_KEY    = 'codai_xxxxxxxx'
$env:COPILOT_PROVIDER_WIRE_MODEL = 'codai'
$env:COPILOT_MODEL               = 'codai'
copilot

Cu COPILOT_PROVIDER_TYPE=anthropic, base URL-ul e rădăcina https://ai.codai.ro — fără /v1. Gateway-ul servește și scripturi gata făcute; vezi clienți.

MCP în Copilot CLI

CLI-ul nu citește .vscode/mcp.json. Adaugi serverul din linia de comandă:

copilot mcp add --transport http --header "Authorization: Bearer codai_xxxxxxxx" codai https://ai.codai.ro/mcp

Ca să ții cheia în afara fișierelor de configurare, folosești bridge-ul stdio de memorie descris în clienți.

Ce merge și ce nu

FuncțieCu codai
Chat, mod agent, tool-uri (VS Code)Merg
Sesiuni Copilot CLIMerg
Sugestii inline, căutare semantică, embeddingsRămân pe GitHub
Titluri și mesaje de commitModele GitHub, dacă nu setezi chat.utilityModel / chat.byokUtilityModelDefault
Restricted ModeArată doar Auto
Memoria găzduită de GitHub și delegarea remote (CLI)Indisponibile în modul BYOK

Depanare

  • CLI-ul raportează „Authentication failed (HTTP 401)” cu tipul anthropic — base URL-ul se termină în /v1. Eroarea reală e un 404; folosești URL-ul rădăcină.
  • codai lipsește din picker — repornești VS Code; verifici că politica organizației permite chei proprii.
  • Modul agent e inactiv — toolCalling nu e true pe intrarea modelului.
  • Sesiunile Agent Host nu listează codai — activezi chat.agentHost.byokModels.enabled.

Surse

Verificate pe 2026-10-02.

Ultima actualizare:

Pe această pagină